Get Runes Collection Information

This API retrieves detailed information about Runes collections, including holder count, collection links, trading volume, transaction count, and floor price.

Endpoint

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

Request Parameters

Parameter	Type	Required	Description
`runesId`	String	Yes	Comma-separated Runes IDs (e.g., `840000:3,840000:28` for batch queries).

Response Parameters

Parameter	Type	Description
`rune`	String	Rune name.
`spacename`	String	Punctuated rune name.
`maxMintNumber`	String	Maximum mintable quantity.
`mintedNumber`	String	Already minted quantity.
`limitPerMint`	String	Mint limit per transaction.
`deployedTime`	Long	Deployment timestamp.
`startBlock`	String	Starting block number.
`endBlock`	String	Ending block number.
`symbol`	String	Symbol abbreviation.
`divisibility`	Integer	Decimal precision.
`collectionUrl`	String	OKX collection page URL.
`totalVolume`	String	Total trading volume (BTC).
`usdTotalVolume`	String	Total trading volume (USD).
`marketCap`	String	Market capitalization (BTC).
`usdMarketCap`	String	Market capitalization (USD).
`floorprice`	String	Floor price (Sats).
`usdFloorPrice`	String	Floor price (USD).
`holders`	Integer	Number of holder addresses.
`salesCount`	Integer	Total transaction count.

👉 Explore Runes collections for real-time market insights.

Example Request

curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/runes/detail?runesId=840000:3,840000:28"

Example Response

{
  "rune": "EXAMPLE",
  "spacename": "EX•AM•PLE",
  "maxMintNumber": "21000",
  "mintedNumber": "18942",
  "limitPerMint": "1000",
  "deployedTime": 1710000000,
  "startBlock": "820000",
  "endBlock": "840000",
  "symbol": "EXM",
  "divisibility": 8,
  "collectionUrl": "https://www.okx.com/join/BLOCKSTARnft/runes/example",
  "totalVolume": "12.5",
  "usdTotalVolume": "750000",
  "marketCap": "25.8",
  "usdMarketCap": "1548000",
  "floorprice": "55000",
  "usdFloorPrice": "33",
  "holders": 1248,
  "salesCount": 8765
}

FAQs

What is a Runes collection?

Runes are blockchain-based digital assets with unique metadata, tradable as NFTs. Collections group them under shared traits or themes.

How often is the floor price updated?

Floor prices refresh in real-time based on the latest marketplace transactions.

Can I query multiple Runes IDs at once?

Yes! Separate IDs with commas (e.g., 840000:3,840000:28).

👉 Start trading Runes with low fees and high liquidity.