Get the current price, 24-hour change, market cap, and trading volume for a single cryptocurrency token. Use this when you need live market data for one token. For multiple tokens, prefer get_prices to avoid redundant API calls. Accepts common symbols (BTC, ETH, SOL, DOGE) or full CoinGecko IDs (bitcoin, ethereum). Prices update approximately every 60 seconds due to server-side caching. Returns an error JSON if the token is not found or the CoinGecko API is temporarily unavailable.

Get current prices for up to 50 cryptocurrency tokens in a single request. Always prefer this over multiple get_price calls when you need data for two or more tokens. It batches them into one CoinGecko API call and is significantly more efficient. Returns the same fields as get_price for each token. Symbols that cannot be resolved are omitted from the result without failing the entire batch. Accepts common symbols (BTC, ETH, SOL) or CoinGecko IDs. Returns an error if the list is empty or exceeds 50 tokens.

Get a broad snapshot of the entire cryptocurrency market. Returns total market capitalisation, 24-hour trading volume, Bitcoin dominance percentage, Ethereum dominance percentage, total number of active cryptocurrencies, the Fear and Greed index (0-100, where 0 is Extreme Fear and 100 is Extreme Greed), the top 5 gainers and top 5 losers by 24-hour price change. Use this tool when you want macro context before analysing individual tokens, or when the user asks about overall market sentiment, bull/bear conditions, or which tokens are moving most. Takes no parameters. Data is sourced from CoinGecko global endpoints and the Alternative.me Fear and Greed index.

Get detailed fundamental information about a cryptocurrency token, including its project description, official website, market cap rank, all-time high and all-time low prices with dates, circulating and total supply, fully diluted valuation, and price change percentages over 24 hours, 7 days, and 30 days. Use this when you need more than just a current price, for example for fundamental analysis, understanding a token history, or answering questions about supply dynamics. For just the current price or market cap, use get_price instead. Accepts common symbols (BTC, ETH) or CoinGecko IDs. Project descriptions are truncated to 500 characters.

Get historical price data for a cryptocurrency over a specified number of days. Returns an ordered array of [timestamp_ms, price] pairs suitable for charting, trend analysis, backtesting, or computing metrics like volatility and drawdown. Data granularity varies automatically: 5-minute intervals for 1 day, hourly for 2-90 days, and daily for 91-365 days. Use this when you need a price series rather than a single current price. For just the current price, use get_price instead. Valid range: 1 to 365 days. Accepts common symbols or CoinGecko IDs. The server retries once with a 5-second backoff on rate limits.