市场 API

获取热门合集#

该接口用于获取热门合集的交易数据。

请求地址#

GET https://www.okx.com/api/v5/mktplace/nft/runes/get-hot-collection

请求参数#

参数类型是否必传参数说明
timeTypeInteger返回 x 个项目的数据,并按照项目在对应时间范围内的交易额从高到低排序。 枚举值:1.24h 2.7d 3.30d 4.all 不传则默认 24h 交易额
cursorString查询列表分页游标,默认为空
limitInteger查询列表页大小,默认为 10

返回参数#

参数类型参数说明
cusorString游标,处理分页
runesIdStringruneid
nameString符文名称
spaceNameString加点后的符文名称
maxMintNumberString最多 mint 数量
mintedNumberString已铸造数量
limitPerMintString单笔 mint 上限
deployedTimeLong部署时间
startBlockString起始区块
endBlockString结束区块
symbolString符号
divisibilityInteger精度
collectionUrlStringOKX 合集链接
totalVolumeString时间范围内交易额,BTC 和美元分别计价
usdTotalVolumeString时间范围内交易额,USD 计价
marketCapString市值,BTC 计价
usdMarketCapString市值,USD 计价
floorpriceString地板价,Sats 计价
usdFloorPriceString地板价,USD 计价
holdersInteger持有地址数
salesCountInteger成交数量
volumeGainsString交易额涨幅

请求示例#

shell
curl --location 'https://www.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://www.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":""
}