{"uid":"cap_fKpUj-AAvv1XHMQjcXAMk","slug":"dexl-agents-wallet-balance-4d6ef396","name":"DexL Agents Wallet Balance","description":"Read any wallet balance on 28 EVM chains: native coin (ETH, BNB, MATIC, AVAX) or any ERC-20 token including USDC. Covers Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, zkSync, Linea, Scroll, Blast, Mantle, Celo, Gnosis, Sonic, Unichain, World Chain, Zora and more. Returns the raw and decimal balance with the block it was read at.","url":"https://agents.dexl.io/v1/tools/wallet-balance","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["abstract","arbitrum","avalanche","base","berachain","blast","bsc","celo","cronos","ethereum","fraxtal","gnosis","ink","linea","mantle","metis","mode","opbnb","optimism","polygon","robinhood","scroll","soneium","sonic","unichain","worldchain","zksync","zora"],"type":"string","default":"base","description":"Which chain to read from"},"token":{"type":"string","description":"ERC-20 contract address. Omit for the native coin."},"address":{"type":"string","description":"Wallet address (0x...)"}}},"responseSchema":{"type":"json","example":{"units":1,"cached":false,"output":{}}},"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_fZcZACHnczPJuBAHgkCJ2","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 the native coin or ERC-20 token balance for any wallet address on 28 EVM-compatible chains, including the raw and decimal amounts and the block number at which the balance was read.","exampleAgentPrompt":"What's the USDC balance on Base for wallet 0xAbC1234567890abcdef1234567890abcdef123456? Use the ERC-20 contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.","exampleUseCases":[{"title":"Pre-transaction balance check","prompt":"Before I send this transaction, check the ETH balance on Arbitrum for wallet 0xDeF9876543210fedcba9876543210fedcba987654 so I know if there's enough to cover gas."},{"title":"DeFi portfolio tracking","prompt":"What's the USDC token balance on Polygon for 0x1234abcd5678efgh9012ijkl3456mnop7890qrst? The USDC contract on Polygon is 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174."},{"title":"Multi-chain wallet audit","prompt":"Can you check the native coin balance on each of these chains for wallet 0xAABBCCDDEEFF00112233445566778899AABBCCDD — start with Optimism, then Blast, then Scroll?"}],"resultDescription":"A JSON object containing the raw balance (in the token's smallest unit), the decimal-formatted balance, the block number at which the read occurred, and a flag indicating whether the result was served from cache.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain enum value returns a validation error","Invalid ERC-20 contract address returns an error or zero balance","Network congestion on target chain may cause timeout","Missing required 'address' field returns a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need a quick, reliable on-chain balance read across any of 28 EVM chains without running your own RPC node. It is ideal for agents that need to verify funds before executing transactions, audit multi-chain portfolios, or gate actions on token holdings. Its broad chain coverage (Base, Ethereum, Arbitrum, Optimism, zkSync, Polygon, BSC, Avalanche, and 20 more) makes it preferable over single-chain alternatives when cross-chain flexibility is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:38:35.333Z","isFirstParty":false}