eth_getBalance

Get the balance of an account at a given block

Defined in the Ethereum JSON-RPC Specification

Returns the balance of the account of given address.

Parameters

address · string · required

The address to check for balance (20 bytes).

blockParameter · string · required

Integer block number, or the string “latest”, “earliest” or “pending”.

Returns

result · string

A hexadecimal string representing the current balance in wei.

Request

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]
}

Success Response

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

Error Handling

Code	Message	Description
-32602	Invalid address or block parameter	The provided address or block parameter is invalid
4100	Requested method not supported	The method is not supported by the wallet

The result represents the balance in wei. To convert to ETH, divide by 10^18.