eth_getBalance

eth_getBalance returns the native AVAX balance of an Avalanche C-Chain account at the block you specify. The value is the account's spendable gas token — what it can use to pay fees on the C-Chain — and not any ERC-20 holding. Send the address and a block tag to https://avalanche.therpc.io/YOUR_API_KEY (chain ID 43114) and the node replies with a hex-encoded wei amount; divide by 10^18 to express it in whole AVAX.

Use cases

• Display an account's AVAX balance in a wallet or portfolio UI.
• Verify an account holds enough AVAX to cover gas before estimating or submitting a C-Chain transaction.
• Poll balance changes to detect incoming AVAX payments or settlements.
• Audit a balance at a specific historical block (on an archive node) for accounting or forensics, cross-checked against Snowtrace.

Parameters

Response

Example request

1curl https://avalanche.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_getBalance",
7    "params": [
8        "0x0000000000000000000000000000000000000000",
9        "latest"
10      ],
11    "id": 1
12  }'

Try it live in the Avalanche playground.

Errors & troubleshooting

Common pitfalls

• Never run Number() on the raw hex value — an AVAX balance above 2^53 wei loses precision; always use BigInt(value).
• Snowman gives the C-Chain fast finality, but "latest" still reflects the freshest tip; for systems of record query the "finalized" tag instead.
• This returns only the native AVAX balance — ERC-20 holdings such as USDC or WAVAX require an eth_call to the token contract's balanceOf.

Supported networks

• Mainnet — Chain ID: 43114
• Fuji

See also

• eth_getTransactionCount
• eth_call
• eth_getProof

1curl https://avalanche.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0x0000000000000000000000000000000000000000","latest"]}'