Links
📔

Endpoint Overview

The full list of Public API endpoints are listed here: https://www.coingecko.com/en/api/documentation
Other exclusive endpoints for paid plan users are listed on the Exclusive Endpoints page.
If you're new to CoinGecko, you may want to learn more about our methodologies on how we aggregate and calculate these data: market data (price, trading volume, .. ), exchanges, trust score, and listings.

CoinGecko API is divided into the following top-level categories

Endpoint Category
Description
/simple/*
The simplest & fastest endpoints to call the latest price of crypto assets, by id or contract address.
/coins/*
Endpoints that return list of coins on CoinGecko, and their respective price, market data, historical data, and metadata (image, descriptions, links, followers, token supply info, etc). More exclusive endpoints are available to discover trending coins, newly added coins and more.
/contract/*
Works similarly as /coins/* endpoint above , except that it is queried by contract address, instead of api id.
/asset_platforms
To get the full list of blockchain network supported on CoinGecko.
/coins/categories/*
To get the full list of categories supported by CoinGecko & its market data, as seen on Categories page.
/nfts/*
Endpoints that return list of NFT collections on CoinGecko, and their respective floor price, market data, metadata, and historical data.
/exchanges/*
Endpoints that return list of exchanges on CoinGecko, and their respective market data, tickers (trading pairs), metadata, and historical data.
/derivatives/*
Endpoints that return list of derivative exchanges on CoinGecko, and their respective market data, tickers (trading pairs), and metadata.
/search/*
To get query search result of coins, categories and exchanges.
/search/trending/*
To get the current trending search coins on CoinGecko.
/global/*
To get global crypto data such as current and historical global market cap
/companies/*
To get public companies data such as BTC and ETH treasuries

Overview on interval granularity of historical data:

The data granularity (interval) for market_chart and market_chart/range endpoints is automatic and based on the date range:
  • 1 day from current time = 5-minutely data
  • 1 day from anytime (except from current time) = hourly data
  • 2-90 days from current time or anytime = hourly data
  • above 90 days from current time or anytime = daily data (00:00 UTC)
For ohlc endpoint, the data granularity is automatic and based on the date range:
  • 1-2 days from current time = 30-minutely data
  • 3-30 days from current time = 4-hourly data
  • above 31 days from current time = 4-daily data

For paid plan subscribers, you have the option to specify exclusive interval parameters to bypass auto granularity.

Text
Public
Analyst/Lite/Pro
Enterprise
coins/{id}/market_chart
  • auto
  • interval=daily
  • auto
  • interval=daily
  • auto
  • interval=daily
  • interval=hourly (100 days)
  • interval=5m (10 days)
coins/{id}/market_chart/range
  • auto
  • auto
  • interval=daily
  • auto
  • interval=daily
  • interval=hourly (100 days)
  • interval=5m (10 days)
coins/{id}/ohlc
  • auto
  • auto
  • interval=daily (180 days)
  • auto
  • interval=daily (180 days)