{"uid":"cap_iX0XJ5RYI07CAf_2Pd0tB","slug":"x402-toolbox-token-balance-lookup-94a78f27","name":"x402-toolbox Token Balance Lookup","description":"309 deterministic pay-per-call tools for AI agents over x402 (USDC, Base). No signup, no API key: the payment is the identity.","url":"https://x402-toolbox.shablony-pro.workers.dev/chain/token-balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"schema":{"type":"string"}}},"responseSchema":{"type":"json","example":{"ok":true,"paid":true}},"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_S10Vu8TMT2nNo5jxTMnUF","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 the on-chain token balance for a specified wallet or token on Base via a pay-per-call x402 micropayment endpoint","exampleAgentPrompt":"What's the current token balance for wallet 0xAbc123... on Base — specifically for the USDC token contract?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Check the USDC token balance for wallet address 0x1234...abcd on Base chain — I want to know how much USDC is sitting in that wallet right now."},{"title":"Automated treasury monitoring","prompt":"Fetch the current token balance for our treasury wallet 0xDead...Beef for the token at contract 0xToken...Address on Base so I can track if it drops below a threshold."},{"title":"Pre-transaction liquidity check","prompt":"Before I send a transaction, can you look up the token balance at address 0xUser...Wallet for token contract 0xERC20...Contract on Base to confirm there are enough funds?"}],"resultDescription":"Returns a JSON object with 'ok' (boolean indicating success) and 'paid' (boolean confirming x402 payment was processed), along with the on-chain token balance for the queried address and token.","failureModes":["Invalid or malformed wallet/token address returns an error response","Insufficient USDC payment via x402 results in 402 Payment Required response","Unsupported token or network returns an error or empty balance","Schema parameter missing or malformed causes a bad request error","Cloudflare Worker timeout if the Base RPC is slow or unavailable"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-signup on-chain token balance lookup on Base and are comfortable paying $0.002 USDC per call via x402 micropayments. Ideal for AI agents that need blockchain data without managing API keys or OAuth flows — the payment itself acts as the identity. Prefer this over free RPC calls when you want a managed, reliable worker with deterministic pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:49:52.792Z","isFirstParty":false,"canonicalSlug":"x402-toolbox-token-balance-lookup-94a78f27"}