{"uid":"cap_pgU92Wx7Y4pxgqJJZa2be","slug":"usdc-balance-on-base-f7025ffc","name":"USDC Balance on Base","description":"Current USDC balance of an address on Base or Base Sepolia (balanceOf on the official Circle contract).","url":"https://api.novarithm.com/agents/v1/payments/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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","base-sepolia"],"type":"string","default":"base","description":"base (default) or base-sepolia"},"address":{"type":"string","description":"Address (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"chain":"base","source":"eth_call balanceOf on the official USDC contract","address":"0xe414ad5c7542ce63d890526f0e2133ff8da6f22d","sources":[{}],"chain_id":8453,"price_usd":0.001,"balance_raw":"0","billing_unit":"address","block_number":52980236,"generated_at":"2026-10-23T10:03:40Z","usdc_balance":0,"usdc_contract":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","response_time_ms":227},"service":"usdc_balance"}},"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_UzUIi3CAP0HWHEEoJMzKZ","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 current USDC token balance of an Ethereum address on Base mainnet or Base Sepolia testnet by calling the official Circle USDC contract's balanceOf function.","exampleAgentPrompt":"What's the current USDC balance for the wallet address 0x1234...abcd on Base mainnet?","exampleUseCases":[{"title":"Verify payment receipt on Base","prompt":"Has 0xRecipientAddress...abcd received any USDC on Base yet? Check its current USDC balance for me."},{"title":"Testnet balance check before deploy","prompt":"Can you check how much USDC the address 0xDev...5678 has on Base Sepolia so I know if I have enough test funds before I deploy?"},{"title":"Monitor treasury wallet holdings","prompt":"What's the USDC balance of our treasury wallet 0xTreasury...9abc on Base mainnet right now?"}],"resultDescription":"Returns the USDC token balance (balanceOf) for the specified address on Base mainnet or Base Sepolia, sourced directly from the official Circle USDC contract. The response includes the balance amount, typically expressed in USDC token units (with 6 decimal places).","failureModes":["Invalid or malformed Ethereum address (non-0x format) returns an error","Unsupported chain value other than 'base' or 'base-sepolia' returns a validation error","Network or RPC node unavailability may cause timeout or 503","Address with no USDC holdings returns a zero balance (not an error)","Rate limiting or payment failure ($0.001 USDC per call) may block the request"],"whenToPreferThis":"Use this endpoint when you need a fast, reliable, on-chain USDC balance lookup for any address on Base mainnet or Base Sepolia, backed by the official Circle contract. Prefer this over general blockchain explorers or multi-chain balance APIs when you specifically need USDC on Base and want a simple, agent-friendly REST interface without managing your own RPC provider.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T14:48:17.114Z","isFirstParty":false,"canonicalSlug":"usdc-balance-on-base-f7025ffc"}