{"uid":"cap_yvTiDYzy9DDgb0eMHqgWP","slug":"usdc-balance-lookup-on-base-3da46896","name":"USDC Balance Lookup on Base","description":"Digital-dollar (USDC) balance of a Base address","url":"https://shop.northheart.app/lookup/usdc-balance?utm_source=zero.xyz","method":"POST","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}$"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"address":{"type":"string"},"read_from":{"type":"string"},"usdc_balance":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BcSGTYNaRupjizeV8t3p1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the USDC (digital-dollar) balance of a given Base blockchain address","exampleAgentPrompt":"What's the USDC balance on Base for the wallet address 0x1234abcd...? I want to know exactly how many digital dollars it's holding.","exampleUseCases":[{"title":"Pre-payment wallet funding check","prompt":"Before I send payment, can you check whether the Base address 0xAbCd1234... has at least 50 USDC available?"},{"title":"Agent treasury balance monitoring","prompt":"What's the current USDC balance on Base for our agent's wallet 0xDeadBeef...? I want to see how much is left in the treasury."},{"title":"Customer payment verification","prompt":"A customer says they funded their Base wallet 0x9876Fedc... with USDC — can you confirm how much is actually there right now?"}],"resultDescription":"The endpoint returns the USDC balance (as a numeric amount in human-readable digital-dollar units) held by the specified Base blockchain address, read directly from the on-chain ERC-20 token contract state.","failureModes":["Invalid or malformed Base address returns an error","Address with no USDC holdings returns a zero balance","Network or RPC issues may cause lookup failures","Request missing the target address returns a validation error"],"whenToPreferThis":"Use this endpoint when you need a quick, cheap on-chain USDC balance check for a Base address without running your own RPC node. Ideal for AI agents needing to verify wallet funding before executing payments, monitor treasury levels, or confirm counterparty balances on Base L2. Costs only $0.005 USDC per call via x402 micropayment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-22T12:26:48.103Z","isFirstParty":false,"canonicalSlug":"usdc-balance-lookup-on-base-3da46896"}