市场 API

获取 Ordinals 订单#

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

请求地址#

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

请求参数#

参数类型必传描述
slugString合集 slug 名称,即合集的唯一标识
cursorString指向要检索的页面的游标
limitString分页大小(默认值 10,最大 100)。返回最大的订单数
sortString挂单排序规则:
listing_time_desc:订单创建时间最新的在前
listing_time_asc:订单创建时间最早的在前
price_desc:价格最高的在前
price_asc:价格最低的在前
unit_price_desc:单价最高的在前
unit_price_asc:单价最低的在前。
默认排序为订单创建时间最新的在前。
isBrc20Boolean获取全部 BTC NFT 或 Brc20 合集的订单,默认为 Brc20

响应参数#

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

参数类型描述
inscriptionIdString铭文编号
listingTimeLong挂单时间
listingUrlString订单所在页面链接
ownerAddressString订单所有者
priceString订单价格,BTC 计价
unitPriceString订单单价,BTC 计价
amountString订单中的铭文数量
isBrc20Boolean用于区分 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": ""
}