<aside> 👩‍💻 Last Updated: 15 Jan 2023

🚨🚨🚨 HEYO! 🚨🚨🚨 We’ve moved away to this new API Guidebook, please find the exclusive endpoint details here instead: https://apiguide.coingecko.com/exclusive-endpoints/for-paid-plan-subscribers

You will also find a lot more useful guides and details in the link above 🙂 We will no longer maintain and update the contents below.

</aside>

Read Me: Pro API keys & how to make Pro API calls
Exclusive endpoint overview

API Reference

nfts/markets [beta]

🖼️ 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

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

Example Request

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

Example Response

nfts:markets

[
	{
		"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}>