eth_getBalanceHTTP

Returns the selected account's native-currency balance in its smallest unit. The six published networks use 18 decimals: divide by 10^18 for ETH, BNB or POL as appropriate.

Chain EthereumTransport HTTPTry-it live

How to use

Pick an API key (or paste one) in the Try it panel.
Fill each parameter (order = params array index).
Send request — live against the gateway; counts toward daily quota.

Parameters

JSON-RPC positional arguments — order matches the array sent in params. Index badges below match array positions.

addressDATA(20B)required

Address to query.

blockQUANTITY|TAGoptional

Hex block number or tag; omitted means latest on clients following the current execution API. Send latest explicitly for compatibility. State is evaluated after that block. Historical state must remain available. Tags and finality guarantees vary by network. In Advanced JSON mode, clients supporting EIP-1898 also accept {"blockHash":"0x...","requireCanonical":true} or {"blockNumber":"0x..."}; do not combine both keys, and use requireCanonical only with blockHash.

params array (shape)

eth_getBalance · paramsjson

1[
2  "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
3  "latest"
4]

Try it

Live request via the gateway — counts toward your account's daily quota. Chain: ethereum

JSON mode

API key

Try-it runs with one of your own keys — sign in or create a free account first.

Parameters

0addressDATA(20B)required

Address to query.

1blockQUANTITY|TAGoptional

Example request

eth_getBalance · requestbash

1curl 'https://ethras.org/v1/ethereum/<YOUR_KEY>' \
2  -H 'Content-Type: application/json' \
3  -d '{
4    "id": 1,
5    "jsonrpc": "2.0",
6    "method": "eth_getBalance",
7    "params": [
8      "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
9      "latest"
10    ]
11  }'

Example response

Illustrative example: long hex values and object fields may be shortened for readability. Available fields depend on the network, client, protocol upgrade and transaction type.

eth_getBalance · responsejson

1{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "result": "0x117f2f7b291ed7e6c8"
5}

Response fields

The result row describes the complete result; other rows describe its object fields or array elements. Indented rows describe nested members. For subscriptions,params.* rows describe later notifications rather than the initial reply.

Field	Type	Description
`result`	`QUANTITY`	Balance in wei.