{"uid":"cap_74sOb1gPLJGJ1GoJpb2kH","slug":"coingecko-coin-metadata-market-data-by-id-e3feaf3d","name":"CoinGecko Coin Metadata & Market Data by ID","description":"Crypto coin metadata and market data by CoinGecko id — name, symbol, market-cap rank, price, homepage and categories for any token.","url":"https://coingecko.use.x402atlas.com/coin","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":["id"],"properties":{"id":{"type":"string","description":"CoinGecko coin id slug, lowercase letters/digits/hyphens, e.g. bitcoin"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","id","symbol","name","market_data"],"properties":{"id":{"type":"string","description":"CoinGecko coin id slug"},"name":{"type":"string","description":"Coin name"},"image":{"type":"string","description":"URL of the coin's large logo image"},"symbol":{"type":"string","description":"Ticker symbol"},"homepage":{"type":"string","description":"Project homepage URL"},"categories":{"type":"array","items":{"type":"string"},"description":"Project category labels"},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp the upstream was queried"},"market_data":{"type":"object","properties":{"ath_usd":{"type":"number","description":"All-time high price in USD"},"atl_usd":{"type":"number","description":"All-time low price in USD"},"max_supply":{"type":"number","description":"Max supply"},"total_supply":{"type":"number","description":"Total supply"},"market_cap_usd":{"type":"number","description":"Market cap in USD"},"total_volume_usd":{"type":"number","description":"24h trading volume in USD"},"current_price_usd":{"type":"number","description":"Current price in USD"},"circulating_supply":{"type":"number","description":"Circulating supply"},"price_change_pct_7d":{"type":"number","description":"Price change percent over 7d"},"price_change_pct_24h":{"type":"number","description":"Price change percent over 24h"},"price_change_pct_30d":{"type":"number","description":"Price change percent over 30d"}},"description":"Headline USD market figures"},"market_cap_rank":{"type":"integer","description":"Rank by market cap"}}}}}}},"responseSchema":{"type":"json","example":{"id":"bitcoin","name":"Bitcoin","image":"https://assets.coingecko.com/coins/images/1/large/bitcoin.png","symbol":"btc","homepage":"https://www.bitcoin.org","categories":["Cryptocurrency"],"queried_at":"2026-06-08T12:00:00Z","market_data":{"market_cap_usd":1300000000000,"current_price_usd":67000},"market_cap_rank":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iao63wwg_ufK5YtYNSQNC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns detailed metadata and market data for a specific crypto coin by its CoinGecko ID slug, including name, symbol, market-cap rank, price, homepage, and categories.","exampleAgentPrompt":"Can you pull up the CoinGecko metadata for 'uniswap' — I need its market-cap rank, categories, and official homepage?","exampleUseCases":null,"resultDescription":"A JSON object containing the coin's canonical name, ticker symbol, market-cap rank, current price, official homepage URL, and the CoinGecko category tags associated with the token.","failureModes":["Invalid or unknown CoinGecko ID slug returns a 4xx error","Coin ID is misspelled or uses the coin's symbol instead of slug (e.g. 'ETH' instead of 'ethereum')","Rate limiting or payment failure results in 402 or 429 response","Newly listed coins may not yet have full metadata populated"],"whenToPreferThis":"Use this endpoint when you need rich, structured metadata for a single known coin — including its categories, homepage, and market-cap rank — and you already know its CoinGecko ID slug. Prefer this over the price endpoint when you need more than just a spot price, and over the market-cap ranking list when you need detail on a specific coin rather than a ranked overview.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:52.563Z","isFirstParty":false}