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. |
Exclusive daily interval param for /coins/{id}/ohlc | 📈 Get OHLC data of a coin, by number of days away from now. |
🪙 Get the latest 200 coins (id & activated time) that recently listed on CoinGecko.com.
- 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
new.json
17KB
Code
[
{
"id": "texan",
"symbol": "texan",
"name": "Texan",
"activated_at": 1673690316
}, ....
📈 get the top 30 coins with largest price gain and loss by a specific time duration
- 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 , .. | |
duration :
filter result by the time range, from 1 hour up to 1 year | Valid values:
| 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:
| 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
},
...
]
}
📈 Get historical global market cap and volume data, by number of days away from now.
- 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 , .. |
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}
🖼️ Get the list of all supported NFT floor price, market cap, volume and market related data on CoinGecko
- Tips:
- 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 | |
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
📈 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