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

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.

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

Error Handling

CodeMessageDescription
-32602Invalid address or block parameterThe provided address or block parameter is invalid
4100Requested method not supportedThe method is not supported by the wallet

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