Parameters
Public key of the account to query (base-58 encoded string)
Configuration object containing the following optional fields:
The level of commitment to use:
processed: Latest block (unconfirmed)confirmed: Confirmed by supermajorityfinalized: Finalized by supermajority
The minimum slot that the request can be evaluated at
Response
The slot the request was processed at
Number of lamports assigned to this account
Code Examples
Basic Request
curl https://rpc.orbitflare.com -X POST -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getBalance",
"params": [
"83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"
]
}'
Request with Commitment
curl https://rpc.orbitflare.com -X POST -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getBalance",
"params": [
"83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri",
{
"commitment": "finalized"
}
]
}'
Using web3.js
import { Connection, PublicKey } from '@solana/web3.js';
const connection = new Connection('https://rpc.orbitflare.com');
const publicKey = new PublicKey('83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri');
const balance = await connection.getBalance(
publicKey,
'confirmed'
);
console.log(`Balance: ${balance / 1e9} SOL`);
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) |
