Skip to main content

​
TL;DR

Use /coins/{id} for deep-dive coin fundamentals, /coins/markets for bulk screening, /coins/{id}/ohlc/range for historical backtesting, /search/trending to spot market momentum, and /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 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 and paste it directly into your AI tool for instant context.

Navigate the API faster with AI

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

EndpointWhat It Gives YouBest For
/coins/{id}Full coin metadata, ATH, supply, volume, liquidity, and market dataDeep-dive fundamental analysis
/coins/marketsBulk market data for multiple coins with price change percentagesScreening and ranking coins
/coins/{id}/ohlc/rangeOHLC candles for a custom date rangeBacktesting strategies with precise time windows
/coins/{id}/market_chartPrice, market cap, and volume over a given number of daysHistorical trend analysis
/search/trendingTrending coins, NFTs, and categories in the last 24 hoursSpotting emerging momentum
/coins/top_gainers_losersTop 30 gainers and losers by time durationIdentifying market movers
/coins/categoriesCategory-level market cap, volume, and 24h changeSector and thematic analysis
/globalTotal market cap, BTC dominance, active coins, and volumeMacro market overview
/onchain/networks/trending_poolsTrending liquidity pools across all networksOnchain 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.

​
Deep-Dive Coin Fundamentals — /coins/{id}

🔗 More endpoint details here 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: 
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:
ParameterWhy It Matters
localizationSet to false to reduce response size when you only need English
tickersSet to false if you don’t need exchange ticker data
community_dataIncludes Twitter followers, Reddit subscribers, and Telegram members
developer_dataIncludes GitHub commits, stars, forks, and contributors
Response highlights: 
{
  "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 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: 
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:
ParameterWhy It Matters
orderSort by market_cap_desc, volume_desc, or market_cap_asc to surface what matters
sparklineIncludes 7-day sparkline data for quick visual trend scanning
price_change_percentageInclude 1h,24h,7d,30d to spot momentum across multiple timeframes
per_pageUp to 250 results per page for efficient bulk screening
categoryFilter by a specific category (e.g., decentralized-finance-defi, layer-1)
Response highlights: 
{
  "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 Returns OHLC candle data for a custom date range - the core data format for backtesting technical strategies. Example request: 
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:
ParameterWhy It Matters
from / toDefine your backtest window using ISO date strings or UNIX timestamps
vs_currencyTarget currency for the OHLC data
intervalUse daily or hourly for consistent candle intervals (paid plans)
Response highlights: 
[
  [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 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: 
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: 
{
  "prices": [
    [1704067200000, 101.23],
    [1704153600000, 105.67]
  ],
  "market_caps": [
    [1704067200000, 44567890123],
    [1704153600000, 46234567890]
  ],
  "total_volumes": [
    [1704067200000, 2345678901],
    [1704153600000, 2567890123]
  ]
}

​
/search/trending

🔗 More endpoint details here 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: 
curl -X GET "https://pro-api.coingecko.com/api/v3/search/trending" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Response highlights: 
{
  "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 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: 
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:
ParameterWhy It Matters
durationChoose from 1h, 24h, 7d, 14d, 30d, 60d, 1y to match your research window
vs_currencyTarget currency for price change calculations
Response highlights: 
{
  "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 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: 
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:
ParameterWhy It Matters
orderSort by market_cap_desc, market_cap_change_percentage_24h_desc, name_asc, etc.
Response highlights: 
{
  "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 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: 
curl -X GET "https://pro-api.coingecko.com/api/v3/global" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Response highlights: 
{
  "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.
🔗 More endpoint details here 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: 
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:
ParameterWhy It Matters
includeAdd base_token, quote_token, dex, network for richer context
durationFilter by 1h, 6h, or 24h trending window
Response highlights: 
{
  "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 Get detailed metadata for any onchain token by contract address - including description, socials, websites, and GeckoTerminal analytics score. Example request: 
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: 
{
  "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/.. 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

Integrate with CoinGecko MCP Server

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