{"uid":"cap_mlHyJLtOZ-tCmzqKK2Gxa","slug":"aether-erc-20-balance-lookup-on-base-94beef98","name":"Aether ERC-20 Balance Lookup on Base","description":"Pay-per-call Base onchain data, token risk verdicts and x402 payability audits over x402 (USDC on Base).","url":"https://aether-x402.vercel.app/v1/base/erc20-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"responseSchema":{"type":"json","example":{"raw":"1500000","symbol":"USDC","decimals":6,"formatted":"1.5"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S1TuFCReor6Gpa7AVFtov","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","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 for a given wallet address on the Base network, including raw amount, symbol, decimals, and human-readable formatted value.","exampleAgentPrompt":"What's the USDC balance of wallet 0xAbCd...1234 on Base? Use the token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and give me the human-readable formatted amount.","exampleUseCases":[{"title":"Pre-trade balance check for DeFi bot","prompt":"Before the swap executes, check how much USDC wallet 0x1234...abcd actually holds on Base using token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I need the formatted balance to confirm there are enough funds."},{"title":"Portfolio tracker wallet audit","prompt":"I'm auditing a wallet — can you look up the WETH balance on Base for address 0xDead...Beef using token contract 0x4200000000000000000000000000000000000006 and tell me the raw and formatted amounts?"},{"title":"Verify token receipt after transfer","prompt":"Did the transfer go through? Check whether address 0xCafe...1234 now has any DAI on Base using token contract 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb and show me the current balance."}],"resultDescription":"A JSON object containing the raw balance string (e.g. '1500000'), the token symbol (e.g. 'USDC'), the number of decimals (e.g. 6), and the human-readable formatted balance (e.g. '1.5'). Paid via x402 protocol at $0.002 USDC per call.","failureModes":["Invalid token contract address (not a valid 0x ERC-20 address) returns an error","Invalid wallet address format returns validation error","Token contract does not exist on Base returns zero balance or error","Network congestion or RPC failure may cause timeouts","Payment failure via x402 (insufficient USDC) blocks the call"],"whenToPreferThis":"Choose this endpoint when you need a quick, pay-per-call ERC-20 balance lookup specifically on the Base network without managing your own RPC infrastructure. Ideal for AI agents that need to verify token holdings before executing transactions, auditing wallets, or enriching onchain data pipelines. The x402 micropayment model means no API key setup — just pay $0.002 USDC per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:41:45.300Z","isFirstParty":false,"canonicalSlug":"aether-erc-20-balance-lookup-on-base-94beef98"}