{"uid":"cap_nG3Uuj6FtEDa9UAkEusxb","slug":"riley-craig-x402-agent-store-on-chain-balance-lookup-6a4acf36","name":"Riley Craig x402 Agent Store — On-Chain Balance Lookup","description":"The cheapest on-chain RPC read: any address's native coin balance (ETH/POL/xDAI) with live USD value and outgoing transaction count (nonce), across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The high-frequency balance check wallet-tracking, settlement, and trading agents poll constantly. Free upstream (Blockscout); undercuts onesource.","url":"https://x402-agent-store.rileycraig14.workers.dev/chain/balance","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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"base|ethereum|optimism|arbitrum|polygon|gnosis (default base)"},"address":{"type":"string","description":"Account address (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"balance":{"type":"number"},"tx_count":{"type":"number"},"usd_value":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"chain":"base","symbol":"ETH","address":"0x...","balance":61.6,"tx_count":1842,"usd_value":99826.71}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3gGdrEXe2lZ0NUBbUOBCc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the native token balance, transaction count, and USD value for a given wallet address on a specified EVM chain, paid per-call via x402/USDC.","exampleAgentPrompt":"What's the current ETH balance and USD value of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — and how many transactions have they made?","exampleUseCases":null,"resultDescription":"A JSON object containing the chain name, native token symbol, wallet address, native token balance as a decimal number, total transaction count, and current USD value of the balance. Example: {chain:'base', symbol:'ETH', address:'0x...', balance:61.6, tx_count:1842, usd_value:99826.71}.","failureModes":["Invalid or malformed wallet address returns an error response","Unsupported chain name returns an error or default to base","Payment failure via x402 protocol results in 402 status with no data returned","Network or RPC issues for the requested chain may cause a timeout or 503","Address with no activity returns zero balance and zero tx_count"],"whenToPreferThis":"Use this endpoint when an AI agent needs to read the native token balance (ETH, MATIC, etc.) of any EVM-compatible wallet address without setting up API keys or subscriptions — ideal for on-demand, pay-per-call blockchain reads in agentic workflows using x402 micropayments on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:28.287Z","isFirstParty":false}