获取 Ordinals 订单#

该接口用于返回指定合集下所有有效订单。

请求地址#

POST https://www.okx.com/api/v5/mktplace/nft/ordinals/listings

请求参数#

参数	类型	必传	描述
slug	String	否	合集 slug 名称，即合集的唯一标识
cursor	String	否	指向要检索的页面的游标
limit	String	否	分页大小（默认值 10，最大 100）。返回最大的订单数
sort	String	否	挂单排序规则： `listing_time_desc`：订单创建时间最新的在前 `listing_time_asc`：订单创建时间最早的在前 `price_desc`：价格最高的在前 `price_asc`：价格最低的在前 `unit_price_desc`：单价最高的在前 `unit_price_asc`：单价最低的在前。默认排序为订单创建时间最新的在前。
isBrc20	Boolean	否	获取全部 BTC NFT 或 Brc20 合集的订单，默认为 Brc20

响应参数#

一个 Ordinals 订单模型的对象数组

参数	类型	描述
inscriptionId	String	铭文编号
listingTime	Long	挂单时间
listingUrl	String	订单所在页面链接
ownerAddress	String	订单所有者
price	String	订单价格，BTC 计价
unitPrice	String	订单单价，BTC 计价
amount	String	订单中的铭文数量
isBrc20	Boolean	用于区分 Ordinals 铭文类型：Brc20 或者 BTC NFT

请求示例#

shell

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

响应示例#

200

{
    "code": 0,
    "data": {
        "cursor": "MC4wOjMxNDIwNjY5MTE=",
        "data": [
            {
                "amount": "100",
                "inscriptionId": "8c9c19c9c2f54a7c3f19848a79f360746431d80bc2fa376146ab61743e4a514ai0",
                "isBrc20": true,
                "listingTime": 1701075376,
                "listingUrl": "https://www.okx.com/web3/marketplace/nft/asset/btc/8c9c19c9c2f54a7c3f19848a79f360746431d80bc2fa376146ab61743e4a514ai0",
                "ownerAddress": "bc1p8a0ndtmczmmyvjv52280hf7zpl3qzml427eyfw6cjdjhc7ys4yxsvder0w",
                "price": "0.002",
                "slug": "sats",
                "unitPrice": "0"
            }
        ]
    },
    "msg": ""
}