Account & Program
getBalance
Returns the balance of the account of provided public key
Parameters
Public key of the account to query (base-58 encoded string)
Configuration object containing the following optional fields:
Response
Code Examples
Basic Request
Request with Commitment
Using web3.js
Notes
- Balance is returned in lamports (1 SOL = 1,000,000,000 lamports)
- For new accounts, balance will be 0
- The balance includes all SOL tokens, including those delegated for staking
- The response is immediate as it reads from the current state
Best Practices
- Use appropriate commitment level based on your needs:
processed
for UI updatesconfirmed
for most operationsfinalized
for critical operations
- Convert lamports to SOL by dividing by 1e9 when displaying to users
- Consider using
getAccountInfo
if you need more account details
Common Errors
Code | Message | Solution |
---|---|---|
-32602 | Invalid param: WrongSize | Verify the public key is valid |
-32602 | Invalid param: not base58 encoded string | Ensure the public key is base58 encoded |
-32007 | Account not found | The account doesn’t exist (balance will be 0) |