{"uid":"cap_tm8Crrpdh1tFcp7c_fIzJ","slug":"multi-address-eth-balance-batch-lookup-e8e567a6","name":"Multi-Address ETH Balance Batch Lookup","description":"Native ETH balance for up to 20 wallet addresses in one call, from Etherscan's V2 API -- a portfolio-style batch lookup instead of N separate /wallet-balance calls. Not address-scoped in the path; pass addresses as a comma-separated query param. $0.01/call.","url":"https://www.x402financialdata.com/multi-balance","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":["addresses"],"properties":{"chain":{"enum":["eth"],"type":"string","description":"Which chain to query. Only 'eth' is supported right now."},"addresses":{"type":"string","description":"Comma-separated EVM addresses, up to 20."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_mTH2u-be3OR6iz_0crb9h","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 ETH balances for up to 20 Ethereum wallet addresses in a single call via Etherscan V2","exampleAgentPrompt":"Can you fetch the current native ETH balances for all of these wallets at once: 0xABC...1, 0xDEF...2, 0x123...3, and 0x456...4 — I want to see them all in one shot instead of looking each one up separately.","exampleUseCases":[{"title":"Crypto portfolio snapshot","prompt":"I want to see the current ETH balances across all of my wallets — here are the addresses: 0xAAA...1, 0xBBB...2, 0xCCC...3, 0xDDD...4, and 0xEEE...5. Can you pull them all at once?"},{"title":"Whale wallet monitoring","prompt":"Check the current ETH balances for these 10 known whale addresses at once and tell me who holds the most: 0x111...1, 0x222...2, 0x333...3, 0x444...4, 0x555...5, 0x666...6, 0x777...7, 0x888...8, 0x999...9, 0xAAA...0."},{"title":"Airdrop eligibility pre-check","prompt":"Before we do the airdrop, can you quickly check the native ETH balances for these 15 recipient addresses to confirm they all have enough ETH to cover gas? Here's the list: 0xA1...through 0xA15..."}],"resultDescription":"Returns an array of objects, each containing the queried wallet address and its current native ETH balance on the Ethereum mainnet, sourced from Etherscan V2. Up to 20 addresses are resolved in a single response.","failureModes":["More than 20 addresses submitted — API will reject or truncate the list","Invalid or malformed Ethereum address in the list — may return an error or zero balance for that entry","Non-ETH chain requested (only 'eth' is currently supported) — unsupported chain will be rejected","Network or upstream Etherscan outage — may return 5xx or timeout","Empty address list — required parameter missing causes validation error"],"whenToPreferThis":"Use this endpoint when you need ETH balances for 2–20 wallets simultaneously and want to avoid making N separate calls. It is ideal for portfolio dashboards, airdrop screens, whale tracking, and any scenario where you have a known list of addresses. If you only need one address, a single-address balance endpoint may suffice, but this endpoint still works for one. Prefer this over iterating single-balance calls to reduce latency and cost. Note it returns only native ETH, not ERC-20 token balances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:55:54.574Z","isFirstParty":false}