{"uid":"cap_d-G6Gw9fsUqGmrrgVY1jl","slug":"base-erc-20-balance-8b70cda5","name":"Base ERC-20 Balance","description":"ARYSPHERE sells AI-written verdicts on Base token contracts (a grade, a one-liner, a roast and the contract's facts) and Base/Ethereum chain reads, paid per call in USDC on Base over x402 v2. No account and no API key.","url":"https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_erc20_balanceof?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","properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 contract, 0x + 40 hex"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"holder, 0x + 40 hex"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"chain":"base","method":"balanceOf","result":"70000","service":"x402_chain_reads_v1.base_erc20_balanceof"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_384HttLDbdkO_aHQm7g3M","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 (balanceOf) for a specific holder address on the Base blockchain","exampleAgentPrompt":"What's the current token balance of wallet 0xAbCd...1234 for the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?","exampleUseCases":[{"title":"DeFi portfolio token balance check","prompt":"Can you check how many tokens the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds for the DAI contract at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base?"},{"title":"Verify token holding before airdrop","prompt":"Before I run the airdrop, confirm that address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e actually holds some of our token at 0x4200000000000000000000000000000000000006 on Base — what does balanceOf return?"},{"title":"Monitor whale wallet ERC-20 balance","prompt":"Check the current balance of the USDC token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 for the whale wallet 0x3304621d4B7C8D1B0E97Fb4A5a6fb56f9A34aB2e on Base — I want to see if they've moved funds."}],"resultDescription":"A JSON object containing: ok (boolean success flag), chain ('base'), method ('balanceOf'), result (the raw token balance as a string integer, in the token's smallest unit), and service identifier. For example: {ok: true, chain: 'base', method: 'balanceOf', result: '70000', service: 'x402_chain_reads_v1.base_erc20_balanceof'}.","failureModes":["Invalid token address format (not 0x + 40 hex) — returns error or empty","Invalid holder address format — returns error","Token contract does not exist on Base — may return zero or error","Network/RPC issues on Base — timeout or service unavailable","Rate limiting or payment failure — 402 response if USDC payment not processed"],"whenToPreferThis":"Use this endpoint when you need to read the ERC-20 token balance of a specific address on the Base L2 network. Prefer this over Ethereum mainnet equivalents when the token is deployed on Base. Choose this over bundle endpoints when you only need a single balanceOf read and want minimal cost. Ideal for lightweight on-chain checks without running your own Base node.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:40:53.830Z","isFirstParty":false,"canonicalSlug":"base-erc-20-balance-8b70cda5"}