{"uid":"cap_bbpN8VNCMFpLs4zTQzCly","slug":"wafermap-xyz-wallet-balances-604394eb","name":"wafermap.xyz Wallet Balances","description":"Wallet Balances — ETH and stablecoin balances for any address, plus any tokens you list.","url":"https://wafermap.xyz/v1/wallet-balances?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tokens":{"type":"string","minLength":1,"description":"Extra token addresses, comma-separated (up to 10)."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address (0x…)."},"network":{"enum":["robinhood","base"],"type":"string","description":"robinhood (default) or base."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8cnpAF9-PB18RoQrQux-y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ETH and stablecoin balances for any wallet address on Robinhood Chain or Base, plus balances for additional specified token contracts.","exampleAgentPrompt":"What's the ETH balance and any USDC or USDT holdings for wallet 0xAbC1234567890AbcD1234567890aBcD12345678 on Base?","exampleUseCases":[{"title":"DeFi portfolio snapshot","prompt":"Pull up the ETH and stablecoin balances for wallet 0x1234567890abcdef1234567890abcdef12345678 on Base — also include the WBTC and LINK token balances."},{"title":"Pre-transaction balance check","prompt":"Before I send that payment, check if wallet 0xDeAdBeEf1234567890DeAdBeEf1234567890DeAd has enough ETH and USDC on Robinhood Chain to cover it."},{"title":"Onboarding wallet audit","prompt":"A user just connected wallet 0xAaBbCcDdEeFf001122334455667788990011AaBb on Base — can you show me their ETH balance plus any stablecoins they're holding?"}],"resultDescription":"Returns the ETH balance and stablecoin balances (e.g. USDC, USDT) held by the specified wallet address on the chosen network, along with balances for any additional token contract addresses provided. Balances are returned per token with amounts readable for downstream logic or display.","failureModes":["Invalid wallet address format (not matching 0x + 40 hex chars) returns a validation error","Unsupported network value outside 'robinhood' or 'base' enum returns an error","Token address list exceeds 10 entries may be rejected or truncated","Undeployed or non-ERC20 token contract addresses may return zero or error","Network RPC downtime may cause timeouts or empty responses","Payment failure (x402) if USDC balance is insufficient to cover the $0.00138 fee"],"whenToPreferThis":"Use this endpoint when you need a fast, on-demand lookup of ETH, stablecoin, and arbitrary ERC-20 token balances for a specific wallet address on Robinhood Chain or Base. It is particularly well-suited for agentic workflows that need to check wallet liquidity before executing transactions, audit user portfolios, or display holdings in real time. Prefer it over general blockchain explorers when you need a structured, programmatic response for multiple tokens in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:17.979Z","isFirstParty":false,"canonicalSlug":"wafermap-xyz-wallet-balances-604394eb"}