> ## Documentation Index > Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt > Use this file to discover all available pages before exploring further. # Market Research > Conduct deep market research with volume, liquidity, supply metrics, historical OHLCV, trending coins, category performance, and onchain analytics from CoinGecko API. ### TL;DR Use [/coins/\{id}](/reference/coins-id) for deep-dive coin fundamentals, [/coins/markets](/reference/coins-markets) for bulk screening, [/coins/\{id}/ohlc/range](/reference/coins-id-ohlc-range) for historical backtesting, [/search/trending](/reference/trending-search) to spot market momentum, and [/coins/categories](/reference/coins-categories) to analyze sector performance.
**Market research** is the foundation of every informed crypto decision - whether you're evaluating a **new token's fundamentals**, analyzing **sector-level trends**, or running **historical backtests** to validate a thesis. This guide walks you through the CoinGecko API endpoints that matter most for market research workflows, and ties them together into a [complete workflow](#putting-it-all-together) at the end: * **Volume, liquidity, supply, and ATH metrics** for comprehensive coin analysis * **Historical OHLCV data** to backtest strategies across custom timeframes * **Trending coins and top movers** to spot emerging market momentum * **Category performance and onchain metrics** for sector-level and DeFi research Estimated reading time: **12 minutes** **Want to get started even faster?**
Copy the contents of this page from [market-research.md](https://docs.coingecko.com/docs/market-research.md) and paste it directly into your AI tool for instant context. Install the CoinGecko SKILL to give your AI coding agent built-in knowledge of every endpoint, parameter, and workflow. Setup takes less than 3 minutes. *** ## Endpoint Overview | Endpoint | What It Gives You | Best For | | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------ | | [/coins/\{id}](/reference/coins-id) | Full coin metadata, ATH, supply, volume, liquidity, and market data | Deep-dive fundamental analysis | | [/coins/markets](/reference/coins-markets) | Bulk market data for multiple coins with price change percentages | Screening and ranking coins | | [/coins/\{id}/ohlc/range](/reference/coins-id-ohlc-range) | OHLC candles for a custom date range | Backtesting strategies with precise time windows | | [/coins/\{id}/market\_chart](/reference/coins-id-market-chart) | Price, market cap, and volume over a given number of days | Historical trend analysis | | [/search/trending](/reference/trending-search) | Trending coins, NFTs, and categories in the last 24 hours | Spotting emerging momentum | | [/coins/top\_gainers\_losers](/reference/coins-top-gainers-losers) | Top 30 gainers and losers by time duration | Identifying market movers | | [/coins/categories](/reference/coins-categories) | Category-level market cap, volume, and 24h change | Sector and thematic analysis | | [/global](/reference/crypto-global) | Total market cap, BTC dominance, active coins, and volume | Macro market overview | | [/onchain/networks/trending\_pools](/reference/trending-pools-list) | Trending liquidity pools across all networks | Onchain DeFi research | Replace `YOUR_API_KEY` in the examples below with your actual CoinGecko API key.
Don't have one yet? [Get your API key here](https://www.coingecko.com/en/api/pricing). *** ## Deep-Dive Coin Fundamentals — `/coins/{id}` *🔗 More endpoint details [here](/reference/coins-id)* The single most comprehensive endpoint for researching a coin. Returns everything from ATH and ATL to circulating supply, total supply, max supply, trading volume, liquidity score, community data, and developer activity - all in one call. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/coins/bitcoin?localization=false&tickers=false&community_data=true&developer_data=true" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Key parameters:** | Parameter | Why It Matters | | ---------------- | -------------------------------------------------------------------- | | `localization` | Set to `false` to reduce response size when you only need English | | `tickers` | Set to `false` if you don't need exchange ticker data | | `community_data` | Includes Twitter followers, Reddit subscribers, and Telegram members | | `developer_data` | Includes GitHub commits, stars, forks, and contributors | **Response highlights:** ```json JSON theme={null} { "id": "bitcoin", "symbol": "btc", "market_data": { "current_price": { "usd": 67432.51 }, "market_cap": { "usd": 1326789012345 }, "total_volume": { "usd": 28394567890 }, "ath": { "usd": 73750.07 }, "ath_change_percentage": { "usd": -8.56 }, "atl": { "usd": 67.81 }, "circulating_supply": 19654321, "total_supply": 21000000, "max_supply": 21000000, "fully_diluted_valuation": { "usd": 1415482500000 } }, "community_data": { "twitter_followers": 6534210, "reddit_subscribers": 5678901 }, "developer_data": { "commit_count_4_weeks": 142 } } ``` This is your go-to endpoint for building coin profile pages or research reports. The `market_data` object alone covers price, volume, supply, ATH/ATL, and fully diluted valuation. *** ## Bulk Market Screening — `/coins/markets` *🔗 More endpoint details [here](/reference/coins-markets)* When you need to compare many coins at once - ranking by market cap, filtering by volume, or scanning for top movers across multiple timeframes. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=100&page=1&sparkline=true&price_change_percentage=1h,24h,7d,30d" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Key parameters:** | Parameter | Why It Matters | | ------------------------- | ------------------------------------------------------------------------------------- | | `order` | Sort by `market_cap_desc`, `volume_desc`, or `market_cap_asc` to surface what matters | | `sparkline` | Includes 7-day sparkline data for quick visual trend scanning | | `price_change_percentage` | Include `1h,24h,7d,30d` to spot momentum across multiple timeframes | | `per_page` | Up to 250 results per page for efficient bulk screening | | `category` | Filter by a specific category (e.g., `decentralized-finance-defi`, `layer-1`) | **Response highlights:** ```json JSON theme={null} { "id": "bitcoin", "symbol": "btc", "current_price": 67432.51, "market_cap": 1326789012345, "market_cap_rank": 1, "total_volume": 28394567890, "high_24h": 68100.00, "low_24h": 65800.00, "price_change_percentage_1h_in_currency": 0.12, "price_change_percentage_24h_in_currency": 2.34, "price_change_percentage_7d_in_currency": 5.67, "price_change_percentage_30d_in_currency": 12.45, "ath": 73750.07, "ath_change_percentage": -8.56, "sparkline_in_7d": { "price": [64200.12, 64580.45, ...] } } ``` Use the `category` parameter to narrow results to a specific sector - great for comparing all DeFi tokens or Layer 1 chains side by side. *** ## Historical OHLCV for Backtesting ### `/coins/{id}/ohlc/range` *🔗 More endpoint details [here](/reference/coins-id-ohlc-range)* Returns OHLC candle data for a custom date range - the core data format for backtesting technical strategies. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/coins/ethereum/ohlc/range?vs_currency=usd&from=2024-01-01&to=2024-12-31&interval=daily" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Key parameters:** | Parameter | Why It Matters | | ------------- | --------------------------------------------------------------------- | | `from` / `to` | Define your backtest window using ISO date strings or UNIX timestamps | | `vs_currency` | Target currency for the OHLC data | | `interval` | Use `daily` or `hourly` for consistent candle intervals (paid plans) | **Response highlights:** ```json JSON theme={null} [ [1704067200000, 2282.51, 2310.00, 2265.30, 2295.78], [1704153600000, 2295.78, 2380.00, 2290.12, 2356.45] ] ``` Each entry is `[timestamp, open, high, low, close]`. **Candle granularity is automatic** when no `interval` is specified: * **1-2 days:** 30-minute candles * **3-30 days:** 4-hour candles * **31+ days:** 4-day candles Paid plan subscribers can override this with `interval=daily` or `interval=hourly`. ### `/coins/{id}/market_chart` *🔗 More endpoint details [here](/reference/coins-id-market-chart)* When your research needs more than OHLC - this endpoint returns price, market cap, and volume time series, useful for volume-weighted analysis or market cap trend research. Just pass a `days` parameter to get the full latest data directly, similar to CoinGecko's web charts. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/coins/solana/market_chart?vs_currency=usd&days=365&interval=daily" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Response highlights:** ```json JSON theme={null} { "prices": [ [1704067200000, 101.23], [1704153600000, 105.67] ], "market_caps": [ [1704067200000, 44567890123], [1704153600000, 46234567890] ], "total_volumes": [ [1704067200000, 2345678901], [1704153600000, 2567890123] ] } ``` *** ## Trending Coins and Market Movers ### `/search/trending` *🔗 More endpoint details [here](/reference/trending-search)* Surfaces the coins, NFTs, and categories that are trending in CoinGecko search over the last 24 hours - a useful signal for emerging market interest. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/search/trending" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Response highlights:** ```json JSON theme={null} { "coins": [ { "item": { "id": "pepe", "name": "Pepe", "symbol": "PEPE", "market_cap_rank": 46, "price_btc": 0.00000000123, "data": { "price": 0.0000082, "price_change_percentage_24h": { "usd": 15.67 }, "market_cap": "$3,456,789,012", "total_volume": "$1,234,567,890", "sparkline": "https://..." } } } ], "categories": [ { "id": 1234, "name": "Meme", "data": { "market_cap_change_percentage_24h": { "usd": 8.45 } } } ] } ``` ### `/coins/top_gainers_losers` *🔗 More endpoint details [here](/reference/coins-top-gainers-losers)* Returns the top 30 coins with the largest price gains and losses for a specific time duration - perfect for finding breakout or breakdown opportunities. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/coins/top_gainers_losers?vs_currency=usd&duration=24h" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Key parameters:** | Parameter | Why It Matters | | ------------- | -------------------------------------------------------------------------------------- | | `duration` | Choose from `1h`, `24h`, `7d`, `14d`, `30d`, `60d`, `1y` to match your research window | | `vs_currency` | Target currency for price change calculations | **Response highlights:** ```json JSON theme={null} { "top_gainers": [ { "id": "example-coin", "symbol": "EXM", "name": "Example Coin", "image": "https://...", "market_cap_rank": 234, "usd": 1.23, "usd_24h_vol": 45678901, "usd_24h_change": 45.67 } ], "top_losers": [ { "id": "another-coin", "symbol": "ANT", "name": "Another Coin", "usd": 0.45, "usd_24h_change": -32.10 } ] } ``` *** ## Category and Sector Analysis — `/coins/categories` *🔗 More endpoint details [here](/reference/coins-categories)* Returns market data aggregated at the category level - market cap, volume, and 24h change for every sector. Essential for thematic research and identifying which sectors are leading or lagging. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/coins/categories?order=market_cap_change_percentage_24h_desc" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Key parameters:** | Parameter | Why It Matters | | --------- | ------------------------------------------------------------------------------------ | | `order` | Sort by `market_cap_desc`, `market_cap_change_percentage_24h_desc`, `name_asc`, etc. | **Response highlights:** ```json JSON theme={null} { "id": "layer-1", "name": "Layer 1 (L1)", "market_cap": 2345678901234, "market_cap_change_24h": 3.45, "volume_24h": 12345678901, "top_3_coins_id": ["bitcoin", "ethereum", "solana"], "top_3_coins": [ "https://assets.coingecko.com/coins/images/1/small/bitcoin.png", "https://assets.coingecko.com/coins/images/279/small/ethereum.png", "https://assets.coingecko.com/coins/images/4128/small/solana.png" ] } ``` Combine this with `/coins/markets?category=layer-1` to drill into individual coins within a category that's showing strength. *** ## Macro Market Overview — `/global` *🔗 More endpoint details [here](/reference/crypto-global)* Returns the big-picture crypto market data - total market cap, BTC dominance, total volume, and the number of active coins. Great for framing your research in the context of overall market conditions. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/global" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Response highlights:** ```json JSON theme={null} { "data": { "active_cryptocurrencies": 15234, "markets": 1089, "total_market_cap": { "usd": 2678901234567 }, "total_volume": { "usd": 89012345678 }, "market_cap_percentage": { "btc": 52.34, "eth": 16.78 }, "market_cap_change_percentage_24h_usd": 1.23 } } ``` The `market_cap_percentage` field gives you BTC and ETH dominance at a glance - a key signal for market rotation research. *** ## Onchain Trending and Metrics ### Trending Pools — `/onchain/networks/trending_pools` *🔗 More endpoint details [here](/reference/trending-pools-list)* Surfaces the hottest liquidity pools across all networks - useful for spotting early DeFi momentum before it shows up in CoinGecko's main listings. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/onchain/networks/trending_pools?include=base_token&duration=24h" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Key parameters:** | Parameter | Why It Matters | | ---------- | -------------------------------------------------------------------- | | `include` | Add `base_token`, `quote_token`, `dex`, `network` for richer context | | `duration` | Filter by `1h`, `6h`, or `24h` trending window | **Response highlights:** ```json JSON theme={null} { "data": [ { "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "type": "pool", "attributes": { "name": "USDC / WETH", "base_token_price_usd": "3456.78", "fdv_usd": "415678901234", "reserve_in_usd": "234567890", "volume_usd": { "h24": "123456789" }, "price_change_percentage": { "h24": "2.34" }, "transactions": { "h24": { "buys": 12345, "sells": 10234 } } } } ] } ``` ### Token Info — `/onchain/networks/{network}/tokens/{address}/info` *🔗 More endpoint details [here](/reference/token-info-contract-address)* Get detailed metadata for any onchain token by contract address - including description, socials, websites, and GeckoTerminal analytics score. **Example request:** ```bash cURL theme={null} curl -X GET "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/info" \ -H "x-cg-pro-api-key: YOUR_API_KEY" ``` **Response highlights:** ```json JSON theme={null} { "data": { "attributes": { "name": "USD Coin", "symbol": "USDC", "coingecko_coin_id": "usd-coin", "description": "USDC is a fully collateralized US dollar stablecoin...", "websites": ["https://www.circle.com/en/usdc"], "gt_score": 92.34, "discord_url": "https://...", "twitter_handle": "circle" } } } ``` Use this endpoint alongside [/onchain/networks/../pools/../ohlcv/..](/reference/pool-ohlcv-contract-address) for a complete onchain research workflow - fundamentals from token info, price action from OHLCV. *** ## Putting It All Together Here's how these endpoints fit into a typical market research workflow: 1. **Start with the macro view** - Query `/global` to understand overall market conditions and dominance shifts 2. **Scan for momentum** - Check `/search/trending` and `/coins/top_gainers_losers` to spot what's moving 3. **Analyze sectors** - Use `/coins/categories` to identify which sectors are outperforming 4. **Screen candidates** - Pull `/coins/markets` with category filters and multi-timeframe price changes 5. **Deep-dive fundamentals** - Query `/coins/{id}` for ATH, supply, volume, and community metrics 6. **Backtest with history** - Fetch `/coins/{id}/ohlc/range` or `/coins/{id}/market_chart` for historical data 7. **Research onchain** - Use trending pools and token info for DeFi-native alpha
Connect your AI agent directly to CoinGecko's API using our MCP server - enabling real-time crypto data queries from tools like Claude Desktop, Cursor, and more. *** Have feedback or need help? Reach out to `eason.lim@coingecko[dot]com` Built with [Mintlify](https://mintlify.com).