Skip to main content

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

Response​

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