eth_getBalance

Returns the balance of the account of given address.

REQUEST

POST https://<network>.chainrpc.io/v3/YOUR-API-KEY

HEADERS

Content-Type: application/json

REQUEST PARAMS

  • ADDRESS [required] - a string representing the address (20 bytes) to check for balance

  • BLOCK PARAMETER [required] - a hexadecimal block number, or the string "latest", "earliest" or "pending".

EXAMPLE

## JSON-RPC over HTTPS POST
## Replace YOUR-API-KEY with an API key from your chainRPC Dashboard
## You can also replace mainnet with a different supported network
curl https://eth.chainrpc.io/v3/YOUR-API-KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_getBalance","params": ["0xc94770007dda54cF92009BFF0dE90c06F603a09f", "latest"],"id":1}'

## JSON-RPC over WSS
## Replace YOUR-API-KEY with an API key from your Infura Dashboard
## You can also replace mainnet with a different supported network
wscat -c wss://eth.chainrpc.io/v3/YOUR-API-KEY
>{"jsonrpc":"2.0","method":"eth_getBalance","params": ["0xc94770007dda54cF92009BFF0dE90c06F603a09f", "latest"],"id":1}

RESPONSE

RESULT FIELDS

  • BALANCE - hexadecimal of the current balance in wei.

BODY

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

Last updated