the402 endpoint detail

← All endpoints

agent402.tools api token-balances

https://agent402.tools/api/token-balances

answers 402

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.

We sent a real POST request to this endpoint and it answered 402 with payment requirements we could parse.
Price
$0.002
Network
base
Pay to
0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0
Spec dialect
v2 (declares x402Version 2)
Transport
PAYMENT-REQUIRED header
HTTP method
POST
Response latency
125 ms
Payment options
13 usable of 13
Last checked
2026-09-06T01:16:43.423Z (2h ago)
Category
finance-crypto

Re-check it yourself:
curl "https://api.the402.dev/validate?url=https%3A%2F%2Fagent402.tools%2Fapi%2Ftoken-balances"