eth_getBalance RPC Method

The eth_getBalance method fetches the current native balance (in wei) of any wallet address on Base.
It returns the balance of ETH on Base, not ERC-20 tokens.

⚠️

eth_getBalance only returns the native token balance (ETH on Base).
It does not return balances of ERC-20 or other tokens.

Need RPC API keys?

Get 12.5M archival requests for free today.

GET STARTED FOR FREE

🔧 Parameters

`address` (required)

The 20-byte wallet address you want to query.

`blockNumber or tag` (required)

Use a hex block number or one of the tags:
"latest", "earliest", "pending".

📥 Returns

balance — Wallet balance in wei, returned as a hex string.
Example: "0x19451085df7bc276d" = 181102330274593643789 in wei

📤 Request

POST https://base-mainnet.chainnodes.org/YOUR-API-KEY

✅ Replace YOUR-API-KEY with your key from the CHAINNODES Dashboard (opens in a new tab).
✅ You may replace base-mainnet with another supported network if needed.

💡 Confusing?

Ask our experienced blockchain developers in Telegram

ASK FOR FREE

🧪 Example

curl https://base-mainnet.chainnodes.org/YOUR-API-KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "method":"eth_getBalance",
    "params": ["0x95222290DD7278Aa3Ddd389Cc1E1d165CC4BAfe5", "latest"],
    "id":1
  }'

📦 Response

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

🛠️ Use Cases

Check if a wallet has enough ETH on Base to cover gas fees
Display a user's current ETH balance in wallets and dApps
Monitor ETH balance changes for accounts and contracts
Validate fund availability before sending a transaction

eth_gasPrice eth_getBlockTransactionCountByHash