eth_getBalance on Ethereum
Returns the native-token balance (in wei) of an address at a given block. The standard way to read a wallet's balance.
This returns the native coin only — for ERC-20 balances use eth_call against the token's balanceOf. Pass an explicit block number for point-in-time reads; latest moves every block.
Ethereum endpoint (public — no key)
https://rpc.nodeflare.app/eth/publicMethod
eth_getBalance
Cost
2 CU
Chain ID
1
Block time
~12 s
Finality
~13 min (finalized)
Accounts & state on Ethereum
Ethereum state is the largest of any EVM chain. Reads default to the latest block; pass an explicit block tag for point-in-time reads, and expect deep-historical state queries to be slower than near-head ones.
Parameters
[address, blockNumber|tag]cURL
curl https://rpc.nodeflare.app/eth/public \
-X POST \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "latest"],"id":1}'The example targets the USDC contract on Ethereum — you can run it as-is.
ethers.js
import { ethers } from 'ethers';
const provider = new ethers.JsonRpcProvider(
'https://rpc.nodeflare.app/eth/public'
);
const result = await provider.send('eth_getBalance', ["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "latest"]);Try it live
Runs the example above against the public Ethereum endpoint — straight from your browser.
eth_getBalance on Ethereum — FAQ
How do I call eth_getBalance on Ethereum?
POST a JSON-RPC 2.0 request with "method": "eth_getBalance" to NodeFlare's Ethereum endpoint at https://rpc.nodeflare.app/eth/public. No API key is required for the public endpoint.
What does eth_getBalance cost on the free tier?
eth_getBalance is weighted at 2 compute units per call. The free tier includes 2,000,000 CU/month, so that is roughly 1,000,000 eth_getBalance calls per month — no credit card.
Is eth_getBalance available on the public Ethereum endpoint?
Yes. eth_getBalance works on the public Ethereum endpoint (https://rpc.nodeflare.app/eth/public) with no API key, rate-limited per IP. A free key adds higher limits and a dedicated path.
Anything Ethereum-specific to know when using eth_getBalance?
Ethereum state is the largest of any EVM chain. Reads default to the latest block; pass an explicit block tag for point-in-time reads, and expect deep-historical state queries to be slower than near-head ones.
Call eth_getBalance on Ethereum with a free key
2,000,000 compute units/month, heavy methods unlocked, every chain included. No credit card.
Get your free API key →