API Endpoint

https://open-platform.nodereal.io/{apiKey}/nftscan

method_path:/api/v2/collections/rankings/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	optionvolume_total,sales_total,average_price,floor_price,volume_1d,volume_7d,volume_change_1d,volume_change_7d,average_price_change_1d,average_price_change_7d	query	false	string
sort_direction	optiondesc,asc	query	false	string
limit	Result size. Defaults to 100, capped at 500	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	RankCollectionModel
amounts_total	How many amount for the collection	number(biginteger)
attributes	The attributes distribution of the collection	array	Attributes Model
attributes_name	The name of the attribute	string
attributes_values	The values for the attribute	array	AttributesValueVO
attributes_value	The value for the attribute name	string
total	How many items have this attribute value	integer
total	How many kind of value for the attribute name	integer
average_price	The average price	number(bigdecimal)
banner_url	The banner URL	string
collections_with_same_name	The contract address of collections with the same name	array	string
contract_address	The contract address	string
deploy_block_number	The block number when the contract was deployed	integer(int32)
description	The description	string
discord	The discord	string
email	The email	string
erc_type	The erc type of the collection	string
featured_url	The featured URL	string
floor_price	The floor price of the collection	number(double)
github	The github	string
instagram	The instagram	string
items_total	How many items for the collection	integer(int64)
large_image_url	The large image URL	string
logo_url	The logo URL	string
medium	The medium	string
name	The name	string
opensea_floor_price	The floor price of the collection on opensea	number(double)
opensea_verified	Whether the collection is verified on OpenSea	boolean
owner	The user address who owns the contract	string
owners_total	How many owners for the collection	integer(int64)
price_symbol	The floor price symbol of the collection	string
royalty	The royalty for the owner in basis point	integer(int32)
sales_total	The total sales	integer(int64)
symbol	The symbol	string
telegram	The telegram	string
twitter	The twitter	string
verified	Whether the collection is verified on NFTScan	boolean
volume_total	The total volume	number(bigdecimal)
website	The website	string
msg	Error message when request fails	string

Example:

{
	"code": 200,
	"data": [
		{
			"amounts_total": 15000,
			"attributes": [
				{
					"attributes_name": "Mouth",
					"attributes_values": [
						{
							"attributes_value": "Grin",
							"total": 700
						}
					],
					"total": 5
				}
			],
			"average_price": 37.94,
			"banner_url": "https://logo.nftscan.com/banner/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.png",
			"collections_with_same_name": [],
			"contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
			"deploy_block_number": 12292922,
			"description": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.",
			"discord": "https://discord.gg/3P5K3dzgdB",
			"email": "",
			"erc_type": "erc721",
			"featured_url": "https://lh3.googleusercontent.com/RBX3jwgykdaQO3rjTcKNf5OVwdukKO46oOAV3zZeiaMb8VER6cKxPDTdGZQdfWcDou75A8KtVZWM_fEnHG4d4q6Um8MeZIlw79BpWPA=s300",
			"floor_price": 1.113,
			"github": "",
			"instagram": "",
			"items_total": 10000,
			"large_image_url": "https://lh3.googleusercontent.com/RBX3jwgykdaQO3rjTcKNf5OVwdukKO46oOAV3zZeiaMb8VER6cKxPDTdGZQdfWcDou75A8KtVZWM_fEnHG4d4q6Um8MeZIlw79BpWPA=s300",
			"logo_url": "https://logo.nftscan.com/logo/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.png",
			"medium": "",
			"name": "BoredApeYachtClub",
			"opensea_floor_price": 91,
			"opensea_verified": true,
			"owner": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
			"owners_total": 6271,
			"price_symbol": "ETH",
			"royalty": 250,
			"sales_total": 638,
			"symbol": "BAYC",
			"telegram": "BoredApeYC",
			"twitter": "BoredApeYC",
			"verified": false,
			"volume_total": 4577.1396,
			"website": "http://www.boredapeyachtclub.com/"
		}
	],
	"msg": ""
}