{"uid":"cap_5hPS2ROlDSrNYqoloEsBB","slug":"quickbuild-base-token-info-api-b5306cd9","name":"QuickBuild Base Token Info API","description":"Landing pages ($15), Google Sheets/Apps Script automation ($10), scrapers, scripts & Telegram bots (from $15), broken-link + sitemap audit reports ($10). See a working demo first, pay after.","url":"https://quickbuild.quynguyenbac.workers.dev/api/base/token?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","required":[],"properties":{"holder":{"type":"string","description":"Optional address whose balance of this token to include."},"address":{"type":"string","description":"Token / contract address on Base (0x + 40 hex). Optional: defaults to USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"name":{"type":["string","null"]},"proxy":{"type":["object","null"]},"holder":{"type":"object"},"symbol":{"type":["string","null"]},"address":{"type":"string"},"isErc20":{"type":"boolean"},"decimals":{"type":["integer","null"]},"wellKnown":{"type":"boolean"},"isContract":{"type":"boolean"},"accountType":{"type":"string"},"totalSupply":{"type":["object","null"],"properties":{"raw":{"type":"string"},"formatted":{"type":["string","null"]}}},"codeSizeBytes":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","proxy":{"standard":"ZeppelinOS (e.g. Circle FiatTokenProxy)","implementation":"0x2Ce6311ddAE708829bc0784C967b7d77D19FD779"},"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chainId":8453,"isErc20":true,"decimals":6,"wellKnown":true,"isContract":true,"accountType":"contract","totalSupply":{"raw":"4276257891842451","formatted":"4276257891.842451"},"codeSizeBytes":1852}},"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_D8FNxJAmb8sMEVp5wDwl9","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":"Looks up ERC-20 token metadata and optional holder balance on the Base blockchain by contract address","exampleAgentPrompt":"Look up the token metadata for the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to know the name, symbol, decimals, total supply, and whether it's using a proxy contract.","exampleUseCases":[{"title":"Token metadata lookup for DeFi dashboard","prompt":"Can you fetch the full token details for the contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, including its name, symbol, decimals, and total supply?"},{"title":"Verify ERC-20 status before listing","prompt":"I need to confirm whether the contract at 0x4200000000000000000000000000000000000006 on Base is a valid ERC-20 token — can you check and tell me if it's recognized as a well-known token too?"},{"title":"Check wallet's token balance","prompt":"What is the balance of USDC held by wallet 0xAbCd1234...5678 on Base? Use the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."}],"resultDescription":"Returns a JSON object with the token's name, symbol, decimals, total supply (raw and formatted), whether it is ERC-20 compliant, whether it is a well-known token, the account type (contract vs EOA), code size in bytes, proxy implementation details (if any), and optionally the holder's balance — all for the specified Base chain contract address.","failureModes":["Invalid or malformed contract address returns an error","Non-contract (EOA) address returns isContract: false with no token fields","Unknown or unverified tokens may return null for name/symbol/decimals","Network or RPC errors may cause timeouts","Payment not included or insufficient USDC causes 402 rejection"],"whenToPreferThis":"Choose this endpoint when you need on-chain ERC-20 token metadata specifically from the Base network (chainId 8453) including proxy detection, total supply, and optional holder balance — particularly when you want a pay-per-call micro-payment model via x402/USDC rather than managing API keys or subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:35:20.530Z","isFirstParty":false,"canonicalSlug":"quickbuild-base-token-info-api-b5306cd9"}