Verify that the CoinGecko API is reachable and report this server's configuration and cache statistics. Use this first when other tools are failing, to tell an upstream outage from a configuration problem.

List every currency code accepted as a vs_currency by the other tools, including fiat ('usd', 'eur') and crypto ('btc', 'eth').

Find coins by name or ticker symbol and return their CoinGecko ids. Call this whenever you are unsure of a coin id — every other tool expects the id slug ('bitcoin'), not the symbol ('BTC').

List the coins most searched on CoinGecko in the last 24 hours. Reflects attention, not price performance.

Get current prices for one or more coins in one or more currencies, optionally with market cap, 24-hour volume, and 24-hour change. Batch coins into a single call rather than calling once per coin.

Convert a quantity of one cryptocurrency into another currency at the current rate, e.g. 2.5 ETH in USD.

Get a full profile for one coin: description, homepage, categories, supply figures, all-time high, and current market data including 24h, 7d, and 30d price changes.

List coins ranked by market cap, volume, or id, with price and 24-hour change for each. Use this for market overviews and 'top N' questions.

Get historical price, market cap, and volume series for a coin over a look-back window. Long windows are down-sampled to max_points evenly spaced observations; the reported change_percent is always computed from the full series.

Get open/high/low/close candles for a coin. CoinGecko picks the candle width from the window: 30 minutes up to 2 days, 4 hours up to 30 days, 4 days beyond that. The chosen width is reported in the result.

Get a coin's price, market cap, and volume as of 00:00 UTC on a past calendar date. For a range of dates use get_market_chart instead. Note: CoinGecko restricts this endpoint to Demo and Pro plans — without an API key it fails. get_market_chart covers history on the public tier.

Get aggregate statistics for the whole crypto market: total market cap, total 24-hour volume, BTC and ETH dominance, and the number of tracked coins and markets.