Skip to main content

Services documentation

Use high performance APIs provided by Infura to scale your dapp or Snap.

getBalance

Returns the balance of the specified address in lamports. This method uses 160 credits from your daily balance.

Parameters

  • address: (string) [required] - The base-58 encoded public key of the account to query.
  • config: (object) [optional] - Configuration object with the following options:
    • commitment: (string) [optional] - The commitment level to use for the query. The default is finalized. Possible values are:
      • finalized - Queries the most recent block confirmed by a super majority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
      • confirmed - Queries the most recent block that has been voted on by a super majority of the cluster.
      • processed - Queries its most recent block. The block may still be skipped by the cluster.
    • minContextSlot: (integer) [optional] - The minimum slot to use for the query.

Returns

result - null when the account doesn't exist, or an object with the following fields:

  • context - An object containing the following keys:
    • slot - The slot number of the block that was queried.
    • apiVersion - The API version used for the query.
  • value - The balance of the account in lamports.

Example

Replace <YOUR-API-KEY> with your API key.

Request

curl https://solana-mainnet.infura.io/v3/<YOUR-API-KEY> \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "getBalance", "params": ["83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"]}'

Response

{
"jsonrpc": "2.0",
"result": {
"context": { "slot": 1 },
"value": 0
},
"id": 1
}