getBalance

POSTAccountsAll plans

Returns the lamport balance of an account.

Try itSends a real request from your browser to the selected region.
POST
/

getBalance returns only the lamport balance of an address, with no owner or data fields.

getAccountInfo returns the owner or data as well, in a single request.

Plans & rate limitsAll plans
Free5/s
Operator50/s
Blade Runner200/s
Nexus500/s

Parameters

params is a JSON array, with values in this order: address, config.

1addressstringrequired

Address of the account to check, base-58 encoded.

2configobject

Optional configuration.

Show propertiesProperties
commitmentstringdefault: "finalized"

Bank state to read the balance from.

Allowed values:finalizedconfirmedprocessed
minContextSlotinteger

Minimum slot the node must have processed before answering.

Result

resultobject

The balance in lamports, wrapped with context.

Show propertiesProperties
contextobjectrequired
Show propertiesProperties
slotinteger
apiVersionstring
valueintegerrequired

Balance, in lamports. A non-existent account reads back as 0, the same as an account that exists with zero lamports.

Notes

  • 1 SOL equals 1,000,000,000 lamports; value divided by 1e9 gives SOL.
  • A value of 0 does not distinguish an unfunded account from one that exists with a zero balance; getAccountInfo distinguishes the two.