for Paid Plan subscribers

Exclusive endpoints for all paid plans: Analyst, Lite, Pro, Enterprise

Please note that the endpoints below are still in beta and might have changes in the future. Please also share your feedback with us via [e-mail]

Endpoint [beta]	Description
/coins/list/new	🪙 Get the latest 200 coins (id) that recently listed on CoinGecko.com
/coins/top_gainers_losers	🔺 get the top 30 coins with largest price gain and loss within a specific time duration.
/global/market_cap_chart	📈 Get historical global market cap and volume data, by number of days away from now.
/nfts/markets	🖼️ Get the list of all supported NFT floor price, market cap, volume and market related data on CoinGecko
/nfts/{id}/market_chart	📈 Get historical market data of a NFT collection, including floor price, market cap, and 24h volume, by number of days away from now.
/nfts/{asset_platform_id}/contract/{contract_address}/market_chart	📈 Get historical market data of a NFT collection using contract address, including floor price, market cap, and 24h volume, by number of days away from now.
/nfts/{id}/tickers	🖼️ Get the latest floor price and 24h volume of a NFT collection, on each NFT marketplace, e.g. OpenSea and Looksrare.
/exchange/{exchange_id}/volume_chart/range	📈 Get historical volume data of an exchange, by specifying a date range.
Exclusive daily interval param for /coins/{id}/ohlc	📈 Get OHLC data of a coin, by number of days away from now.

/coins/list/new

🪙 Get the latest 200 coins (id & activated time) that recently listed on CoinGecko.com.

• CoinGecko equivalent page: https://www.coingecko.com/en/new-cryptocurrencies

• Update frequency: 30 sec

• Tips: if you're looking to get the latest coins listed on CoinGecko, this is the best endpoint to do the job.

Example Request

https://pro-api.coingecko.com/api/v3/coins/list/new?&x_cg_pro_api_key={YOUR_KEY}

Example Response

17KB

new.json

[
  {
     "id": "texan",
     "symbol": "texan",
      "name": "Texan",
      "activated_at": 1673690316
  }, ....

/coins/top_gainers_losers

📈 get the top 30 coins with largest price gain and loss by a specific time duration

• CoinGecko equivalent page: https://www.coingecko.com/en/crypto-gainers-losers

• Update Frequency: 5 minutes

• Note: only coins with at least $50,000 24hour trading volume will be included

Paramaters	Values	Remarks
vs_currency *required: filter result by currency	Valid values: usd, jpy, krw, eur, ..	View full list of currency via support vs currencies endpoint.
duration: filter result by the time range, from 1 hour up to 1 year	Valid values: 1h 24h 7d 14d 30d 60d 1y	Default value: 24h
top_coins: filter result by MarketCap ranking (top 300 to 1000), or all coins (including coins that do not have MarketCap ranking)	Valid values: 300 500 1000 all	Default value: 1000

Example Request

https://pro-api.coingecko.com/api/v3/coins/top_gainers_losers?vs_currency=usd&duration=1h&top_coins=300&x_cg_pro_api_key={YOUR_KEY}

Example Response

16KB

top_gainers_losers.json

{
  "top_gainers": [
    {
      "id": "fuc",
      "symbol": "fuc",
      "name": "FUBT Token",
      "image": "https://assets.coingecko.com/coins/images/8132/original/FUC_fubt_token.png?1555325050",
      "market_cap_rank": 245,
      "usd": 1.4820952731507908,
      "usd_24h_vol": 213343.65423003546,
      "usd_24h_change": 34.08570907794165
    },
    ...
  ],
  "top_losers": [
    {  
      "id": "space-id",
      "symbol": "id",
      "name": "SPACE ID",
      "image": "https://assets.coingecko.com/coins/images/29468/original/sid_token_logo_%28green2%29.png?1679454702",
      "market_cap_rank": 216,
      "usd": 0.5398050441850678,
      "usd_24h_vol": 592030891.3057652,
      "usd_24h_change": -41.0126355910758
    },
    ...
  ]
}

/global/market_cap_chart

📈 Get historical global market cap and volume data, by number of days away from now.

• CoinGecko equivalent page: https://www.coingecko.com/en/global-charts

• Plan Eligibility: Analyst, Lite, Pro, Enterprise

• Data Granularity (auto):

  • 1 day from now = hourly data

  • 2 days & above from now = daily data (00:00 UTC)

• Update Frequency: 60 minutes

Paramaters	Values	Remarks
days *required: data up to number of days ago	Valid values: any integer e.g. 1, 14, 30 , … or max	days parameter must be specified.
vs_currency: filter result by currency	Valid values: jpy, krw, eur, ..	Default value: usd View full list of currency via support vs currencies endpoint.

Example Request

https://pro-api.coingecko.com/api/v3/global/market_cap_chart?days=2&x_cg_pro_api_key={YOUR_KEY}

Example Response

251B

global_market_cap_chart.json

{
  "market_cap_chart": {
    "market_cap": [
      [
        1666137600000,
        966408688449.8091
      ],
      [
        1666224000000,
        952627682841.667
      ],
      [
        1666310400000,
        948870473181.127
      ]
    ],
    "volume": [
      [
        1666137600000,
        54276746009.72646
      ],
      [
        1666224000000,
        51224236590.94324
      ],
      [
        1666310400000,
        52896988973.930435
      ]
    ]
  }
}

Example Request (with currency parameter)

https://pro-api.coingecko.com/api/v3/global/market_cap_chart?days=2&vs_currency=jpy&x_cg_pro_api_key={YOUR_KEY}

/nfts/markets

🖼️ Get the list of all supported NFT floor price, market cap, volume and market related data on CoinGecko

• CoinGecko equivalent page: https://www.coingecko.com/en/nft

• Plan Eligibility: Analyst, Lite, Pro, Enterprise

• Tips:

  • Other nfts endpoints are also available on our Free API documentation page.

  • By default, this endpoint will return 100 results per page and only 1 page.

  • To get the number 251-500 NFTs ranked by 24hr volume as seen on CoinGecko NFT page , you may include these parameters: per_page=250, page=2 and order=h24_volume_usd_desc

• Update Frequency: 5 minutes

Parameter	Values	Remarks
asset_platform_id: filter result by asset platform (blockchain network)	Valid values: ◦ ethereum ◦ avalanche ◦ polygon-pos ◦ arbitrum-one ◦ optimistic-ethereum ◦ klay-token	You may get the asset platform id via asset_platforms (filter=nft) endpoint. Please visit https://www.coingecko.com/en/nft to view latest available networks.
order: sort results by field	Valid values: ◦ h24_volume_native_asc ◦ h24_volume_native_desc ◦ h24_volume_usd_asc ◦ h24_volume_usd_desc ◦ market_cap_usd_asc ◦ market_cap_usd_desc	Default order: market_cap_usd_desc
per_page: total results per page	Valid values: 1..250	Default value: 100 Max value is 250 You can only get up to 250 results per page.
page: page through results	Valid values: any integer e.g. 1, 2, 10, …	Default value: 1

Example Request

https://pro-api.coingecko.com/api/v3/nfts/markets?x_cg_pro_api_key={YOUR_KEY}

Example Response

95KB

nfts_markets.json

[
	{
		"id": "archeworld_land",
		"contract_address": "0x56d23f924cd526e5590ed94193a892e913e38079",
		"asset_platform_id": "klay-token",
		"name": "ArcheWorld_Land",
		"image": {
		"small": "https://assets.coingecko.com/nft_contracts/images/1688/small/archeworld_land.png?1663925175"
		},
		"description": "This is the official Land NFT of ArcheWorld.\nThis verifies that the Land NFT owner can permanently own the land designated on seamless open-world of ArcheWorld.\nOwners can participate in production activities directly by installing buildings in the game, or they can lease their land to others and collect rent with Blue Salt(BSLT) every month.\nOwners may generate earnings by converting Blue Salt(BSLT) to BORA.",
		"native_currency": "klay-token",
		"floor_price": {
				"native_currency": 2105.79,
				"usd": 396.33
		},
		"market_cap": {
				"native_currency": 4358977,
				"usd": 820409
		},
		"volume_24h": {
				"native_currency": 74533,
				"usd": 14028.03
		},
		"floor_price_in_usd_24h_percentage_change": -5.24342,
		"number_of_unique_addresses": 694,
		"number_of_unique_addresses_24h_percentage_change": -0.57307,
		"total_supply": 2070
	} ...

Example Request (with parameters)

https://pro-api.coingecko.com/api/v3/nfts/markets?asset_platform_id=ethereum&order=h24_volume_native_desc&per_page=250&page=1&x_cg_pro_api_key={YOUR_KEY}

Example Response:

249KB

nfts_markets(param).json

/nfts/{id}/market_chart

📈 Get historical market data of a NFT collection, including floor price, market cap, and 24h volume, by number of days away from now.

• CoinGecko equivalent page: our NFT price floor chart, e.g. as seen on https://www.coingecko.com/en/nft/bored-ape-yacht-club

• Plan Eligibility: Analyst, Lite, Pro, Enterprise

• Data Granularity (auto):

  • 1-14 days from now = 10-minutely data

  • 15 days & above from now = daily data (00:00 UTC)

• Update Frequency: 5 minutes. The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05).

Paramaters	Values	Remarks
id: id of NFT collection	Valid values: ◦ cryptopunks ◦ bored-ape-yacht-club ◦ …	Please get the full list of NFT collection id via nfts/list endpoint. You may visit https://www.coingecko.com/en/nft to view NFT collections & marketplaces that are listed on CoinGecko. More to come!
days *required: data up to number of days ago	Valid values: any integer, e.g. 1, 14, 30 , 90 , … or max	days parameter must be specified.

Example Request

https://pro-api.coingecko.com/api/v3/nfts/cryptopunks/market_chart?days=30&x_cg_pro_api_key={YOUR_KEY}

Example Response

5KB

nfts_id_market_chart.json

{
  "floor_price_usd": [[1669261807000,79369.42372126045], ...],	
  "floor_price_native": [[1666829111000,65.95], ... ],
  "h24_volume_usd": [[1666829111000,1462956.0082642469], ...],
  "h24_volume_native": [[1666829111000,933.35], ...],
  "market_cap_usd": [[1666829111000,1033509962.5572194], ...],
  "market_cap_native": [[1666829111000,659368.1], ...],
}

/nfts/{asset_platform_id}/contract/{contract_address}/market_chart

📈 Get historical market data of a NFT collection using contract address, including floor price, market cap, and 24h volume, by number of days away from now.

• CoinGecko equivalent page: our NFT price floor chart, e.g. as seen on https://www.coingecko.com/en/nft/bored-ape-yacht-club

• Plan Eligibility: Analyst, Lite, Pro, Enterprise

• Data Granularity (auto):

  • 1-14 days from now = 10-minutely data

  • 15 days & above from now = daily data (00:00 UTC)

• Update Frequency: 5 minutes. The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05).

• Tips: this endpoint doesn't support Solana NFT and Art Blocks, please use nfts/{id}/market_chart endpoint instead.

Paramaters	Values	Remarks
{asset_platform_id}: id of asset platform (blockchain network) note: this is path to pass the blockchain network, not query parameter.	Valid values: ◦ ethereum ◦ avalanche ◦ polygon-pos ◦ arbitrum-one ◦ optimistic-ethereum ◦ klay-token	You may get the asset platform id via asset_platforms (filter=nft) endpoint. Please visit https://www.coingecko.com/en/nft to view latest available networks.
{contract_address}: contract address of the NFT collection note: this is path to pass the coin id, not query parameter.	Valid values: ◦0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d ◦0x56d23f924cd526e5590ed94193a892e913e38079 ◦ …	You may also obtain the contract address via nfts/{id} endpoint.
days *required: data up to number of days ago.	Valid values: any integer, e.g. 1, 14, 30 , 90 , … or max	days parameter must be specified.

Example Request

https://pro-api.coingecko.com/api/v3/nfts/ethereum/contract/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d/market_chart?days=30&x_cg_pro_api_key={YOUR_KEY}

Example Response

5KB

nfts_id_contract_address_market_chart.json

{
  "floor_price_usd": [[1669261807000,79369.42372126045], ...],
  "floor_price_native": [[1666829111000,65.95], ... ],
  "h24_volume_usd": [[1666829111000,1462956.0082642469], ...],
  "h24_volume_native": [[1666829111000,933.35], ...],
  "market_cap_usd": [[1666829111000,1033509962.5572194], ...],
  "market_cap_native": [[1666829111000,659368.1], ...],
}

/nfts/{id}/tickers

🖼️ Get the latest floor price and 24h volume of a NFT collection, on each NFT marketplace, e.g. OpenSea and Looksrare.

• CoinGecko equivalent page: https://www.coingecko.com/en/nft/otherdeed-for-otherside (table)

• Plan Eligibility: Analyst, Lite, Pro, Enterprise

• Tips: Other nfts endpoints are also available on our Free API documentation page.

• Update Frequency: 30 seconds

Parameter	Values	Remarks
id: id of NFT collection	Valid values: ◦ cryptopunks ◦ bored-ape-yacht-club ◦ …	Please get the full list of NFT collection id via nfts/list endpoint. You may visit https://www.coingecko.com/en/nft to view NFT collections & marketplaces that are listed on CoinGecko. More to come!

Example Request

https://pro-api.coingecko.com/api/v3/nfts/otherdeed-for-otherside/tickers?x_cg_pro_api_key={YOUR_KEY}

Example Response

373B

nft_{id}_tickers.json

{
  "tickers": 
    [
      {
	"floor_price_in_native_currency": 1.25,
	"h24_volume_in_native_currency": 205.51,
	"native_currency": "ethereum",
	"updated_at": "2022-10-28T06:31:42.529Z",
	"nft_marketplace_id": "opensea"
      },
      {
	"floor_price_in_native_currency": 1.22,
	"h24_volume_in_native_currency": 230.41,
	"native_currency": "ethereum",
	"updated_at": "2022-10-28T06:31:42.783Z",
	"nft_marketplace_id": "looksrare"
      }
    ]
}

/exchanges/{id}/volume_chart/range

📈 Get historical volume data (in BTC) of an exchange, by specifying a date range (up to 31 days per call)

• CoinGecko equivalent page: https://www.coingecko.com/en/exchanges/binance#statistics (Exchange Trade Volume chart)

• Plan Eligibility: Analyst, Lite, Pro, Enterprise

• Update Frequency: 5 minutes

• Note:

  • you can query the full historical volume of an exchange with this endpoint, the data interval will be daily.

  • the date range (between 'from' and 'to) has to be within 31 days.

Parameter	Values	Remarks
id *required: this is path to pass the exchange id, not query parameter.	Valid values: ◦ binance ◦ uniswap_v3 ◦ …	Please get the full list of Exchange id via exchanges endpoint.
from *required: from date in UNIX Timestamp	Valid values: UNIX timestamp e.g. 1672531200	You may convert human readable date to UNIX timestamp using tools like https://www.epochconverter.com/
to *required: to date in UNIX Timestamp	Valid values: UNIX timestamp e.g. 1675123200	You may convert human readable date to UNIX timestamp using tools like https://www.epochconverter.com/

Example Request

https://pro-api.coingecko.com/api/v3/exchanges/binance/volume_chart/range?from=1673222400&to=1675814400&x_cg_pro_api_key={YOUR_KEY}

Example Response

1KB

exchange_{id}_volume_chart_range.json

[ 
    [ 1672617000000, "243150.80176188724454" ], 
    [ 1672703400000, "383998.4692726336780669" ], 
    [ 1672789800000, "442525.0216614451190183" ],
    ...
]

/coins/{id}/ohlc

📈 Get coin historical market data including price, market cap, and 24h volume, by number of days away from now.

Paramaters	Values	Remarks
{id} *required: this is path to pass the coin id, not query parameter.	Valid values: any coin id e.g. bitcoin , …	To get full list of Coin id, please visit /coins/list endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko coin page.
days *required: data up to number of days ago	Valid values: 1, 7, 14, 30, 90, 180, 365, max	days parameter must be specified in call request.
interval: data interval	Valid values: daily	if interval is not specified, auto data granularity will apply.

🔐 Exclusive for paid plan subscribers: daily interval parameter.

• To get daily candle, you should use interval=daily parameter.

  • Limit of days (when interval=daily is used): up to 180 days from today.

Example Request

https://pro-api.coingecko.com/api/v3/coins/bitcoin/ohlc?vs_currency=usd&days=30&interval=daily&x_cg_pro_api_key={YOUR_KEY}

Example Response

[
  [
    1683417600000,
    28888,
    28888,
    28888,
    28888
  ], 
    ...
]

Note:

• This endpoint may experience some stability issue and may be some missing data. Please share your feedback with us. We appreciate your patience and understanding as we continue to make new improvements to CoinGecko API to serve you better.

• If you need to get historical data with better interval granularity, please use /coins/{id}/market_chart endpoints.