ERC-20 balance of an address for one token contract
evm_balanceERC-20 balance of an address for one token contract on a chain: token name, symbol, decimals, raw and human amount, and a USD value when Coinbase has a spot price for the symbol. Only the token you name is read; the native balance is in /api/evm/address. Related tools on this server, for a different need: evm_address when you need native balance, nonce and account type of an EVM address; evm_nft when you need ERC-721 facts for one token: owner, collection name. Price: $0.002 per successful call, paid with x402 (USDC on Base, Solana and 10 more networks); failed calls are not charged.
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>",
"token": "<token>"
},
"name": "evm_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | base (default), ethereum, arbitrum, optimism or polygon | |
| token | Yes | ERC-20 contract address, 0x… | |
| address | Yes | EVM address, 0x… |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | ||
| chain | No | ||
| token | No | ||
| amount | No | ||
| holder | No | ||
| source | No | ||
| usdPrice | No | ||
| usdValue | No | ||
| checkedAt | No | ||
| disclaimer | No |