该接口用于返回指定合集下所有有效订单。
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 |
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"
{
"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": ""
}