Market Research

Set up your API key

Build faster with AI

TL;DR
Use /coins/{id} for deep-dive fundamentals, /coins/markets for bulk screening, /search/trending for momentum signals, /coins/categories for sector performance, and /global for the macro view.

Replace YOUR_API_KEY in the examples below with your actual key. Get one here →

Research Workflow

Macro overview — /global

Total market cap, BTC dominance, volume, and active coins. Frame your research in the context of overall market conditions.

Pro API
Demo API

curl -X GET \
  "https://pro-api.coingecko.com/api/v3/global" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"

Global Data →

curl -X GET \
  "https://api.coingecko.com/api/v3/global" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Global Data →

The market_cap_percentage field gives BTC and ETH dominance — a key signal for market rotation.

Spot momentum — /search/trending

Coins, NFTs, and categories trending in CoinGecko search over the last 24 hours.

Pro API
Demo API

curl -X GET \
  "https://pro-api.coingecko.com/api/v3/search/trending" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"

Trending Search →

curl -X GET \
  "https://api.coingecko.com/api/v3/search/trending" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Trending Search →

Top movers — /coins/top_gainers_losers

Top 30 coins with the largest price gains and losses — spot breakout or breakdown opportunities.

Pro API
Demo API

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"

Top Gainers/Losers →

/coins/top_gainers_losers is not available on the Demo API.
Upgrade to Pro →

Key param	Use
`duration`	`1h`, `24h`, `7d`, `14d`, `30d`, `60d`, `1y`

Analyze sectors — /coins/categories

Category-level market cap, volume, and 24h change. Identify which sectors are leading or lagging.

Pro API
Demo API

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"

Coin Categories →

curl -X GET \
  "https://api.coingecko.com/api/v3/coins/categories?order=market_cap_change_percentage_24h_desc" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Coin Categories →

Combine with /coins/markets?category=layer-1 to drill into individual coins within a strong sector.

Screen candidates — /coins/markets

Bulk market data for up to 250 coins per page — rankings, sparklines, and multi-timeframe changes.

Pro API
Demo API

curl -X GET \
  "https://pro-api.coingecko.com/api/v3/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=100&sparkline=true&price_change_percentage=1h,24h,7d,30d" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"

Coins Markets →

curl -X GET \
  "https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=100&sparkline=true&price_change_percentage=1h,24h,7d,30d" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Coins Markets →

Key param	Use
`order`	`market_cap_desc`, `volume_desc`, `market_cap_asc`
`category`	Filter to a specific sector (e.g. `layer-1`, `decentralized-finance-defi`)
`sparkline`	7-day sparkline data for quick visual scanning
`price_change_percentage`	`1h,24h,7d,30d` for multi-timeframe momentum

Deep-dive fundamentals — /coins/{id}

The most comprehensive endpoint for a single coin — ATH/ATL, supply, volume, community data, and developer activity in one call.

Pro API
Demo API

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"

Coin Data →

curl -X GET \
  "https://api.coingecko.com/api/v3/coins/bitcoin?localization=false&tickers=false&community_data=true&developer_data=true" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Coin Data →

Key param	Use
`localization`	`false` to reduce response size
`tickers`	`false` if you don’t need exchange ticker data
`community_data`	Twitter followers, Reddit subscribers, Telegram members
`developer_data`	GitHub commits, stars, forks, contributors

Backtest with history — /coins/{id}/ohlc/range or /market_chart

OHLC candles for a custom date range, or price + volume + market cap time series.

OHLC candles for a custom range:

Pro API
Demo API

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"

OHLC Range →

/coins/{id}/ohlc/range is not available on the Demo API.
Upgrade to Pro →

Price + volume + market cap over time:

Pro API
Demo API

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"

Coin Market Chart →

curl -X GET \
  "https://api.coingecko.com/api/v3/coins/solana/market_chart?vs_currency=usd&days=365&interval=daily" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Coin Market Chart →

Onchain Research

Trending pools — /onchain/networks/trending_pools

Hottest liquidity pools across all networks — spot early DeFi momentum before it shows up in CoinGecko’s main listings.

Pro API
Demo API

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"

Trending Pools →

curl -X GET \
  "https://api.coingecko.com/api/v3/onchain/networks/trending_pools?include=base_token&duration=24h" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Trending Pools →

Key param	Use
`include`	`base_token`, `quote_token`, `dex`, `network` for richer context
`duration`	`1h`, `6h`, or `24h` trending window

Token fundamentals — /onchain/.../tokens/{address}/info

Metadata for any onchain token — description, socials, websites, and GeckoTerminal analytics score.

Pro API
Demo API

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"

Token Info →

curl -X GET \
  "https://api.coingecko.com/api/v3/onchain/networks/eth/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/info" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Token Info →

Combine with Pool OHLCV for a complete onchain research workflow — fundamentals from token info, price action from OHLCV.

Get Started

Guides

Resources

Set up your API key

Build faster with AI

Research Workflow

Onchain Research

Set up your API key

Build faster with AI

​Research Workflow

​Onchain Research

Research Workflow

Onchain Research