{"uid":"cap_JMwniK4B8T8c_VonAQ0s8","slug":"agentstools-wallet-balances-4df0465a","name":"AgentsTools Wallet Balances","description":"Native-coin balance + ERC-20 token balances (raw + human) for any address on Base, Ethereum, Arbitrum, Optimism, Polygon or BNB (default Base). On Base pass token symbols or 0x addresses (or a default common set); on other networks pass explicit 0x token addresses.","url":"https://api.agentstools.dev/wallet/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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"usd":{"type":"boolean","description":"Add best-effort USD values (Base only)"},"tokens":{"type":"array","items":{"type":"string"},"description":"Base: token symbols or 0x addresses (default common set, max 25). Other networks: explicit 0x addresses only"},"address":{"type":"string","description":"Wallet address (0x..)"},"network":{"enum":["base","ethereum","arbitrum","optimism","polygon","bnb"],"type":"string","description":"EVM network to read from (default base)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_eEc-NNJA3d_zak1PVD0Xp","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":"Returns native-coin and ERC-20 token balances (raw and human-readable) for any wallet address on Base, Ethereum, Arbitrum, Optimism, Polygon, or BNB Chain","exampleAgentPrompt":"Can you check the ETH and USDC balances — both raw and human-readable, plus USD values — for wallet 0xAbC123...def on Base?","exampleUseCases":[{"title":"Verify customer wallet balance before payout","prompt":"Before we process this withdrawal, can you check how much USDC and native coin this customer has in their wallet on Base? I need both the raw and formatted amounts so I can confirm they have enough for the transaction."},{"title":"Monitor DeFi position across chains","prompt":"Pull all the token balances for this wallet address across Ethereum, Arbitrum, and Optimism — I need to see what they're holding on each chain so we can rebalance their portfolio properly."},{"title":"Compliance audit of user holdings","prompt":"Can you grab the complete token balance list for this wallet including USDC, DAI, and any other ERC-20s they hold on Polygon and BNB Chain? I need the raw amounts and USD values if possible for our compliance report."}],"resultDescription":"Returns the native coin balance and a list of ERC-20 token balances for the given address, each with raw (wei-level) and human-readable amounts. On Base, USD values can optionally be included. Response includes per-token contract addresses, symbols, decimals, and formatted amounts.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported network name returns a validation error","More than 25 tokens specified returns an error","Explicit 0x token addresses required on non-Base networks (symbols not supported)","Network RPC timeout may return a 503 or partial result","USD values only available on Base; ignored silently on other networks"],"whenToPreferThis":"Use this endpoint when you need on-chain token balances across major EVM networks for any wallet address, especially on Base where token symbols are supported and USD values are available. Prefer this over block explorer scraping when you need clean raw+human-readable amounts in a single API call. Useful in DeFi agents, portfolio trackers, compliance checks, or any workflow that needs to verify a wallet's holdings before executing a transaction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:56:30.200Z","isFirstParty":false}