Skip to main content

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

1

Macro overview — /global

Total market cap, BTC dominance, volume, and active coins. Frame your research in the context of overall market conditions.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/global" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Global Data →
The market_cap_percentage field gives BTC and ETH dominance — a key signal for market rotation.
2

Spot momentum — /search/trending

Coins, NFTs, and categories trending in CoinGecko search over the last 24 hours.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/search/trending" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Trending Search →
3

Top movers — /coins/top_gainers_losers

Top 30 coins with the largest price gains and losses — spot breakout or breakdown opportunities.
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 →
Key paramUse
duration1h, 24h, 7d, 14d, 30d, 60d, 1y
4

Analyze sectors — /coins/categories

Category-level market cap, volume, and 24h change. Identify which sectors are leading or lagging.
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 →
Combine with /coins/markets?category=layer-1 to drill into individual coins within a strong sector.
5

Screen candidates — /coins/markets

Bulk market data for up to 250 coins per page — rankings, sparklines, and multi-timeframe changes.
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 →
Key paramUse
ordermarket_cap_desc, volume_desc, market_cap_asc
categoryFilter to a specific sector (e.g. layer-1, decentralized-finance-defi)
sparkline7-day sparkline data for quick visual scanning
price_change_percentage1h,24h,7d,30d for multi-timeframe momentum
6

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.
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 →
Key paramUse
localizationfalse to reduce response size
tickersfalse if you don’t need exchange ticker data
community_dataTwitter followers, Reddit subscribers, Telegram members
developer_dataGitHub commits, stars, forks, contributors
7

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:
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 →
  • Price + volume + market cap over time:
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 →

​
Onchain Research

1

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.
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 →
Key paramUse
includebase_token, quote_token, dex, network for richer context
duration1h, 6h, or 24h trending window
2

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

Metadata for any onchain token — description, socials, websites, and GeckoTerminal analytics score.
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 →
Combine with Pool OHLCV for a complete onchain research workflow — fundamentals from token info, price action from OHLCV.