Collection 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
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": ""
}