{"openapi":"3.0.3","info":{"title":"Gnist Context — CoinGecko Crypto","description":"Real-time and historical cryptocurrency prices, market data, trending coins, and market rankings for 10,000+ coins. Prices, market caps, volumes, charts, and category filtering.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/coingecko/`\n- **Toolkit page:** `/toolkits/coingecko`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/coingecko/search_coins":{"post":{"tags":["Finance"],"summary":"search_coins","description":"Search for cryptocurrencies by name or ticker symbol.\n\nFind coin IDs for use with other tools. Covers 10,000+ coins tracked by CoinGecko.\n\nArgs:\n    query: Coin name or ticker symbol.\n\nReturns:\n    List of matching coins with ID, name, symbol, and market cap rank.\n    Use the ID with get_price, get_coin_detail, or get_market_chart.","operationId":"coingecko_search_coins","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Coin name or symbol (e.g. \"bitcoin\", \"eth\", \"solana\", \"dogecoin\").","type":"string"}},"required":["query"],"type":"object"}}}}}},"/rest/coingecko/get_price":{"post":{"tags":["Finance"],"summary":"get_price","description":"Get current prices for one or more cryptocurrencies.\n\nReturns real-time prices with 24h change and market cap. Supports any fiat\nor crypto as the quote currency.\n\nArgs:\n    coin_ids: List of CoinGecko coin IDs (up to 10).\n    vs_currency: Quote currency (default 'usd').\n\nReturns:\n    Current price, market cap, and 24h change percentage for each coin.","operationId":"coingecko_get_price","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"coin_ids":{"description":"Coin IDs (e.g. [\"bitcoin\", \"ethereum\"]). Use search_coins to find IDs.","items":{"type":"string"},"type":"array"},"vs_currency":{"default":"usd","description":"Currency for prices: usd, eur, nok, gbp, btc, etc.","type":"string"}},"required":["coin_ids"],"type":"object"}}}}}},"/rest/coingecko/get_coin_detail":{"post":{"tags":["Finance"],"summary":"get_coin_detail","description":"Get comprehensive details for a cryptocurrency.\n\nIncludes description, market data (price, market cap, volume, supply), ATH/ATL,\nprice changes across timeframes, categories, and genesis date.\n\nArgs:\n    coin_id: CoinGecko coin ID.\n\nReturns:\n    Full coin profile with market data, supply metrics, and price history.","operationId":"coingecko_get_coin_detail","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"coin_id":{"description":"CoinGecko coin ID (e.g. \"bitcoin\", \"ethereum\", \"solana\"). Use search_coins to find it.","type":"string"}},"required":["coin_id"],"type":"object"}}}}}},"/rest/coingecko/get_market_chart":{"post":{"tags":["Finance"],"summary":"get_market_chart","description":"Get historical price chart data for a cryptocurrency.\n\nReturns timestamped price data points for charting or analysis. Granularity\ndepends on time range: hourly for short periods, daily for longer ones.\n\nArgs:\n    coin_id: CoinGecko coin ID.\n    vs_currency: Quote currency (default 'usd').\n    days: Number of days of history (1–365, default 30).\n\nReturns:\n    Time series of prices (up to 100 sampled points), plus latest market cap and volume.","operationId":"coingecko_get_market_chart","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"coin_id":{"description":"CoinGecko coin ID (e.g. \"bitcoin\"). Use search_coins to find it.","type":"string"},"vs_currency":{"default":"usd","description":"Quote currency (default 'usd').","type":"string"},"days":{"default":30,"description":"Days of history (1–365, default 30). 1=hourly, 2-90=hourly, 91+=daily.","type":"integer"}},"required":["coin_id"],"type":"object"}}}}}},"/rest/coingecko/get_trending":{"post":{"tags":["Finance"],"summary":"get_trending","description":"Get trending cryptocurrencies — most searched coins in the last 24 hours.\n\nShows what the crypto community is paying attention to right now.\nUpdated frequently based on CoinGecko search volume.\n\nReturns:\n    Top trending coins with name, symbol, market cap rank, and BTC price.","operationId":"coingecko_get_trending","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/coingecko/get_markets":{"post":{"tags":["Finance"],"summary":"get_markets","description":"Get top cryptocurrencies ranked by market capitalization.\n\nReturns current price, market cap, volume, 24h change, and supply data\nfor the largest coins. Can filter by category.\n\nArgs:\n    vs_currency: Quote currency (default 'usd').\n    limit: Number of results (1–50, default 20).\n    category: Filter by category (optional).\n\nReturns:\n    List of top coins with price, market cap, volume, and 24h change.","operationId":"coingecko_get_markets","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"vs_currency":{"default":"usd","description":"Quote currency (default 'usd').","type":"string"},"limit":{"default":20,"description":"Number of results (1–50, default 20).","type":"integer"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Category filter: 'decentralized-finance-defi', 'stablecoins', 'meme-token', 'layer-1', 'layer-2', 'gaming', etc."}},"type":"object"}}}}}},"/rest/coingecko/report_feedback":{"post":{"tags":["Finance"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"coingecko_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Finance","description":"Data sources: Finance"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}