{"uid":"cap_P_Qpbi7tSoBXy4oDWV-Jh","slug":"onchain-balance-lookup-base-ethereum-1f211a6d","name":"Onchain Balance Lookup (Base & Ethereum)","description":"Live Base and Ethereum reads for AI agents: balances (ETH + USDC), gas, transaction status, ERC-20 metadata. $0.001 per call via x402 (USDC on Base).","url":"https://onchain.x402utils.workers.dev/v1/balance?utm_source=zero.xyz","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":{"chain":{"enum":["base","ethereum"],"type":"string","description":"base (default) or ethereum"},"address":{"type":"string","description":"0x-prefixed 20-byte address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"eth":"0.0","usdc":"0.0","block":39000000,"chain":"base","address":"0xdB6381Df2D754965804547940Bc852D9a1bc612f"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9YiegrYTw-5qVTfCJ6Ddr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live ETH and USDC balances for a given wallet address on Base or Ethereum, along with the current block number.","exampleAgentPrompt":"What's the current ETH and USDC balance for wallet 0xdB6381Df2D754965804547940Bc852D9a1bc612f on Base?","exampleUseCases":[{"title":"Pre-payment wallet solvency check","prompt":"Before we send that payment, check whether wallet 0xdB6381Df2D754965804547940Bc852D9a1bc612f has at least 10 USDC available on Base."},{"title":"Agent treasury monitoring","prompt":"What are the current ETH and USDC balances for our agent's treasury wallet 0xABCDEF1234567890abcdef1234567890ABCDEF12 on Ethereum?"},{"title":"User portfolio snapshot","prompt":"Give me a quick snapshot of ETH and USDC holdings for address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Base right now."}],"resultDescription":"A JSON object containing the ETH balance, USDC balance, current block number, chain name, and the queried address — all reflecting the live on-chain state at the time of the call.","failureModes":["Invalid or malformed address (missing 0x prefix or wrong length) returns an error","Unsupported chain value other than 'base' or 'ethereum' may return an error or default to base","Missing required 'address' query parameter results in a validation error","Payment failure via x402 protocol if USDC on Base is insufficient","Network timeouts or RPC node unavailability causing delayed or failed reads"],"whenToPreferThis":"Use this endpoint when an AI agent needs a lightweight, pay-per-call read of live ETH or USDC balances on Base or Ethereum without setting up a full RPC node or indexer. Ideal for micro-transaction workflows, balance checks before payments, or treasury monitoring where cost predictability ($0.001/call) matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:35:08.119Z","isFirstParty":false,"canonicalSlug":"onchain-balance-lookup-base-ethereum-1f211a6d"}