{"uid":"cap_P3cErsAGuhedFgB6yzO24","slug":"multi-chain-evm-balance-reader-native-erc20-up-to-5-chains-2410fae5","name":"Multi-Chain EVM Balance Reader (Native + ERC20, Up to 5 Chains)","description":"Multi-chain EVM balance read — native + ERC20, up to 5 chains in ONE call — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/evm-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"chains":{"type":"array","items":{"enum":["ethereum","base","polygon","arbitrum","optimism"],"type":"string"},"maxItems":5},"tokens":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"maxItems":10},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"evm-balance","address":"0x7d9a…156DB","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.008,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"url":"https://mainnet.base.org","name":"base:eth_getBalance"}],"balances":{"base":{"native":"0.000009745904142039","tokens":{"0x8335…2913":{"raw":"8000000","symbol":"USDC","balance":"8","decimals":6,"available":true}},"chain_id":8453,"available":true,"native_symbol":"ETH"}},"evidence_hash":"sha256:<64hex>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__uNWRH9XeDWL0qKDOFoyN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches native coin and ERC20 token balances for an EVM address across up to 5 chains in a single call","exampleAgentPrompt":"What are the native ETH and USDC balances for wallet 0x7d9a...156DB on Base, Arbitrum, and Polygon right now?","exampleUseCases":[{"title":"Portfolio snapshot across chains","prompt":"Can you pull all the ETH and USDC balances for my wallet 0xAbCd...1234 on Ethereum, Base, Polygon, Arbitrum, and Optimism in one shot so I can see my full cross-chain portfolio?"},{"title":"DeFi treasury audit","prompt":"Check the native and ERC20 token balances for our DAO treasury address 0xDeFi...5678 on Base and Ethereum — I need to see USDC at 0x8335...2913 and our governance token holdings."},{"title":"Airdrop eligibility pre-check","prompt":"Before we launch the airdrop, verify that address 0xUser...9abc actually has ETH on Base and Optimism and holds our token at 0xTok3...4567 on Polygon."}],"resultDescription":"Returns a JSON object containing per-chain balance data including native token amounts, ERC20 token balances with symbol and decimals, chain IDs, availability flags, an evidence hash for auditability, and a payment receipt with transaction hash and amount paid.","failureModes":["Invalid EVM address format returns validation error","Unsupported chain name causes rejection — only ethereum, base, polygon, arbitrum, optimism are valid","More than 5 chains or 10 tokens in request exceeds limits and is rejected","RPC node unavailability for a specific chain returns that chain with available:false","Payment failure or insufficient funds blocks the call before execution","Malformed token contract address (not 0x + 40 hex chars) causes schema validation error"],"whenToPreferThis":"Choose this endpoint when you need balances across multiple EVM chains in a single low-latency call rather than making separate RPC requests per chain. It is ideal for portfolio dashboards, wallet audits, pre-transaction checks, and any scenario where you need native + ERC20 data together. Prefer it over single-chain alternatives when the user's address may hold assets on 2-5 different chains simultaneously. At $0.008 per call it is cost-effective compared to orchestrating multiple individual RPC calls.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:02.087Z","isFirstParty":false,"canonicalSlug":"multi-chain-evm-balance-reader-native-erc20-up-to-5-chains-2410fae5"}