{"uid":"cap_TlXcYu9YxJ1sT87IfVIrD","slug":"agenticfi-token-metadata-by-coingecko-id-21f870a8","name":"AgenticFi Token Metadata by CoinGecko ID","description":"Token metadata - name, symbol, decimals, logo, chains, links","url":"https://defi-api.agenticfi.wtf/api/token/metadata/%7Bid%7D","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":{"request":{"input":{"type":"http","method":"GET","pathParams":{"id":"ethereum"},"queryParams":{"id":"ethereum"}}},"response":{"logo":"https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628","name":"Ethereum","chains":[""],"symbol":"eth","twitter":"https://twitter.com/ethereum","website":"https://www.ethereum.org/","decimals":18,"coingeckoId":"ethereum"}},"exampleRequest":{"id":"ethereum"},"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_uboRYBM1uSqgqQLu_VWa8","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 metadata for a cryptocurrency token given its CoinGecko ID, including name, symbol, logo, website, Twitter, decimals, and supported chains.","exampleAgentPrompt":"Can you pull up the token metadata for 'uniswap' from the CoinGecko registry — I need the symbol, logo, decimals, website, Twitter, and which chains it's on.","exampleUseCases":[{"title":"Build token selector for swap UI","prompt":"I'm building a token picker for our DeFi app. Can you pull the metadata for the top tokens we support — I need their logos, symbols, decimals, and which chains they're available on so I can render a nice dropdown."},{"title":"Verify token details before transaction","prompt":"Before we let users swap into this token, can you look up its metadata by CoinGecko ID? I want to confirm the decimals, official website, and Twitter so we can show them it's legit."},{"title":"Populate trading pair information display","prompt":"We're showing users trading pairs across different chains. Can you fetch the token info for both sides of these swaps — I need the names, logos, symbols, and decimals so the UI displays everything correctly."}],"resultDescription":"A JSON object containing the token's logo URL, name, ticker symbol, array of supported chains, Twitter profile URL, official website URL, decimal precision, and CoinGecko ID.","failureModes":["Invalid or unknown CoinGecko ID returns an error or empty response","Token exists on CoinGecko but has missing fields (e.g. no Twitter or website)","Payment failure via x402 if USDC balance is insufficient","Rate limiting or network timeout from upstream CoinGecko data source"],"whenToPreferThis":"Use this endpoint when you need structured token metadata (logo, socials, decimals, chains) keyed by CoinGecko ID and are operating in an agentic DeFi context on Base with x402 micropayment support. Prefer this over direct CoinGecko API calls when you want pay-per-call simplicity without managing API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:30:02.046Z","isFirstParty":false}