获取 Ordinals 订单#
该接口用于返回指定合集下所有有效订单。
请求地址#
POST https://web3.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://web3.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://web3.okx.com/web3/marketplace/nft/asset/btc/8c9c19c9c2f54a7c3f19848a79f360746431d80bc2fa376146ab61743e4a514ai0",
"ownerAddress": "bc1p8a0ndtmczmmyvjv52280hf7zpl3qzml427eyfw6cjdjhc7ys4yxsvder0w",
"price": "0.002",
"slug": "sats",
"unitPrice": "0"
}
]
},
"msg": ""
}