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