eth_getBalance

Returns the balance of the account of a given address.

Parameters

• address: [Required] A string representing the address (20 bytes) to check for balance.
• block parameter: [Required] A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized. See the default block parameter.

Returns

A hexadecimal of the current balance in the account at the given address. The balance is in wei.

Example

Replace <YOUR-API-KEY> with an API key from your Infura dashboard.

Request

curl

curl https://mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0","method": "eth_getBalance", "params": ["0xc94770007dda54cF92009BFF0dE90c06F603a09f", "latest"], "id": 1}'

WSS

wscat -c wss://mainnet.infura.io/ws/v3/<YOUR-API-KEY> -x '{"jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0xc94770007dda54cF92009BFF0dE90c06F603a09f", "latest"], "id": 1}'

Response

JSON

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