Docs · method · EVM

`eth_getBalance`

Facts for eth_getBalance
Units per call	1 (standard)
Cache	never (state-relative)
Rule	1 unit at the head, at a tag (latest, safe, finalized, pending) or within 128 blocks of the head; an explicit block more than 128 blocks back counts 2 units (archive class).
Chains	Ethereum Mainnet · Base Mainnet · Arbitrum One · OP Mainnet · Polygon PoS
Specification	https://ethereum.github.io/execution-apis/api-documentation/

Example

curl -s https://flexyield.io/rpc/eth_mainnet \
  -H "Authorization: Bearer $FLEXYIELD_KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","latest"]}'

Questions

When does eth_getBalance count as archive?

When the block parameter is an explicit number more than 128 blocks behind the head — then it counts 2 units.

All methods: methods and limits · docs · AI agents: the same call is the rpc_call MCP tool.