NFTs Collection Historical Chart Data by Contract Address
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/nfts/{asset_platform_id}/contract/{contract_address}/market_chart \
--header 'x-cg-pro-api-key: <api-key>'{
"floor_price_usd": [
[
1779729001000,
10032.419904380335
],
[
1779729303000,
10028.703755252538
]
],
"floor_price_native": [
[
1779729001000,
4.69989940999941
],
[
1779729303000,
4.69989940999941
]
],
"h24_volume_usd": [
[
1779729001000,
60835.49928667799
],
[
1779729303000,
60812.96496397539
]
],
"h24_volume_native": [
[
1779729001000,
28.49967703999703
],
[
1779729303000,
28.49967703999703
]
],
"market_cap_usd": [
[
1779729001000,
89168148.1101324
],
[
1779729303000,
89135118.97668457
]
],
"market_cap_native": [
[
1779729001000,
41772.70595607475
],
[
1779729303000,
41772.70595607475
]
]
}NFTs Collection Historical Chart Data by Contract Address
To query historical market data of a NFT collection, including floor price, market cap, and 24hr volume, by number of days away from now based on the provided contract address
GET
/
nfts
/
{asset_platform_id}
/
contract
/
{contract_address}
/
market_chart
NFTs Collection Historical Chart Data by Contract Address
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/nfts/{asset_platform_id}/contract/{contract_address}/market_chart \
--header 'x-cg-pro-api-key: <api-key>'{
"floor_price_usd": [
[
1779729001000,
10032.419904380335
],
[
1779729303000,
10028.703755252538
]
],
"floor_price_native": [
[
1779729001000,
4.69989940999941
],
[
1779729303000,
4.69989940999941
]
],
"h24_volume_usd": [
[
1779729001000,
60835.49928667799
],
[
1779729303000,
60812.96496397539
]
],
"h24_volume_native": [
[
1779729001000,
28.49967703999703
],
[
1779729303000,
28.49967703999703
]
],
"market_cap_usd": [
[
1779729001000,
89168148.1101324
],
[
1779729303000,
89135118.97668457
]
],
"market_cap_native": [
[
1779729001000,
41772.70595607475
],
[
1779729303000,
41772.70595607475
]
]
}Notes
- Auto-granularity:
- 1–14 days = 5-minutely data
- 15 days and above = daily data (00:00 UTC)
Solana NFTs and Art Blocks are not supported. Use NFTs Collection Historical Chart Data by ID instead.
The last completed UTC day (00:00) is available after 00:35 UTC the next day.
SDK Examples
New to the SDK? Install and authenticate theclient first:TypeScript | Python
const response = await client.nfts.contract.marketChart.get('0xBd3531dA5CF5857e7CfAA92426877b022e612cf8', {
asset_platform_id: 'ethereum',
days: '1',
});
console.log(JSON.stringify(response, null, 2));
response = client.nfts.contract.market_chart.get(
"0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
asset_platform_id="ethereum",
days="1",
)
print(response.model_dump_json(indent=2))
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Path Parameters
Asset platform ID.
*refers to /asset_platforms.
Query Parameters
Response
200 - application/json
NFT collection historical chart data
Was this page helpful?

