{"uid":"cap_bQ9hxfg59lUqlAAolxmyv","slug":"x402-wallet-balance-lookup-b193239e","name":"x402 Wallet Balance Lookup","description":"Native and (optional) ERC-20 token balance for a wallet address across major EVM chains (base, ethereum, polygon, arbitrum, optimism)","url":"https://x402tap.com/api/wallet-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","required":["address"],"properties":{"chain":{"type":"string","description":"Chain to query: base, ethereum, polygon, arbitrum, optimism (default base)"},"token":{"type":"string","description":"Optional ERC-20 token contract address to also check"},"address":{"type":"string","description":"EVM wallet address (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"Base","token":{"symbol":"USDC","address":"0x8335...","balance":"500.0","decimals":6},"native":{"symbol":"ETH","balance":"1.24031"},"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K5UdascvVe0BJNH_Ygcq1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns native token (ETH/MATIC/etc.) and optional ERC-20 token balances for a wallet address on major EVM chains","exampleAgentPrompt":"What's the ETH balance and USDC token balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Can you check how much ETH and USDC (token address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) are in my wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base?"},{"title":"Pre-transaction liquidity verification","prompt":"Before I send a transaction, check if wallet 0xAbCd1234567890abcdef1234567890abcdef1234 has at least some ETH available on Arbitrum — what's its native balance?"},{"title":"Monitor token holdings on Polygon","prompt":"Look up the MATIC balance and the USDT token balance at contract 0xc2132D05D31c914a87C6611C10748AEb04B58e8F for wallet 0x1234abcd5678efgh90ijklmnopqrstuvwxyz1234 on Polygon."}],"resultDescription":"A JSON object containing the wallet address, the chain name, the native token symbol and balance (e.g. ETH: 1.24), and — if an ERC-20 contract was specified — the token symbol, contract address, decimal precision, and formatted token balance (e.g. USDC: 500.0).","failureModes":["Invalid or malformed wallet address returns an error response","Unsupported chain name causes a 400 or error response","Invalid ERC-20 token contract address returns null or error for the token field","Network/RPC issues for a specific chain may cause timeouts","Payment failure (402) if USDC balance is insufficient for the $0.002 call fee"],"whenToPreferThis":"Choose this endpoint when you need on-chain wallet balance data across Base, Ethereum, Polygon, Arbitrum, or Optimism in a single call, especially when you also want ERC-20 token balances alongside native balances. It's ideal for agents that need to verify wallet liquidity, check holdings before executing transactions, or enrich user portfolio views. The x402 micropayment model makes it cost-effective for high-frequency per-address lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:31:03.119Z","isFirstParty":false,"canonicalSlug":"x402-wallet-balance-lookup-b193239e"}