{"uid":"cap_e4JfHSITNdfp20vWSndQG","slug":"agent-tools-multi-chain-wallet-balance-00d8d889","name":"Agent Tools – Multi-Chain Wallet Balance","description":"Pay-per-call utilities for AI agents over x402, USDC on Base.","url":"https://agents.crowdspark.me/v1/chain/balance?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":["address"],"properties":{"chain":{"enum":["base","ethereum","optimism","arbitrum","polygon"],"type":"string","description":"Default base"},"tokens":{"type":"string","description":"Optional comma list of up to 10 ERC20 addresses"},"address":{"type":"string","description":"Wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","native":{"usd":2.78,"symbol":"ETH","balance":"0.0012"},"tokens":[{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","balance":"1.5"}],"address":"0x0dEA0030A17BF886543a757c55924710258c2eec"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MdH8DZNXa02zkjcPg69Wj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches native coin balance (with USD value via Chainlink) and up to 10 ERC20 token balances for a wallet address on Base, Ethereum, Optimism, Arbitrum, or Polygon.","exampleAgentPrompt":"Can you check the ETH balance and USDC balance (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0x0dEA0030A17BF886543a757c55924710258c2eec on Base, and tell me the USD value?","exampleUseCases":[{"title":"Pre-swap balance check on Base","prompt":"Before I do a swap, check the ETH balance and USDC balance (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0xAbC123...def on Base — I need to know if there's enough to cover the trade."},{"title":"Verify funds before cross-chain payment","prompt":"Check wallet 0x742d35Cc6634C0532925a3b8D4C9B7e2f1234567 on Arbitrum and tell me how much ETH it holds and its current USD value — I'm about to send a payment and need to confirm the balance is sufficient."},{"title":"Monitor multi-token portfolio on Polygon","prompt":"What are the native MATIC balance and the token balances for 0xUSDC,0xWETH,0xDAI at wallet 0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0 on Polygon? Show me USD value too."}],"resultDescription":"Returns a JSON object with the chain name, the wallet address, the native coin symbol, balance string, and USD value (via Chainlink price feed), plus an array of up to 10 ERC20 token objects each containing the token contract address, symbol, and balance string.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain name returns validation error","ERC20 token contract address not found or invalid returns null/missing token in array","RPC node temporarily unavailable causes request failure","Requesting more than 10 ERC20 token addresses truncates or errors","Chainlink price feed unavailable may cause missing USD value"],"whenToPreferThis":"Use this endpoint when an AI agent needs to read on-chain wallet balances live from public RPC nodes across Base, Ethereum, Optimism, Arbitrum, or Polygon — especially before executing swaps, payments, or funding decisions. Prefer this over block-explorer APIs when you need USD-denominated native balance (via Chainlink) and multi-token ERC20 balances in a single call without an API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:48.050Z","isFirstParty":false,"canonicalSlug":"agent-tools-multi-chain-wallet-balance-00d8d889"}