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"
}