{"uid":"cap_e05nSEf9EWhERCLEVHxAf","slug":"2s-io-evm-token-balance-lookup-4cfcfb94","name":"2s.io EVM Token Balance Lookup","description":"Live native + ERC-20 token balances for an EVM address (Base, Ethereum, Polygon, Arbitrum, Optimism; keyless). Returns the native-coin balance and, for any ERC-20 contract addresses you pass, the symbol, decimals, raw and human-formatted balance — fetched in one multicall. For wallet dashboards, treasury checks, and agent payment/settlement flows.","url":"https://2s.io/api/crypto/balances","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","polygon","arbitrum","optimism"],"type":"string","description":"Default base."},"tokens":{"type":"string","maxLength":900,"description":"Comma-separated ERC-20 contract addresses (max 20)."},"address":{"type":"string","description":"EVM address to read."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0036","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.0036/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VDLpbAQJA_i2__wo2XUWb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0036","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns native coin and ERC-20 token balances for any EVM wallet address across Base, Ethereum, Polygon, Arbitrum, and Optimism in a single multicall","exampleAgentPrompt":"Check the native ETH balance and the USDC balance (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum.","exampleUseCases":null,"resultDescription":"Returns the native coin balance for the given address plus, for each ERC-20 contract address supplied, the token symbol, decimals, raw balance (as a big integer string), and human-formatted balance (adjusted for decimals) — all fetched in a single multicall from the specified EVM chain.","failureModes":["Invalid or malformed EVM address returns an error","Unsupported chain value returns a validation error","More than 20 ERC-20 contract addresses supplied exceeds the limit","Invalid ERC-20 contract address in the tokens list may return zero or an error for that token","Network or RPC timeout results in a 500 or timeout error","Address with no transactions may return zero balances rather than an error"],"whenToPreferThis":"Use this endpoint when you need live, on-chain token and native coin balances for an EVM wallet without managing your own RPC connections or API keys. Ideal for wallet dashboards, agent payment flows that need to verify funds before transacting, treasury monitoring, and settlement checks. Prefer this over general blockchain explorers when you need structured, machine-readable balance data with decimals already resolved in a single low-latency call across multiple EVM chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:03:13.047Z","isFirstParty":false}