{"uid":"cap_Kq4XlMs-4Wndroh-iYGzL","slug":"agenticfi-token-supply-fdv-lookup-ceba5977","name":"AgenticFi Token Supply & FDV Lookup","description":"Circulating, total, max supply + FDV for a token","url":"https://defi-api.agenticfi.wtf/api/token/supply/ethereum","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","pathParams","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","title":"id (required)","description":"Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum"}}},"queryParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","title":"id (required)","description":"Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_196-VdglKMUwxxgMUPDzC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns circulating supply, total supply, max supply, and fully diluted valuation (FDV) for a token by CoinGecko ID","exampleAgentPrompt":"What's the circulating supply, total supply, max supply, and fully diluted valuation for Ethereum right now?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing circulating supply, total supply, max supply, and fully diluted valuation (FDV) for the requested token, sourced from CoinGecko data.","failureModes":["Invalid CoinGecko token ID returns a 404 or error response","Token has no max supply (e.g. Ethereum) — max supply field may be null","Payment failure (x402) if USDC balance is insufficient","Rate limiting or upstream CoinGecko API unavailability causing 503"],"whenToPreferThis":"Use this endpoint when you need tokenomics data — specifically circulating, total, or max supply and FDV — for a specific token identified by its CoinGecko ID. Prefer this over general price endpoints when the user is asking about supply metrics or wants to understand dilution. It is well-suited for AI agents that need on-demand, pay-per-call token supply data without managing a full CoinGecko API subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:05:04.540Z","isFirstParty":false}