{"uid":"cap__EmL-jYrqhKlRBBO6KUXf","slug":"chainread-multicall-balances-a0a5f13d","name":"ChainRead Multicall Balances","description":"Cheap EVM read utilities for AI agents on Base and Ethereum mainnet: gas and fees, blocks, balances, ERC-20 metadata, contract inspection, transaction status, ENS/Basename resolution, bulk balances. No API key: pay USDC on Base per call via x402.","url":"https://chainread.imac2014ville.workers.dev/multicall-balances?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"],"type":"string"},"queryParams":{"type":"object","required":["addresses"],"properties":{"chain":{"enum":["base","ethereum"],"type":"string","description":"Chain to read (default base)"},"token":{"type":"string","description":"Optional ERC-20 address; omit for native ETH"},"addresses":{"type":"array","items":{"type":"string"},"description":"1-20 addresses (GET: comma-separated)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"asset":{"symbol":"USDC","decimals":6},"chain":"base","count":2,"total":"1234.5","balances":[{"address":"0x4200000000000000000000000000000000000006","balance":"1000"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U-gihCDLMCLwPA1lEaK1x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches native ETH or ERC-20 token balances for up to 20 addresses in a single call on Base or Ethereum mainnet","exampleAgentPrompt":"Can you check the USDC balances on Base for these three wallet addresses: 0xABC...1, 0xABC...2, and 0xABC...3, and tell me the total combined balance?","exampleUseCases":[{"title":"Portfolio aggregate balance check","prompt":"I have a list of 5 wallet addresses — can you look up how much ETH each one holds on Base and give me the grand total across all of them?"},{"title":"DAO treasury multi-wallet audit","prompt":"We have 8 treasury wallet addresses on Ethereum mainnet. Can you fetch the USDC balance for each one and sum them up so I can see total DAO holdings?"},{"title":"Airdrop eligibility snapshot","prompt":"I need to check whether these 15 addresses hold any of our ERC-20 token at 0xTokenAddress on Base — fetch all their balances at once and show me which ones have more than zero."}],"resultDescription":"Returns a JSON object with ok=true, the asset symbol and decimals, the chain queried, the count of addresses, the total aggregated balance as a string, and an array of per-address balance objects each containing the address and its individual balance.","failureModes":["Missing required 'addresses' query parameter returns an error","More than 20 addresses supplied may be rejected or truncated","Invalid ERC-20 token contract address returns an error or zero balances","Unsupported chain value (not 'base' or 'ethereum') returns an error","Payment failure via x402/USDC results in 402 response and no data","RPC node unavailability may cause intermittent failures"],"whenToPreferThis":"Choose this endpoint when you need to query balances for multiple addresses (up to 20) in a single API call on Base or Ethereum mainnet, avoiding multiple round-trips. It is especially useful for portfolio aggregation, airdrop snapshots, treasury monitoring, or any scenario requiring both per-address and total balances for native ETH or any ERC-20 token. Prefer over single-address lookups when batching 2–20 addresses; prefer over full indexers when you only need balance data without transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:35:38.190Z","isFirstParty":false,"canonicalSlug":"chainread-multicall-balances-a0a5f13d"}