Base wallet balance: ETH, USDC and any ERC-20 tokens, transaction count, wallet or contract
chain_balanceBase mainnet balance for one address: ETH and USDC (human-readable and raw), plus up to 10 ERC-20 tokens you list (with symbol and decimals), transaction count, and whether it is a wallet or a contract. One price for 0 to 10 tokens. Useful for checking a wallet is funded before a payment, confirming a payout or airdrop landed, tracking agent or treasury wallets, or screening a counterparty. Read-only. Not charged for invalid addresses or when Base can't be reached. Paid via x402; see list_prices.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"address": "<address>"
},
"name": "chain_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tokens | No | Optional: up to 10 ERC-20 token contract addresses on Base to also return balances for (an array, or one comma-separated string). ETH and USDC are always included. | |
| address | Yes | 0x address on Base (40 hex characters). |