{"uid":"cap_5iBh7RfjXtFpmrLZ0LSda","slug":"token-total-supply-lookup-c9c13607","name":"Token Total Supply Lookup","description":"How many units of a token exist? Returns the total supply of an ERC-20 token on Base, scaled by its decimals, with its symbol ($0.002 per call).","url":"https://api.api-agent-ia.ch/supply?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"token":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","reseau":"base","supply":"4292274933.165079","symbole":"USDC","decimales":6}},"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_-l9b8RcrCLHWHzKlDoO8A","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 a given token by its contract address","exampleAgentPrompt":"What's the total supply of the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":[{"title":"DeFi token supply audit","prompt":"Can you check the total supply for the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F? I need to know how many tokens are in existence for my analysis."},{"title":"New token contract verification","prompt":"I just deployed a token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 — can you confirm the total supply matches what I set during deployment?"},{"title":"Tokenomics research comparison","prompt":"What is the total token supply for 0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9? I'm comparing the circulating vs total supply for a report on tokenomics."}],"resultDescription":"A JSON object containing the queried token address and its total supply as a numeric string (e.g. {\"token\": \"0x...\", \"supply\": \"1000\"}).","failureModes":["Invalid or malformed token address returns an error","Token contract does not exist on the supported chain returns empty or error response","Network timeout if the underlying RPC node is slow","Missing required 'token' query parameter returns a validation error"],"whenToPreferThis":"Use this endpoint when you need a quick, low-cost lookup of a token's total supply by contract address, especially in DeFi analytics, tokenomics research, or contract verification workflows. Prefer this over calling a blockchain node directly when you want a simple REST interface without managing RPC connections.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:32:45.223Z","isFirstParty":false,"canonicalSlug":"token-total-supply-lookup-c9c13607"}