This endpoint returns NFT collection ranking statistics referring to NFTScan Ranking.
This endpoint returns NFT collection ranking statistics referring to NFTScan Ranking.
API Endpoint
https://open-platform.nodereal.io/{apiKey}/nftscan
method_path:/api/v2/statistics/ranking/collection/{chain_name}
method_type:GET
Request:
| Parameters | Descriptions | Query Type | Required | Data Type | schema |
|---|---|---|---|---|---|
| chain_name | Name of the chain you’re querying. List of supported values: "eth" for Ethereum; "bnb" for BNB Smart Chain; "polygon" for Polygon; "moonbeam" for Moonbeam; "arbitrum" for Arbitrum One; "optimism" for Optimism; "platon" for PlatON; "avalanche" for Avalanche; "cronos" for Cronos; "fantom" for Fantom; "gnosis" for Gnosis; | path | true | string | |
| sort_field | option{volume_1d,volume_7d,volume_30d,volume_total,volume_change_1d,volume_change_7d,volume_change_30d,sales_1d,sales_7d,sales_30d,sales_total,sales_change_1d,sales_change_7d,sales_change_30d,floor_price,market_cap} | query | false | string | |
| sort_direction | option{desc,asc} | query | false | string | |
| limit | Result size. Defaults to 20, capped at 100 | query | false | integer(int32) |
Response:
| Parameters | Descriptions | Data Type | schema |
|---|---|---|---|
| code | Response status code (200 means the request was successful, 4XX or 5XX means the request failed) | integer(int32) | integer(int32) |
| data | Response data | array | CollectionStatModel |
| average_price_1d | The average price for 1 day | number(bigdecimal) | |
| average_price_30d | The average price for 30 days | number(bigdecimal) | |
| average_price_7d | The average price for 7 days | number(bigdecimal) | |
| average_price_change_1d | The average price growth rate for 1 day | string | |
| average_price_change_30d | The average price growth rate for 30 days | string | |
| average_price_change_7d | The average price growth rate for 7 days | string | |
| average_price_total | The average price for total | number(bigdecimal) | |
| banner_url | The banner URL | string | |
| contract_address | The contract address | string | |
| contract_name | The contract name | string | |
| floor_price | The floor price or lowest price | number(bigdecimal) | |
| items_total | How many items for the collection | integer(int64) | |
| logo_url | The logo URL | string | |
| market_cap | The market cap | number(bigdecimal) | |
| owners_total | How many owners for the collection | integer(int64) | |
| sales_1d | How many sales for 1 day | integer(int64) | |
| sales_30d | How many sales for 30 days | integer(int64) | |
| sales_7d | How many sales for 7 days | integer(int64) | |
| sales_change_1d | The sale growth rate for 1 day | string | |
| sales_change_30d | The sale growth rate for 30 days | string | |
| sales_change_7d | The sale growth rate for 7 days | string | |
| sales_total | How many sales for total | integer(int64) | |
| volume_1d | The volume for 1 day | number(bigdecimal) | |
| volume_30d | The volume for 30 days | number(bigdecimal) | |
| volume_7d | The volume for 7 days | number(bigdecimal) | |
| volume_change_1d | The volume growth rate for 1 day | string | |
| volume_change_30d | The volume growth rate for 30 days | string | |
| volume_change_7d | The volume growth rate for 7 days | string | |
| volume_total | The total volume | number(bigdecimal) | |
| msg | Error message when request fails | string |
Example:
{
"code": 200,
"data": [
{
"average_price_1d": 1.13,
"average_price_30d": 1.13,
"average_price_7d": 1.13,
"average_price_change_1d": "120%",
"average_price_change_30d": "120%",
"average_price_change_7d": "120%",
"average_price_total": 1.13,
"banner_url": "https://lh3.googleusercontent.com/svc_rQkHVGf3aMI14v3pN-ZTI7uDRwN-QayvixX-nHSMZBgb1L1LReSg1-rXj4gNLJgAB0-yD8ERoT-Q2Gu4cy5AuSg-RdHF9bOxFDw=s2500",
"contract_address": "0x307135a29962f0b338c0103e06e8e7d03bd7267f",
"contract_name": "Doodles",
"floor_price": 1.113,
"items_total": 10000,
"logo_url": "https://logo.nftscan.com/logo/0x8a90cab2b38dba80c64b7734e58ee1db38b8992e.png",
"market_cap": 1.113,
"owners_total": 6271,
"sales_1d": 2,
"sales_30d": 20,
"sales_7d": 7,
"sales_change_1d": "70%",
"sales_change_30d": "10%",
"sales_change_7d": "110%",
"sales_total": 300,
"volume_1d": 4577.1396,
"volume_30d": 4577.1396,
"volume_7d": 4577.1396,
"volume_change_1d": "70%",
"volume_change_30d": "10%",
"volume_change_7d": "110%",
"volume_total": 4577.1396
}
],
"msg": ""
}