{"uid":"cap_yxGOot-E0126jla5cWZMb","slug":"usdc-balance-on-base-e1c83696","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://gogeta2-u35175.vm.elestio.app/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":null,"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_0cRjlu0rnJoZ7uzKF7uhP","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 wallet address 0x1234abcd...5678 on Base mainnet?","exampleUseCases":[{"title":"Pre-payment liquidity check","prompt":"Before I send a payment, check if wallet 0xAbCd1234...5678 has at least 50 USDC available on Base mainnet."},{"title":"Testnet balance verification","prompt":"Can you check how much USDC the address 0xDead...Beef has on Base Sepolia so I know if I have enough test funds?"},{"title":"Portfolio balance snapshot","prompt":"Look up the USDC balance on Base for address 0x9f8E...3a2B — I want to know what's sitting in that wallet right now."}],"resultDescription":"Returns the current USDC token balance for the specified address on the requested chain, sourced directly from the official Circle USDC smart contract's balanceOf function. The balance is typically expressed as a numeric amount (likely in raw units or human-readable USDC).","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/RPC connectivity issues with Base chain may cause timeouts","Address with zero balance returns 0 rather than an error","Contract call failure if the USDC contract is temporarily unreachable"],"whenToPreferThis":"Use this endpoint when you need to check the USDC balance of a specific Ethereum address on the Base or Base Sepolia network using the official Circle USDC contract. It is the right choice for payment verification flows, pre-transaction liquidity checks, DeFi agent workflows on Base, and testnet funding validation. Prefer this over generic blockchain explorers when you need a single programmatic balance call with a known cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:30:47.844Z","isFirstParty":false,"canonicalSlug":"usdc-balance-on-base-e1c83696"}