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, or finalized. See the default block parameter.

    warning

    safe isn't supported. Use finalized instead.

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 MetaMask Developer dashboard.

Request​

curl https://unichain-sepolia.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"
}