eth_getBalance

Return the balance for one address at the chosen block tag.

Available under EVM REST API. Use the chain-family pages for route switching and the method pages for exact request and response shapes.

Access patterns

Pattern	Value	Notes
Bearer header (Recommended)	`POST /rpc/{evm_chain}`	Recommended default. Keep the API key in `Authorization: Bearer <api_key>`. Current baseline routes: `/rpc/ethereum`, `/rpc/bnbchain`, `/rpc/base`, `/rpc/arbitrum`, `/rpc/optimism`, `/rpc/polygon`. Examples use `/rpc/ethereum`.
URL compatibility	`POST /v1/{evm_chain}/<api_key>`	Use only when the client can store one full RPC URL but cannot send custom headers. Replace `{evm_chain}` with one of `/rpc/ethereum`, `/rpc/bnbchain`, `/rpc/base`, `/rpc/arbitrum`, `/rpc/optimism`, `/rpc/polygon`.

Examples

Bearer auth example


curl -X POST "https://gw-aql.tomo.services/rpc/ethereum" \  -H "Authorization: Bearer <api_key>" \  -H "Content-Type: application/json" \  -d '{  "jsonrpc": "2.0",  "id": 1,  "method": "eth_getBalance",  "params": [  "0x0000000000000000000000000000000000000000",  "latest"]}'

URL auth compatibility example


curl -X POST "https://gw-aql.tomo.services/v1/ethereum/<api_key>" \  -H "Content-Type: application/json" \  -d '{  "jsonrpc": "2.0",  "id": 1,  "method": "eth_getBalance",  "params": [  "0x0000000000000000000000000000000000000000",  "latest"]}'

Use the URL-carried API key form only for clients that cannot add `Authorization: Bearer <api_key>`. Keys in URLs are easier to leak through logs, browser history, and screenshots.

Response example


{  "jsonrpc": "2.0",  "id": 1,  "result": "0x0"}

Try send

Try eth_getBalance

Send one direct browser request to the current hosted gateway base URL so the real network request is visible in devtools. The API key is only stored locally when you provide one.

API key (optional)Request pathPOSTJSON body

Request fields

JSON-RPC request body

Field	Type	Required	Notes
`jsonrpc`	`string`	Required	JSON-RPC version. Use `2.0`.
`id`	`string \| number`	Required	Caller request id.
`method`	`string`	Required	Allowlisted chain method.
`params`	`array`	Required	Method arguments.

Response fields

JSON-RPC response body

Field	Type	Notes
`jsonrpc`	`string`	JSON-RPC version.
`id`	`string \| number`	Echoed request id.
`result`	`unknown`	Successful method result.
`error`	`object`	Standard JSON-RPC error object when the request fails.

Return to the chain-family landing page.

EVM overview

Open the REST API tree for this chain family.

EVM REST API

Return to the task-oriented raw RPC guide.

Call RPC

Keep a direct link to this exact method page.

Canonical method path