Token balances (named contracts)
POST https://agent402.tools/api/token-balances
ERC-20 balances of one wallet for a NAMED list of token contracts (1-20) - the targeted complement to the full-portfolio wallet-balance tool. One balance read for the whole list plus symbol/decimals per contract (cached an hour server-side), so 'how much USDC and WETH does this wallet hold on Base?' is a single cheap call with exact decimal strings, not a portfolio dump.
Warnings
Wallet mismatch The payout wallet in its live payment answer differs from its catalogue listing on the same network.
How to buy
This endpoint takes pay-per-call payments over x402. Call it once without paying to see its live price; any x402 client then pays and retries automatically.
curl -i -X POST "https://agent402.tools/api/token-balances"
# HTTP/1.1 402 Payment Required: price, asset and payTo are in the responseRecent checks
| Checked (UTC) | Result | Status | Time | Live price |
|---|---|---|---|---|
| 2026-10-11 10:16 | Valid 402 | 402 | 113 ms | $0.002 |
| 2026-10-11 05:46 | Valid 402 | 402 | 98 ms | $0.002 |
| 2026-10-11 01:15 | Valid 402 | 402 | 125 ms | $0.002 |
| 2026-10-10 20:45 | Valid 402 | 402 | 61 ms | $0.002 |
Receipts
No test purchases yet. Graded test purchases are next on our list; until then every number here comes from unpaid checks.
What a check proves