{"uid":"cap_wmUIT7MTX-0XSsNOIkJf5","slug":"token-supply-lookup-for-base-tokens-ae728a35","name":"Token Supply Lookup for Base Tokens","description":"🆕 totalSupply for any Base token, returned raw and scaled by its decimals, alongside the name and symbol. When a contract doesn't declare decimals the answer assumes 18 and marks that it assumed — a silent guess here quietly moves every downstream number by orders of magnitude. Non-token addresses answer found:false.","url":"https://402.com.tr/api/x402/token-supply","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"Token contract"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_kWTTlcl8bo-fBmN5LRmTN","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 total supply of any Base token, both raw and decimals-scaled, along with its name and symbol.","exampleAgentPrompt":"What's the total supply of the Base token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — give me both the raw number and the human-readable scaled amount with the token name and symbol?","exampleUseCases":[{"title":"DeFi dashboard token supply card","prompt":"Pull the total supply for the USDC token on Base at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I need the scaled supply and the token name and symbol to display on the dashboard."},{"title":"New token vetting before investment","prompt":"I just found a new token on Base at contract 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — can you check its total supply, name, and symbol so I can gauge how many tokens are in circulation?"},{"title":"Automated token metadata enrichment pipeline","prompt":"For each of the token contracts I'm tracking on Base, starting with 0x4200000000000000000000000000000000000006, grab the total supply scaled by decimals plus the name and symbol so I can enrich my records."}],"resultDescription":"Returns a JSON object with: found (boolean indicating if address is a token), token name, symbol, raw total supply, decimals (with a flag if 18 was assumed rather than declared), and the supply scaled by decimals. Non-token addresses return found:false.","failureModes":["Non-token contract address returns found:false with no supply data","Contract without a declared decimals() function causes the API to assume 18 decimals and sets an assumed-decimals flag, which may produce misleading scaled supply figures","Invalid or malformed contract address may result in an error response","Token exists but has non-standard supply methods may not return correct data","Network or RPC errors on Base may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need quick, reliable total supply data for a Base ERC-20 token, especially when you also need the human-readable scaled value alongside raw supply. Prefer it over generic blockchain RPC calls when you want decimals handling and token metadata (name, symbol) in a single call. It is purpose-built for Base and handles the decimals-scaling edge case explicitly with a warning flag.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:43:04.369Z","isFirstParty":false}