This endpoint returns NFT trade ranking statistics referring to NFTScan Trading.
This endpoint returns NFT trade ranking statistics referring to NFTScan Trading.
API Endpoint
https://open-platform.nodereal.io/{apiKey}/nftscan
method_path:/api/v2/statistics/ranking/trade/{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 | |
| time | option{1d,15m,30m,1h,6h,12h} | query | false | string | |
| sort_field | option{volume,sales} | query | false | string | |
| sort_direction | option{desc,asc} | query | false | string | |
| show_7d_trends | Whether to obtain 7-day trend data of the collections.option{false,true} | query | false | boolean |
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 | TopTrendingDataModel |
| amounts_total | How many amount for the collection | number(biginteger) | |
| average_price | The average price | number(double) | |
| average_price_change | The average price growth rate | string | |
| contract_address | The contract address | string | |
| contract_name | The contract name | string | |
| exchange_volume_change_24h | The 24-hour trading volume growth rate | string | |
| exchange_volume_change_7d | The 7-day trading volume growth rate | string | |
| floor_price | The floor price | number(double) | |
| highest_price | The highest price | number(double) | |
| items_total | How many items for the collection | integer(int64) | |
| logo_url | The logo URL | string | |
| lowest_price | The lowest price | number(double) | |
| market_cap | The market cap | number(bigdecimal) | |
| market_trend | The market cap growth rate | string | |
| mint_average_price | The average mint price | number(bigdecimal) | |
| mint_gas_fee | The total mint gas fee | number(bigdecimal) | |
| mint_price_total | The total mint price | number(bigdecimal) | |
| owners_total | How many owners for the collection | integer(int64) | |
| price_7d | The 7-day trading price trends | array | TopTrendingPriceModel |
| average_price | The average price | number | |
| begin_timestamp | The beginning timestamp in milliseconds for the interval | integer | |
| end_timestamp | The ending timestamp in milliseconds for the interval | integer | |
| sales | How many sales | integer(int32) | |
| sales_change | The sale growth rate | string | |
| volume | The volume | number(double) | |
| volume_7d | The 7-day trading volume trends | array | TopTrendingVolumeModel |
| begin_timestamp | The beginning timestamp in milliseconds for the interval | integer | |
| end_timestamp | The ending timestamp in milliseconds for the interval | integer | |
| volume | The volume | number | |
| volume_change | The volume growth rate | string | |
| msg | Error message when request fails | string |
Example:
{
"code": 200,
"data": [
{
"amounts_total": 15000,
"average_price": 1.13,
"average_price_change": "120%",
"contract_address": "0x307135a29962f0b338c0103e06e8e7d03bd7267f",
"contract_name": "Doodles",
"exchange_volume_change_24h": "70%",
"exchange_volume_change_7d": "110%",
"floor_price": 1.12,
"highest_price": 20,
"items_total": 10000,
"logo_url": "https://logo.nftscan.com/logo/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.png",
"lowest_price": 1.113,
"market_cap": 55288,
"market_trend": "80.00%",
"mint_average_price": 2,
"mint_gas_fee": 10,
"mint_price_total": 200,
"owners_total": 6271,
"price_7d": "[{\"average_price\":11.0075,\"begin_timestamp\":1659456000000,\"end_timestamp\":1659542400000},{\"average_price\":10.6329,\"begin_timestamp\":1659542400000,\"end_timestamp\":1659628800000},{\"average_price\":9.3088,\"begin_timestamp\":1659628800000,\"end_timestamp\":1659715200000},{\"average_price\":10.479,\"begin_timestamp\":1659715200000,\"end_timestamp\":1659801600000},{\"average_price\":9.3563,\"begin_timestamp\":1659801600000,\"end_timestamp\":1659888000000},{\"average_price\":9.5292,\"begin_timestamp\":1659888000000,\"end_timestamp\":1659974400000},{\"average_price\":9.1175,\"begin_timestamp\":1659974400000,\"end_timestamp\":1660060800000}]",
"sales": 20,
"sales_change": "10%",
"volume": 4577.1396,
"volume_7d": "[{\"begin_timestamp\":1659456000000,\"end_timestamp\":1659542400000,\"volume\":44.03},{\"begin_timestamp\":1659542400000,\"end_timestamp\":1659628800000,\"volume\":74.43},{\"begin_timestamp\":1659628800000,\"end_timestamp\":1659715200000,\"volume\":83.779},{\"begin_timestamp\":1659715200000,\"end_timestamp\":1659801600000,\"volume\":146.706},{\"begin_timestamp\":1659801600000,\"end_timestamp\":1659888000000,\"volume\":74.85},{\"begin_timestamp\":1659888000000,\"end_timestamp\":1659974400000,\"volume\":114.35},{\"begin_timestamp\":1659974400000,\"end_timestamp\":1660060800000,\"volume\":36.47}]",
"volume_change": "53%"
}
],
"msg": ""
}