{"uid":"cap_1uohQfrE6DnrpkgGPbzHU","slug":"agent402-tools-wallet-balance-lookup-1c55cda3","name":"agent402.tools Wallet Balance Lookup","description":"Look up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, Arbitrum, or Optimism. Returns clean decimal balances (already scaled by token decimals) plus symbol and contract - ready to display in a UI or feed into a portfolio tool.","url":"https://agent402.tools/api/wallet-balance","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","description":"0x-prefixed 40-char hex wallet address."},"network":{"type":"string","description":"ethereum / base / polygon / arbitrum / optimism (default base)."}}},"responseSchema":{"type":"json","example":{"native":{"raw":"1234000000000000","symbol":"ETH","balance":"0.001234"},"tokens":[{"raw":"100000000","symbol":"USDC","balance":"100","contract":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","decimals":6}],"address":"0xabf4fabd7c416fb67202e5f9002389fc75e2a9d0","network":"base"}},"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_WDm4tDhTyes1zm5HzQJam","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":"Returns native coin (ETH/MATIC) and all ERC-20 token balances for a wallet address on Ethereum, Base, Polygon, Arbitrum, or Optimism","exampleAgentPrompt":"What ETH and ERC-20 tokens does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e hold on Base — give me every token with its symbol, contract, and balance?","exampleUseCases":null,"resultDescription":"A list of all token holdings for the specified wallet: native coin balance (e.g. ETH or MATIC, already decimal-scaled), plus each ERC-20 with its symbol, contract address, and human-readable balance. No raw wei values — everything is pre-scaled for immediate use.","failureModes":["Invalid or malformed wallet address (not 0x-prefixed or wrong length) returns error","Unsupported network name returns error or defaults to Base","Wallet with no token holdings returns empty token list","Network RPC unavailability causes timeout or partial result","Payment failure (x402) prevents the call from completing"],"whenToPreferThis":"Use this endpoint when you need a complete, multi-token snapshot of a wallet's holdings on a specific EVM chain — especially when you need human-readable decimal balances across both native coin and ERC-20s without having to handle token decimals yourself. Ideal for portfolio analysis, DeFi position checks, or any agent workflow that needs to know 'what does this wallet have?' on Ethereum, Base, Polygon, Arbitrum, or Optimism.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:14:05.682Z","isFirstParty":false}