{"uid":"cap_gdlYnjoODeSyi-SvZbmfl","slug":"x402engine-wallet-balance-lookup-9ef0d1b3","name":"x402engine Wallet Balance Lookup","description":"Token balances for any wallet across 20+ chains — EVM, Solana, Bitcoin","url":"https://x402engine.app/api/wallet/balances?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"type":"object","required":["chain","address"],"properties":{"chain":{"type":"string","example":"ethereum","description":"Chain name (ethereum, polygon, base, arbitrum, etc.)"},"address":{"type":"string","example":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","description":"Wallet address"}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_C3MVgJaHNLB-Pu-wbI164","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns token balances for a given wallet address on a specified blockchain (EVM, Solana, Bitcoin, 20+ chains)","exampleAgentPrompt":"What are the token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum?","exampleUseCases":[{"title":"DeFi portfolio tracker check","prompt":"Can you look up all the token balances for my wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Polygon so I can see what I'm holding?"},{"title":"On-chain agent payment verification","prompt":"Before processing this order, check if wallet 0xABC123...def on Base has any USDC balance to confirm they can pay."},{"title":"Solana airdrop eligibility check","prompt":"Check the token balances for Solana wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM to see if it qualifies for the airdrop."}],"resultDescription":"Returns token balance data for the specified wallet address on the requested chain, including token names, amounts, and potentially contract addresses or decimals for each held token.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain name returns an error or empty result","Network timeouts for congested chains","Address with zero balance returns empty token list","Incorrect address format for the specified chain (e.g. EVM address on Solana)"],"whenToPreferThis":"Use this endpoint when you need real-time on-chain token balance data for a specific wallet address on one of 20+ supported chains including EVM-compatible chains (Ethereum, Polygon, Base, Arbitrum), Solana, and Bitcoin. Prefer this over blockchain RPC calls when you want a simple, pay-per-use abstraction without managing node infrastructure or API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:32:12.942Z","isFirstParty":false,"canonicalSlug":"x402engine-wallet-balance-lookup-9ef0d1b3"}