Docs

eth_getBalance - Base RPC Method

Query account balance on Base. Essential for wallet applications and consumer dApps, SocialFi, NFT marketplaces, and merchant payment integrations on Coinbase's L2 with 54% of L2 market revenue and direct access to 110M+ Coinbase users.

Returns the balance of a given address on Base.

Why Base? Build on Coinbase's L2 with 54% of L2 market revenue and direct access to 110M+ Coinbase users with $8B+ TVL, $0.08 gas fees, built-in Coinbase distribution, and seamless fiat rails.

Use Cases

The eth_getBalance method is essential for:

  • Wallet applications - Display user balances
  • Transaction validation - Check if account has sufficient funds
  • DeFi applications - Monitor collateral and liquidity for consumer dApps, SocialFi, NFT marketplaces, and merchant payment integrations
  • Account monitoring - Track balance changes over time

Code Examples

Bash
curl -X POST https://api-base-mainnet-archive.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": [
      "0x4200000000000000000000000000000000000006",
      "latest"
    ],
    "id": 1
  }'

Error Handling

Error CodeMessageDescription
-32602Invalid paramsInvalid address format or block parameter
-32000Execution errorNode execution error