get Balance
POSTAccountsAll plans
Returns the lamport balance of an account.
Try itSends a real request from your browser to the selected region.
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:
finalizedconfirmedprocessedminContextSlotinteger
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;
valuedivided by 1e9 gives SOL. - A
valueof 0 does not distinguish an unfunded account from one that exists with a zero balance;getAccountInfodistinguishes the two.