Parameters

pubkey
string
required

Public key of the account to query (base-58 encoded string)

config
object

Configuration object containing the following optional fields:

Response

result
object

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

  1. Balance is returned in lamports (1 SOL = 1,000,000,000 lamports)
  2. For new accounts, balance will be 0
  3. The balance includes all SOL tokens, including those delegated for staking
  4. The response is immediate as it reads from the current state

Best Practices

  1. Use appropriate commitment level based on your needs:
    • processed for UI updates
    • confirmed for most operations
    • finalized for critical operations
  2. Convert lamports to SOL by dividing by 1e9 when displaying to users
  3. Consider using getAccountInfo if you need more account details

Common Errors

CodeMessageSolution
-32602Invalid param: WrongSizeVerify the public key is valid
-32602Invalid param: not base58 encoded stringEnsure the public key is base58 encoded
-32007Account not foundThe account doesn’t exist (balance will be 0)