获取热门合集#
该接口用于获取热门合集的交易数据。
请求地址#
GET https://web3.okx.com/api/v5/mktplace/nft/runes/get-hot-collection
请求参数#
| 参数 | 类型 | 是否必传 | 参数说明 |
|---|---|---|---|
| timeType | Integer | 否 | 返回 x 个项目的数据，并按照项目在对应时间范围内的交易额从高到低排序。 枚举值：1.24h 2.7d 3.30d 4.all 不传则默认 24h 交易额 |
| cursor | String | 否 | 查询列表分页游标，默认为空 |
| limit | Integer | 否 | 查询列表页大小，默认为 10 |
返回参数#
| 参数 | 类型 | 参数说明 |
|---|---|---|
| cusor | String | 游标，处理分页 |
| runesId | String | runeid |
| name | String | 符文名称 |
| spaceName | String | 加点后的符文名称 |
| maxMintNumber | String | 最多 mint 数量 |
| mintedNumber | String | 已铸造数量 |
| limitPerMint | String | 单笔 mint 上限 |
| deployedTime | Long | 部署时间 |
| startBlock | String | 起始区块 |
| endBlock | String | 结束区块 |
| symbol | String | 符号 |
| divisibility | Integer | 精度 |
| collectionUrl | String | OKX 合集链接 |
| totalVolume | String | 时间范围内交易额，BTC 和美元分别计价 |
| usdTotalVolume | String | 时间范围内交易额，USD 计价 |
| marketCap | String | 市值，BTC 计价 |
| usdMarketCap | String | 市值，USD 计价 |
| floorprice | String | 地板价，Sats 计价 |
| usdFloorPrice | String | 地板价，USD 计价 |
| holders | Integer | 持有地址数 |
| salesCount | Integer | 成交数量 |
| volumeGains | String | 交易额涨幅 |
请求示例#
shell
curl --location 'https://web3.okx.com/api/v5/mktplace/nft/runes/get-hot-collection?timeType=2&cursor=Mg%3D%3D' \
--header 'OK-ACCESS-PASSPHRASE: xxxxxx' \
--header 'OK-ACCESS-KEY: xxxx' \
返回示例#
200
{
"code":0,
"data":{
"items":[
{
"collectionUrl":"https://web3.okx.com/web3/marketplace/runes/token/DOG•GO•TO•THE•MOON/840000:3",
"deployedTime":1713571767,
"divisibility":5,
"marketData":{
"floorPrice":"10.6509577683",
"holders":72903,
"marketCap":"10651.030343051788712385",
"salesCount":35436,
"totalVolume":"1124.64783456999999",
"usdFloorPrice":"0.006598097922137557",
"usdMarketCap":"659814288.103509427870310934",
"usdTotalVolume":"69670133.915076187380516"
},
"maxMintNumber":"100000000000",
"mintedNumber":"100000000000",
"name":"DOG•GO•TO•THE•MOON",
"runesId":"840000:3",
"spaceName":"DOGGOTOTHEMOON",
"startBlock":840000,
"symbol":"🐕"
}
],
"cursor":""
},
"msg":""
}