Guides

Read an account balance

Balance methods are cheap tip-of-chain reads. Token balances (ERC-20, SPL, TRC-20) need contract/program calls — covered in family guides.

eth_getBalancegetBalance

← All guides

Steps

  1. Use the address format for the family (0x… EVM, base58 Solana, etc.).
  2. Call the native balance method at latest / finalized commitment.
  3. Convert units: wei (EVM), lamports (Solana), sun (TRON).
  4. For fungible tokens, use eth_call / getTokenAccountBalance / TRC-20 trigger — not eth_getBalance.

EVM eth_getBalance (curl)

curl

curl https://holy-burned-sky-ethereum-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getBalance",
  "params": [
    "0x0000000000000000000000000000000000000000",
    "latest"
  ]
}'

EVM eth_getBalance (JavaScript)

fetch

const response = await fetch('https://holy-burned-sky-ethereum-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'eth_getBalance',
    params: [
      "0x0000000000000000000000000000000000000000",
      "latest"
    ],
  }),
});

const data = await response.json();
console.log(data);

Solana getBalance (curl)

curl

curl https://holy-burned-sky-solana-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "11111111111111111111111111111111"
  ]
}'

Solana getBalance (JavaScript)

fetch

const response = await fetch('https://holy-burned-sky-solana-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getBalance',
    params: [
      "11111111111111111111111111111111"
    ],
  }),
});

const data = await response.json();
console.log(data);

Tips

  • EVM balance is hex wei. Divide by 1e18 for ETH display.
  • Solana getBalance returns lamports (1 SOL = 1e9 lamports).
  • Watch RPS if you poll many addresses — batch where the API allows, or space requests.

Related