{"uid":"cap_L_QHkrPJUCBVsPGxkDe7P","slug":"base-erc20-token-balance-860aebd4","name":"Base ERC20 Token Balance","description":"Free Base USDC balance sample for the service receiver. The paid $0.0025 API reads any Base ERC-20 balance with bounded contract-code, balanceOf, and decimals calls.","url":"https://appearing-clinics-show-wrote.trycloudflare.com/base-token-balance-sample","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":[],"properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","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":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_-li7Vb0X2WLcrEtOW9cq-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads any ERC-20 token balance on the Base blockchain for a given wallet address and contract, returning the balance with proper decimal normalization.","exampleAgentPrompt":"What's the USDC balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base? Use the ERC-20 contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Can you check how many USDC tokens the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds on Base? The USDC contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Verify token receipt after transfer","prompt":"I just sent some tokens — can you confirm the balance of 0xAbCd1234...5678 for the ERC-20 token at contract 0x1234...abcd on Base so I can verify the transfer landed?"},{"title":"Agent treasury monitoring","prompt":"Check the current balance of our treasury wallet 0xDeAd...BeeF for the DAI token contract on Base and tell me the normalized amount accounting for decimals."}],"resultDescription":"Returns the ERC-20 token balance for the specified wallet and contract on Base, including the raw balanceOf result, the token's decimal places, and the human-readable normalized balance amount.","failureModes":["Invalid or non-existent contract address returns an error or zero balance","Wallet address not checksummed or malformed causes a rejection","Contract does not implement ERC-20 balanceOf or decimals — returns error","Network congestion on Base may cause timeout","Free sample endpoint returns only a fixed sample (USDC receiver balance); full arbitrary address/contract lookup requires the paid $0.0025 tier"],"whenToPreferThis":"Use this endpoint when you need to read an ERC-20 token balance specifically on the Base L2 network with decimal normalization included. Prefer it over generic Ethereum balance APIs when the token is on Base, and over Base native ETH balance endpoints when you need an ERC-20 (non-native) token. The bounded contract-code check adds lightweight validation that the contract is a real ERC-20.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T14:26:43.646Z","isFirstParty":false}