Marketplace API

Get Runes collection#

This API is used to get runes information, including the number of holders, collection link, transaction volume, number of transactions, and floor price.

Request address#

GET https://www.okx.com/api/v5/mktplace/nft/runes/detail

Request param#

ParameterTypeRequiredDescription
runesIdStringYesrunesId, supports batch queries, separated by ',', e.g., 840000:3,840000:28

Response param#

ParameterTypeDescription
runesIdStringruneid
nameStringName of the rune
spacenameStringRune name with dots
maxMintNumberStringMaximum mint number
mintedNumberStringMinted number
limitPerMintStringLimit per mint
deployedTimeLongDeployment time
startBlockStringStart block
endBlockStringEnd block
symbolStringSymbol
divisibilityIntegerPrecision
collectionUrlStringOKX collection link
totalVolumeStringTotal volume in BTC
usdTotalVolumeStringTotal 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

Request example#

shell
curl --location 'https://www.okx.com/api/v5/mktplace/nft/runes/detail?runesId=840000%3A3%2C840000%3A28' \
--header 'OK-ACCESS-PASSPHRASE: xxx' \
--header 'OK-ACCESS-KEY: xxx' \

Response example#

200
{
  "code": 0,
  "data": [
{
  "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": "🐕"
}
  ],
  "msg": ""
}