{"uid":"cap_YRdrAMxuCRGY64IRqoEUT","slug":"x-402-erc-20-multi-token-balance-checker-040fa6c3","name":"x-402 ERC-20 Multi-Token Balance Checker","description":"Get ETH, USDC and up to ten ERC-20 balances of one address in a single call, human-readable. ETH plus USDC plus up to ten ERC-20 balances of one address in a single call, decimals resolved, amounts human-readable. Base mainnet. Query: ?address=0x…&tokens=0x…,0x…","url":"https://api.x-402.online/v1/chain/balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BiRwR0jYN6HaqmtgJKYGj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ETH, USDC, and up to ten ERC-20 token balances for a single Base mainnet address in one call, with decimals resolved and amounts human-readable.","exampleAgentPrompt":"What are the ETH, USDC, and token balances for 0xAbC123...def on Base mainnet — also check these two token contracts: 0xTokenA... and 0xTokenB...?","exampleUseCases":[{"title":"DeFi portfolio snapshot for a wallet","prompt":"Can you pull the ETH, USDC, and all my ERC-20 balances for my wallet 0x1234...abcd on Base mainnet — include these token contracts: 0xaaa..., 0xbbb..., 0xccc...?"},{"title":"Pre-payment balance check for agent workflow","prompt":"Before I trigger this on-chain action, check whether wallet 0xDEAD...BEEF on Base has enough USDC and at least 0.01 ETH — here are the token addresses to check: 0xUSDC..., 0xWETH...."},{"title":"User wallet holdings audit","prompt":"Give me a human-readable breakdown of all token balances held by 0xUser...Wallet on Base, including ETH and these ERC-20 tokens: 0xToken1..., 0xToken2..., 0xToken3...."}],"resultDescription":"A single JSON response containing the ETH balance, USDC balance, and balances for each requested ERC-20 token address, all with decimals already resolved and expressed as human-readable decimal amounts (e.g. 1.5 ETH, 200.00 USDC).","failureModes":["Invalid or malformed address returns an error response","Token contract address is not a valid ERC-20 — balance may be 0 or errored","More than ten ERC-20 addresses supplied — excess tokens may be ignored or rejected","Network issues reaching Base mainnet RPC — timeout or 5xx error","Payment of 0.005 USDC not fulfilled — 402 Payment Required response blocking the call"],"whenToPreferThis":"Choose this endpoint when you need ETH plus multiple ERC-20 token balances for a single Base mainnet address in one round trip, with decimals already resolved to human-readable values — eliminating the need to call raw RPC, manage ABI decoding, or make separate balance calls per token. Ideal for AI agents that need a quick portfolio snapshot or pre-flight balance check without setting up a blockchain node or SDK.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:42:41.975Z","isFirstParty":false,"canonicalSlug":"x-402-erc-20-multi-token-balance-checker-040fa6c3"}