Skip to main content

eth_getBalance RPC Method

Returns the balance of given account address in wei. The API credit value for this method is 2.

Updated on
Jul 21, 2023

eth_getBalance RPC Method

Parameters

address
string
REQUIRED
The address (20 bytes) to check for balance
blockNumber/tag
string
REQUIRED
The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized (safe and finalized tags are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova and Avalanche C-chain), see the default block parameter description in the official Ethereum documentation

Returns

result
The ETH balance of the specified address in hexadecimal value, measured in wei
Request
1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"method":"eth_getBalance","params":["0x8D97689C9818892B700e27F316cc3E41e17fBeb9", "latest"],"id":1,"jsonrpc":"2.0"}'
5
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free