{"uid":"cap_5z_Ok0i0gulqRcHWDx-RP","slug":"payai-wallet-balances-e199329a","name":"PayAI 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://payai.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_M3wH3iFQqkEZJIvAMiAlv","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":"What are the ETH and USDC balances for wallet 0xAbCd...1234 on Base, and can you show me the USD values too?","exampleUseCases":[{"title":"Monitor team treasury across chains","prompt":"Check the ETH, USDC, and DAI balances for our treasury wallet on both Ethereum and Polygon, and give me the total USD value across both networks."},{"title":"Verify customer wallet holdings","prompt":"Can you look up what tokens this address holds on Base? I need to see all their balances including how much USDC and native ETH they have, with the USD values if possible."},{"title":"Track DeFi protocol allocations","prompt":"Show me all the token balances for our protocol's contract address on Arbitrum and Optimism - I need to see exactly how much of each asset we have deployed across both chains."}],"resultDescription":"Returns a structured object containing native coin balance and a list of ERC-20 token balances, each with raw on-chain amounts and human-readable decimal values; on Base, optional best-effort USD valuations are included.","failureModes":["Invalid wallet address format returns an error","Unsupported network name returns a validation error","Passing token symbols instead of 0x addresses on non-Base networks may fail or return incomplete results","More than 25 tokens requested at once may be rejected","Tokens not found or with no liquidity may have missing or null USD values","Network RPC downtime may cause timeout or partial results"],"whenToPreferThis":"Use this endpoint when you need current on-chain token or native coin balances for a specific EVM wallet address, especially on Base (where token symbols and USD valuations are supported natively). Prefer this over generic blockchain explorers when you need structured, machine-readable balance data with human-readable amounts ready for downstream processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:52:29.311Z","isFirstParty":false}