Skip to main content
POST
/
tools
/
web3
/
evm
/
eth-get-balance
Get Balance
curl --request POST \
  --url https://api.dirtroad.dev/tools/web3/evm/eth-get-balance \
  --header 'Content-Type: application/json' \
  --header 'X-Payment: <api-key>' \
  --data '{
  "chain": "<string>",
  "address": "<string>",
  "blockTag": "latest"
}'
{
  "chain": "<string>",
  "address": "<string>",
  "blockTag": "<string>",
  "balance": "<string>"
}

Authorizations

X-Payment
string
header
required

x402 blockchain payment authorization header containing signed EIP-3009 Transfer with Authorization

Body

application/json
chain
string
required

CAIP-12 chain identifier or slug

address
string
required

Address to get balance for

blockTag
enum<string>
default:latest

Block tag

Available options:
latest,
pending,
earliest,
safe,
finalized

Response

Balance retrieved successfully

chain
string
required

CAIP-12 chain identifier

address
string
required

Address queried

blockTag
string
required

Block tag used

balance
string
required

Balance in wei as hex string