Marketplace API
Get Popular collections

Get Popular collections#

This API is used to get trading data of popular collections.

Request address#

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

Request param#

ParameterTypeRequiredDescription
timeTypeIntegerNoReturns data for N projects, sorted by transaction volume in the specified time range. Enum values: 1. 24h 2. 7d 3. 30d 4. all Defaults to 24h if not provided.
cursorStringNoCursor for pagination, default is empty.
limitIntegerNoPage size for query results, default is 10.

Response parameters#

ParameterTypeDescription
cusorStringCursor for pagination
runesIdStringruneid
nameStringRune name
spaceNameStringRune name with dots
maxMintNumberStringMaximum mint number
mintedNumberStringMinted number
limitPerMintStringLimit per mint
deployedTimeLongDeployment time
startBlockStringStart block
endBlockStringEnd block
symbolStringSymbol
divisibilityIntegerPrecision
collectionUrlStringOKX collection link
totalVolumeStringTransaction volume in BTC and USD
usdTotalVolumeStringTransaction volume in USD
marketCapStringMarket cap in BTC
usdMarketCapStringMarket cap in USD
floorpriceStringFloor price in Sats
usdFloorPriceStringFloor price in USD
holdersIntegerNumber of holders
salesCountIntegerNumber of sales
volumeGainsStringTransaction volume growth

Request example#

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' \

Response example#

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