获取 Ordinals 合集列表#

该接口用于获取全部 BTC NFT 和 Brc20 合集的列表，包括合集唯一标识 slug、铭文编号范围、交易额以及地板价。

请求地址#

GET https://www.okx.com/api/v5/mktplace/nft/ordinals/collections

请求参数#

参数	类型	必传	描述
slug	String	否	合集 slug 名称，即合集的唯一标识，参数不为空则代表查询指定合集
cursor	String	否	指向要检索的页面的游标
limit	String	否	分页大小（默认值 100，最大 300）。返回最大的合集数
isBrc20	Boolean	否	获取全部 BTC NFT 或 Brc20 合集的列表，默认为 Brc20

响应参数#

一个 Ordinals 合集模型的对象数组

参数	类型	描述
slug	String	合集 slug 名称，即合集的唯一标识
totalVolume	String	合集总交易额，BTC 计价
floorPrice	String	合集地板价，BTC 计价
inscriptionNumRange	String	合集铭文编号范围
volume24h	String	合集24小时交易额，BTC 计价
isBrc20	Boolean	用于区分 Ordinals 铭文类型：Brc20 或者 BTC NFT

请求示例#

shell

curl -X GET "https://www.okx.com/api/v5/mktplace/nft/ordinals/collections" \
  -H 'OK-ACCESS-KEY: XXX' \
  -H 'OK-ACCESS-TIMESTAMP: XXX' \
  -H 'OK-ACCESS-PASSPHRASE: XXX' \
  -H 'OK-ACCESS-SIGN: XXX' \
  -d "limit=1"

响应示例#

200

{
  "code": 0,
  "data": {
    "cursor": "",
    "data": [
      {
        "floorPrice": "0.00065",
        "inscriptionNumRange": "#10423123-#44607771",
        "isBrc20": false,
        "slug": "bitmap-4",
        "totalVolume": "3038.695704830937",
        "volume24h": "31.6151456383466366"
      }
    ]
  },
  "msg": ""
}