CoinGecko

Get coin market data

Get current market data (price, market cap, 24h volume, market cap rank) for a list of CoinGecko coin ids, or for the top N coins by market cap, and display it in a visual widget. Provide either ids or topN, not both. Use this when the user asks for the price or market data of specific coins, or for a top-N leaderboard by market cap. To compare or contrast 2–4 specific coins (e.g. "BTC vs ETH"), use compare-coins instead. Not for historical prices (use get-coin-market-chart) and not financial ad

Compare coins

Compare 2–4 coins side by side — price, market cap, FDV, multi-window price change (1h/24h/7d/30d), volume, supply, distance from all-time high — in a visual widget. Use this when the user asks to compare, contrast, or pit specific coins against each other (phrasing like 'compare', 'vs', 'versus', 'against', e.g. 'BTC vs ETH vs SOL'). Map tickers to ids yourself. Not for a single coin (use get-coin-markets) and not financial advice.

Get coin market chart

Get a single coin's historical price over a date range and display it as an interactive chart widget (filled area chart with a price/market-cap toggle and a 24h–Max range selector). Use this whenever the user wants a chart, graph, or price history for one coin — e.g. 'bitcoin chart', 'ETH price last 90 days', 'how has SOL moved this year'. Not for the current spot price of one or more coins (use get-coin-markets) and not financial advice.

Get coin history

Get a coin's price, market cap and 24h volume on a specific past date (snapshot at 00:00 UTC). Use this when the user asks what a coin was worth on a given date, e.g. 'BTC price on Jan 1 2024'. Not for current prices (use get-coin-markets) or price ranges over time (use get-coin-market-chart), and not financial advice.

Get coin info

Get descriptive project information about a coin: what it is (a short description), its categories/sectors, official links (website, explorer, Twitter/X, Reddit, GitHub, Telegram) and launch date. Use this when the user asks what a coin *is* or wants background on a project, e.g. 'what is Chainlink?' or 'tell me about Solana'. Not for prices or market data (use get-coin-markets) and not financial advice.

Search coins

Search CoinGecko for coins by name or ticker and return their coin ids. Use this when the user names a coin you cannot confidently map to a CoinGecko id, or when a ticker is ambiguous. Prefer the highest-ranked match. Not for prices — call get-coin-markets with the resolved id.

Get trending coins

Get the coins trending on CoinGecko in the last 24 hours and display them in a visual widget. Use this when the user asks what's hot, trending, or popular right now. Not for prices of specific coins (use get-coin-markets) and not financial advice.

Get crypto categories

Get a ranked leaderboard of crypto categories (sectors/narratives like DeFi, Layer 1, memes, AI, RWA) by total market cap and 24h change, and display it in a visual widget. Use this when the user asks which sectors, narratives, or themes are hot, big, or moving. Order by market cap (default) or 24h change. Not for individual trending coins (use get-trending) or overall market health (use get-global-market), and not financial advice.

Get global market data

Get a snapshot of the overall crypto market: total market cap, 24h change, total volume, BTC/ETH dominance, plus current price and 24h change for the top-cap coins (BTC, ETH, SOL, BNB, XRP). Use this when the user asks how the crypto market is doing overall. For prices of other/arbitrary coins, use get-coin-markets.

Get top gainers and losers

Get the top gaining and top losing coins over a time window and display them in a visual widget. Use this when the user asks what's pumping, dumping, or moving today. Not for a single coin's price (use get-coin-markets). Data only — never frame as a buy/sell signal. Requires a CoinGecko Pro API key.

Get crypto news

Get recent crypto news headlines — global, or filtered to one coin via coinId. Use this when the user asks for the latest news, headlines, or updates about crypto in general or about a specific coin. Headlines and links are presented verbatim; never summarized as bullish/bearish and never financial advice. Not for what a coin is (use get-coin-info) or price data (use get-coin-markets).