{"uid":"cap_fFOrsrH32iRCSyyxPuMez","slug":"tollex-wallet-token-balance-lookup-8b03fc2d","name":"Tollex Wallet Token Balance Lookup","description":"Tollex lets software agents buy APIs and tools under rules you set: it finds a capability that fits, checks your policy before anything is signed, pays with x402 in USDC on Base or USDG on Robinhood Chain, reconciles uncertain payments and returns a signed receipt.","url":"https://api.tollex.org/tools/wallet_token_balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"responseSchema":{"type":"json","example":{"tool":{"id":"wallet_token_balance","version":"1.0.0","provider":"tollex.robinhood-chain"},"result":{"token":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","balance":"14051","decimals":6},"evidence":[],"untrustedOutput":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0079","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.0079/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0079","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0079","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tXFVXE3gcGkObHcIbQnrQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0079","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ERC-20 token balance held by a given wallet address on-chain, paid via x402 micropayment in USDC.","exampleAgentPrompt":"What's the current balance of the USDC token (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) held by wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?","exampleUseCases":[{"title":"Pre-trade balance verification","prompt":"Before I place this swap, check how many WETH tokens (0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) my wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently holds."},{"title":"DeFi portfolio snapshot","prompt":"Look up the DAI balance (contract 0x6B175474E89094C44Da98b954EedeAC495271d0F) for wallet address 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B so I know what's available."},{"title":"Agent treasury monitoring","prompt":"Check whether the agent treasury wallet 0x1234567890abcdef1234567890abcdef12345678 still holds any of the governance token at 0xabcdef1234567890abcdef1234567890abcdef12."}],"resultDescription":"Returns the on-chain ERC-20 token balance for the specified wallet address and token contract, along with a signed receipt confirming the paid query. The balance reflects the current state of the blockchain at query time.","failureModes":["Invalid Ethereum address format (non-0x hex) returns a validation error","Token contract address does not correspond to a valid ERC-20 contract — balance may be zero or error","Wallet address has no holdings of the specified token — returns zero balance","Network or RPC errors may delay or fail the on-chain read","Payment failure (insufficient USDC for x402 micropayment) blocks the request"],"whenToPreferThis":"Use this endpoint when you need a quick, pay-per-query on-chain ERC-20 token balance lookup without managing your own RPC infrastructure. It is ideal for AI agents operating under a Tollex economic policy that want auditable, receipt-backed balance queries settled in USDC via x402 micropayment. Prefer this over free public RPC calls when auditability, policy compliance, and signed receipts are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:47:09.404Z","isFirstParty":false,"canonicalSlug":"tollex-wallet-token-balance-lookup-8b03fc2d"}