{"uid":"cap_4xSmX1dbv8qEF1bqBYH_z","slug":"base-reads-usdc-balance-lookup-5f2bfb9c","name":"Base Reads – USDC Balance Lookup","description":"Pay-per-call read API for Base over x402 v2. Deterministic data, no advice.","url":"https://base-reads-api.rafliyaputra.deno.net/base/usdc-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":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Base address to read (0x + 40 hex chars)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"eth":0.25,"usdc":12.5,"block":36000000,"chain":"base","address":"0x4200000000000000000000000000000000000016","eth_wei":"250000000000000000","usdc_raw":"12500000"}},"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_W9Bo_Q9M74ccatkDmgoW_","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 the USDC (and ETH) balance of a given Base network address at the latest block, for $0.001 USDC per call via x402.","exampleAgentPrompt":"What's the current USDC balance for the Base address 0x4200000000000000000000000000000000000016?","exampleUseCases":[{"title":"Pre-payment balance check","prompt":"Before I send that USDC transfer on Base, can you check if 0xAbCd1234...5678 actually has at least 50 USDC available right now?"},{"title":"Portfolio balance snapshot","prompt":"Can you look up the current ETH and USDC balances on Base for my wallet 0x4200000000000000000000000000000000000016 so I know what I'm working with?"},{"title":"Automated DeFi bot verification","prompt":"My trading bot needs to confirm that address 0xDeAdBeEf00000000000000000000000000001234 has a non-zero USDC balance on Base before it executes the next step — can you pull that right now?"}],"resultDescription":"A JSON object containing the wallet's USDC balance in human-readable form and raw units (usdc and usdc_raw), ETH balance in ETH and wei (eth and eth_wei), the block number at which the read was taken (block), the chain name (base), and the queried address. Example: {eth: 0.25, usdc: 12.5, block: 36000000, chain: 'base', address: '0x...', eth_wei: '250000000000000000', usdc_raw: '12500000'}.","failureModes":["Invalid address format (not matching ^0x[0-9a-fA-F]{40}$) returns a validation error","Missing address query parameter returns a 400-level error","Payment not provided or invalid x402 payment header returns 402 Payment Required","RPC/node unavailability may cause transient 5xx errors","Rate limiting if payment processing fails on the facilitator side"],"whenToPreferThis":"Use this endpoint when you need a cheap ($0.001 USDC), deterministic, pay-per-call read of a wallet's USDC balance on the Base L2 network without setting up your own RPC node or indexer. Ideal for agents that need occasional on-demand balance checks rather than continuous streaming. Prefer over general Ethereum RPC providers when you specifically need Base network data with x402 micropayment billing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:38:24.451Z","isFirstParty":false,"canonicalSlug":"base-reads-usdc-balance-lookup-5f2bfb9c"}