{"uid":"cap_RrCheDuTrjzMvhceR7HH7","slug":"evm-wallet-balances-3a4da5b1","name":"EVM Wallet Balances","description":"Balances of a wallet address or ENS name on Ethereum, Base, Arbitrum, Optimism and Polygon in one call: native ETH/POL, USDC, USDT, DAI and any ERC-20 contracts you add, each with USD value and a total. Use to check whether a wallet is funded, value a portfolio or confirm a payment arrived.","url":"https://bess-x402.onrender.com/v1/crypto/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","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chains":{"type":"string","description":"Comma-separated subset of ethereum,base,arbitrum,optimism,polygon (default all)"},"tokens":{"type":"string","description":"Extra ERC-20 contract addresses, comma-separated, max 10"},"address":{"type":"string","description":"0x address or ENS name"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bUGZ-aXE_LIey1VJs0MUN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns native and ERC-20 token balances with USD values for a wallet address or ENS name across Ethereum, Base, Arbitrum, Optimism, and Polygon in a single call.","exampleAgentPrompt":"What's the current balance of vitalik.eth across Ethereum, Base, and Arbitrum — show me ETH, USDC, and DAI with their USD values?","exampleUseCases":[{"title":"Verify incoming crypto payment","prompt":"Can you check if the USDC payment has arrived in wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base? I'm expecting around 500 USDC."},{"title":"Portfolio snapshot across L2s","prompt":"Give me a full balance snapshot for 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B across Ethereum, Optimism, Arbitrum, and Polygon — include ETH, USDC, USDT, and DAI with their USD values and a total."},{"title":"Pre-transaction funding check","prompt":"Before I trigger this on-chain transaction, check if the wallet 0x1234567890abcdef1234567890abcdef12345678 on Ethereum has enough ETH and USDC to cover the amounts involved."}],"resultDescription":"A structured response containing per-chain and per-token balances (native ETH/POL, USDC, USDT, DAI, and any extra ERC-20s specified), each with a USD value, plus an aggregate portfolio total in USD across all requested chains.","failureModes":["Invalid or malformed wallet address returns an error","ENS name that cannot be resolved returns a resolution failure","Requesting more than 10 extra ERC-20 tokens returns a validation error","Network timeout if an RPC node is slow or unavailable","Invalid chain name in the chains parameter returns an error","Rate limiting or payment failure returns a 402 response"],"whenToPreferThis":"Choose this endpoint when you need multi-chain EVM wallet balances in a single call rather than querying each chain separately. It is ideal for portfolio valuation, payment confirmation, and funding checks across Ethereum mainnet and major L2s (Base, Arbitrum, Optimism, Polygon). Prefer this over chain-specific balance APIs when you need a consolidated USD total or when you don't know which chain holds the assets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:41:42.045Z","isFirstParty":false,"canonicalSlug":"evm-wallet-balances-3a4da5b1"}