{"uid":"cap_wgLt-bWaYj-ciKLkEqmwp","slug":"centralcity-ai-erc-20-token-balance-lookup-base-e1aebe77","name":"centralcity.ai ERC-20 Token Balance Lookup (Base)","description":"An address's balance of one ERC-20 token on Base, with the token's decimals and symbol.","url":"https://centralcity.ai/api/public/x402/off_y24pang6hjb52272?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"The token's contract address on Base (0x and 40 hex digits)."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"The holder: a Base address (0x and 40 hex digits)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AHLQl9tTkU4JrO82_VkxT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","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 address on the Base blockchain, including the token's decimals and symbol.","exampleAgentPrompt":"What's the USDC balance (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base) for the wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045? Also give me the token's decimals and symbol.","exampleUseCases":[{"title":"DeFi portfolio tracker balance check","prompt":"Check the balance of the AERO token (contract 0x940181a94A35A4569E4529A3CDfB74e38FD98631) held by wallet 0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD on Base, and tell me the token symbol and decimals."},{"title":"Airdrop eligibility verification","prompt":"Before I proceed, can you check how much of the token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 the wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e currently holds on Base? Include the decimals and symbol."},{"title":"Smart contract audit: token distribution check","prompt":"I need to verify the token holdings for the address 0x4200000000000000000000000000000000000006 against the ERC-20 contract 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base — what's the balance, symbol, and how many decimals does the token use?"}],"resultDescription":"Returns a JSON object containing the token balance for the specified address (as a numeric value adjusted by the token's decimals), the token's symbol (e.g. 'USDC'), and the number of decimal places the token uses (e.g. 6 for USDC, 18 for most ERC-20s).","failureModes":["Invalid contract address (not a valid ERC-20 token on Base) — returns error or zero balance","Invalid wallet address format (must be 0x + 40 hex chars) — returns validation error","Token contract exists but address has zero balance — returns 0","Network/RPC timeout querying Base — returns service error","Contract address is not an ERC-20 token (e.g. it's a plain EOA or non-standard contract) — may return error or unexpected data"],"whenToPreferThis":"Use this endpoint when you need on-chain ERC-20 token balance data specifically on the Base network, including the token's symbol and decimals in a single call. Prefer this over general blockchain explorers when you need a lightweight, pay-per-call API without API key management, and when you're already operating in the Base/x402 payment ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-19T06:38:03.837Z","isFirstParty":false,"canonicalSlug":"centralcity-ai-erc-20-token-balance-lookup-base-97da77f4"}