CoinGecko

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.

compare-coins

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-history

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.

get-coin-info

Get a single coin's historical price and market cap series over a date range, as data: up to 120 evenly spaced points plus start and end timestamps. Use this when the user needs the numbers behind a price history, e.g. to compute a return or find the high and low over a period. To show a chart of one coin, call get-coin-markets with chartDays instead. Not for the current spot price (use get-coin-markets) and not financial advice.

get-coin-market-chart

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 advice.

get-coin-markets

Get a ranked leaderboard of crypto categories (sectors/narratives like DeFi, Layer 1, memes, AI, RWA) by total market cap and 24h change. 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-categories

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).

get-crypto-news

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-global-market

Get the top gaining and top losing coins over a time window (1h, 24h or 7d), with price and change. 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-top-gainers-losers

Get the coins trending on CoinGecko in the last 24 hours, with market cap rank, price and 24h change. 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-trending