Links

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 [email protected]
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.

/coins/list/new

🪙 Get the latest 200 coins (id & activated time) that recently listed on CoinGecko.com.
Example Request
https://pro-api.coingecko.com/api/v3/coins/list/new?&x_cg_pro_api_key={YOUR_KEY}
Example Response
new.json
17KB
Code
[
{
"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
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
top_gainers_losers.json
16KB
Code
{
"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.
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
global_market_cap_chart.json
251B
Code
{
"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
​
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
nfts_markets.json
95KB
Code
[
{
"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:
nfts_markets(param).json
249KB
Code
​

/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.
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
nfts_id_market_chart.json
5KB
Code
{
"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.
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 ag
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
nfts_id_contract_address_market_chart.json
5KB
Code
{
"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.
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
nft_{id}_tickers.json
373B
Code
{
"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)
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
exchange_{id}_volume_chart_range.json
1KB
Code
[
[ 1672617000000, "243150.80176188724454" ],
[ 1672703400000, "383998.4692726336780669" ],
[ 1672789800000, "442525.0216614451190183" ],
...
]
​
​