Skip to content

Solana method

getBalance

Returns an account's balance in lamports.

cheapCheap for a provider to serve — no state is read, or one key is.Primary specification (opens in a new tab)

How each provider handles it

This method has not been measured in this window.

It is scheduled but no observation has landed yet.

What it does

A lamport is 10^-9 SOL. The call is a single account lookup, so it is one of the cheapest state reads Solana offers.

The response carries the standard context envelope, so the balance is under `result.value` rather than `result` directly.

Parameters

pubkeystringrequired
Account address, base-58 encoded.
configObjectoptional
commitment and minContextSlot.

Returns

u64 under result.value — the balance in lamports.

Try it

Runnable as written, against a keyless public endpoint. Nothing here needs an API key.

Request

curl -s https://api.mainnet-beta.solana.com \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"getBalance","params":["Vote111111111111111111111111111111111111111"]}'

As JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": ["Vote111111111111111111111111111111111111111"]
}

Response

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

Things that bite

  • Lamports, not SOL. Divide by 10^9.
  • An account that has never existed returns 0 rather than an error, so zero balance and no such account are indistinguishable here.

Why it is measured

The cheapest Solana state read, which isolates account-lookup cost from the network path measured by getVersion.

Called every 120 seconds per endpoint, with jitter so the fleet does not hit a provider in lockstep.

7d window · generated 2026-08-24 17:25:44 UTC · 0 providers