{"uid":"cap_F5t_VVW4AQaSY3giNAm-x","slug":"verifyoracle-erc-20-token-balance-on-base-mainnet-e82afd4c","name":"VerifyOracle — ERC-20 Token Balance on Base Mainnet","description":"Primary-source verifiable x402 API oracle on Base Mainnet USDC.","url":"https://penger-oracle.run402.com/api/erc20-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","properties":{"address":{"type":"string","description":"Wallet address on Base Mainnet"},"contract":{"type":"string","description":"ERC-20 contract address on Base"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"source":"base-mainnet-rpc","address":"0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3","chainId":8453,"contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"balanceRaw":"0","balanceFormatted":"0.0"}},"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_WVoS3-Qg7T2KxPa5s74Ie","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 ERC-20 token balance (raw and formatted) for a given wallet address on Base Mainnet, sourced directly from the Base public RPC.","exampleAgentPrompt":"Can you check the USDC balance for wallet 0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3 on Base Mainnet using the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"Pre-payment wallet funding check","prompt":"Before we send the invoice, can you verify that wallet 0xAbC123...def has enough USDC on Base Mainnet to cover the payment? The USDC contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"x402 API budget monitoring","prompt":"Check the current USDC balance on Base for my agent's wallet 0x91799aa29fb7e2D3E6Dfa738C67693E5E83B9Fa3 so I know how much it has left to spend on x402 API calls."},{"title":"DeFi portfolio snapshot","prompt":"What's the USDC balance for wallet 0xDeF456...789 on Base Mainnet right now? Use the standard USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and give me both the raw and human-readable amounts."}],"resultDescription":"Returns a JSON object containing: the data source ('base-mainnet-rpc'), the queried wallet address, the chain ID (8453), the ERC-20 contract address, the token's decimal places, the raw balance (as a string), and the human-formatted balance (e.g. '10.500000').","failureModes":["Invalid or malformed wallet address returns an error or empty balance","Invalid ERC-20 contract address returns an error or zero balance","RPC node downtime may cause transient failures","Missing required query parameters (address or contract) result in a bad request error","Non-existent contract address on Base Mainnet may return zero or error"],"whenToPreferThis":"Choose this endpoint when you need a primary-source, on-chain verified ERC-20 token balance directly from Base Mainnet RPC, especially for USDC. Ideal for x402 payment agents that need to verify wallet funding before or after micropayments, or any workflow requiring trustworthy, real-time on-chain balance data without relying on a third-party indexer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:34:22.751Z","isFirstParty":false,"canonicalSlug":"verifyoracle-erc-20-token-balance-on-base-mainnet-e82afd4c"}