{"uid":"cap_j_qiA5uEA3CjNFhp3Fuz7","slug":"p0-agent-economy-index-wallet-balance-lookup-b270c10a","name":"P0 Agent Economy Index — Wallet Balance Lookup","description":"An open index of the machine-to-machine (agent) economy. x402 routes: ranked discovery over the live x402 service market, every indexed service scored by real 30-day calls and paying-wallet bounds, with a receipt naming the snapshot hash and scoring revision. /economy routes, for Tempo MPP, Virtuals ACP, Olas, Masumi, ERC-8004 agent registries, Solana agent registries, Base agent contracts and MCP servers (Official MCP Registry): each protocol's published figures (agent or server counts, transactions or payment events; payers and USD volume only where the source publishes them: payers for x402 and Tempo MPP, USD volume for x402 and Virtuals ACP), each with its unit, window and source; units differ, so totals are not summed. L402 and per-service MPP listings are not covered.","url":"https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/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","HEAD"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chains":{"type":"string","description":"comma list of ethereum, base, arbitrum, polygon (default: all EVM chains for a 0x address)"},"address":{"type":"string","description":"0x address or ENS name (lowercase a-z, 0-9, hyphen)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","kind","asOf","chains","errors","note"],"properties":{"ens":{"type":["object","null"],"properties":{"name":{"type":"string"},"resolver":{"type":"string"}}},"asOf":{"type":"string"},"kind":{"type":"string"},"note":{"type":"string"},"input":{"type":"string"},"chains":{"type":"array","items":{"type":"object","required":["chain","native","tokens"],"properties":{"block":{"type":["integer","null"]},"chain":{"type":"string"},"native":{"type":"object","required":["symbol","decimals","raw","amount"],"properties":{"raw":{"type":"string"},"amount":{"type":"string"},"symbol":{"type":"string"},"contract":{"type":"string"},"decimals":{"type":"integer"}}},"source":{"type":"string"},"tokens":{"type":"array","items":{"type":"object","required":["symbol","decimals","raw","amount"],"properties":{"raw":{"type":"string"},"amount":{"type":"string"},"symbol":{"type":"string"},"contract":{"type":"string"},"decimals":{"type":"integer"}}}},"chainId":{"type":["integer","null"]},"explorer":{"type":"string"},"activated":{"type":"boolean"},"tokenErrors":{"type":"array","items":{"type":"string"}}}}},"errors":{"type":"array","items":{"type":"object","required":["chain","error"],"properties":{"chain":{"type":"string"},"error":{"type":"string"}}}},"address":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ens":{"name":"vitalik.eth","resolver":"0x231b0ee14048e9dccd1d247744d114a4eb5e8e63"},"asOf":"2026-10-05T12:00:00.000Z","kind":"ens","note":"Balances read directly from public blockchain nodes at the block shown for each chain. No USD prices. A chain that did not answer is listed in errors, never reported as zero.","input":"vitalik.eth","chains":[{"block":52207539,"chain":"base","native":{"raw":"120000000000000000","amount":"0.12","symbol":"ETH","decimals":18},"source":"base.drpc.org","tokens":[{"raw":"25000000","amount":"25","symbol":"USDC","contract":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","decimals":6}],"chainId":8453,"explorer":"https://basescan.org/address/0xd8da6bf26964af9d7eed9e03e53415d37aa96045","tokenErrors":[]}],"errors":[{"chain":"polygon","error":"timeout"}],"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}},"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_Tst-vPRwW9NWX7AWUqbML","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":"Fetches native token and ERC-20 token balances for a given Ethereum address or ENS name across multiple EVM chains in real time.","exampleAgentPrompt":"What are the ETH and USDC balances for vitalik.eth across Base, Ethereum, and Arbitrum right now?","exampleUseCases":[{"title":"Multi-chain portfolio snapshot for a wallet","prompt":"Can you look up the current ETH and token balances for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum, Base, and Polygon?"},{"title":"ENS name balance resolution","prompt":"Resolve vitalik.eth and tell me how much ETH and USDC it holds across all EVM chains."},{"title":"Pre-payment wallet sufficiency check","prompt":"Before I send a transaction, check whether 0xAbCd1234...5678 has at least 25 USDC on Base."}],"resultDescription":"Returns a JSON object with the resolved wallet address, ENS name details (if applicable), per-chain breakdowns including native token (symbol, raw amount, human-readable amount, decimals) and ERC-20 token balances (symbol, contract, raw and formatted amounts), the block number used for each chain, the data source node, and any chains that returned errors instead of balances. No USD prices are included.","failureModes":["Invalid or non-existent Ethereum address returns an error","ENS name that cannot be resolved returns an error","Specified chain times out and appears in the errors array rather than balances","Unknown chain name in the chains query parameter causes a validation error","Rate limiting or upstream node unavailability may cause partial chain failures","Malformed address format (e.g. mixed case, missing 0x prefix) may fail validation"],"whenToPreferThis":"Use this endpoint when you need real-time, multi-chain EVM wallet balances (native + ERC-20) for a specific address or ENS name without requiring USD price conversion. It is distinct from price oracles or DEX APIs — it reads directly from public blockchain nodes at the latest block, making it ideal for checking whether an agent wallet has sufficient funds before executing a payment, or for auditing a wallet's on-chain holdings across Base, Ethereum, Arbitrum, and Polygon in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:44:56.507Z","isFirstParty":false,"canonicalSlug":"p0-agent-economy-index-wallet-balance-lookup-b270c10a"}