该接口用于查询指定 NFT 的有效欧易 Seaport 协议挂单。
GET https://www.okx.com/api/v5/mktplace/nft/markets/listings
参数 | 类型 | 必传 | 描述 |
---|---|---|---|
chain | String | 是 | 链名称,详情见已支持的网络 |
collectionAddress | String | 否 | NFT 合约地址 |
tokenId | String | 否 | NFT 的 tokenId |
maker | String | 否 | 根据订单发起人钱包地址过滤 |
createAfter | String | 否 | 只展示此时间戳之后的创建订单,单位为秒 |
createBefore | String | 否 | 只展示此时间戳之前的创建订单,单位为秒 |
updateAfter | String | 否 | 只展示此时间戳之后的更新订单,单位为秒 |
updateBefore | String | 否 | 只展示此时间戳之前的更新订单,单位为秒 |
status | String | 否 | 根据订单状态过滤,包括(active、inactive、cancelled、sold) |
platform | String | 否 | 目标挂单平台,详情见已经接入的市场,默认值为 okx |
sort | String | 否 | 订单排序规则,create_time_desc 代表根据订单创建时间倒序排序,update_time_desc 代表根据订单更新时间倒序排序,price_desc 代表根据价格倒序排序,price_asc 代表根据价格正序排序。排序规则默认为根据时间正序排序 |
limit | String | 否 | 单页条数限制,默认值为 50 |
cursor | String | 否 | 查询指定订单页的游标参数 |
一个欧易订单模型的对象数组
参数 | 类型 | 描述 |
---|---|---|
orderId | String | 订单 ID |
createTime | Long | 订单创建日期 |
updateTime | Long | 订单更新日期 |
listingTime | Long | 订单挂单时间 |
expirationTime | Long | 订单有效期,结束时间 |
status | String | 订单状态,包括 (active、cancelled、sold、inactive) |
orderHash | String | 订单 hash |
protocolData | String | 订单参数 (json) |
protocolAddress | String | 订单交易合约地址 |
chain | String | 链名称,详情见已支持的网络 |
maker | String | 订单发起人的地址 |
orderType | String | 订单类型,Offer 代表出价单,BuyNow 代表挂单 |
price | String | 订单对应的每个 NFT 单价 |
currencyAddress | String | 订单对应的代币地址 |
collectionAddress | String | NFT 合约地址 |
tokenId | String | NFT Token ID |
amount | String | 订单对应的 NFT 数量 |
curl -X GET "https://www.okx.com/api/v5/mktplace/nft/markets/listings?{REQUEST PARAMS}" \
-H 'OK-ACCESS-KEY: XXX' \
-H 'OK-ACCESS-TIMESTAMP: XXX' \
-H 'OK-ACCESS-PASSPHRASE: XXX' \
-H 'OK-ACCESS-SIGN: XXX' \
{
"code": 0,
"data": {
"cursor": "NjE5MTQ0MTM5",
"data": [
{
"amount": "1",
"chain": "OKTC",
"collectionAddress": "0xe4c0578279269c4f0265bc486c199509566fe863",
"createTime": 1672828395,
"updateTime": 1672828395,
"status": "active",
"currencyAddress": "0x382bb369d343125bfb2117af9c149795c6c65c50",
"expirationTime": 1673433171,
"listingTime": 1672828387,
"maker": "0x5164370b3ba971474d10da1d409ce8872cb8ca97",
"orderHash": "0x5bdaa259cb76ace593f3e631099319f955b48397482e7e4d45c008d985b61ade",
"orderType": "BuyNow",
"price": "1000000000000000",
"protocolAddress": "0x34df5c035e31c0edfd104f3ea83d9548f108df56",
"protocolData": {
"parameters": {
"conduitKey": "0x618Cf13c76c1FFC2168fC47c98453dCc6134F5c8888888888888888888888888",
"consideration": [
{
"endAmount": "1000000000000000",
"identifierOrCriteria": "0",
"itemType": 1,
"recipient": "0x5164370b3ba971474d10da1d409ce8872cb8ca97",
"startAmount": "1000000000000000",
"token": "0x382bb369d343125bfb2117af9c149795c6c65c50"
}
],
"counter": 0,
"endTime": 1673433171,
"offer": [
{
"endAmount": "1",
"identifierOrCriteria": "17230",
"itemType": 2,
"startAmount": "1",
"token": "0xe4c0578279269c4f0265bc486c199509566fe863"
}
],
"offerer": "0x5164370b3ba971474d10da1d409ce8872cb8ca97",
"orderType": 2,
"salt": "27454607645473204",
"startTime": 1672828387,
"totalOriginalConsiderationItems": 1,
"zone": "0xa472fAd4B6cAdFDEd63f7aE5BFEe6eCf4F08Ae95",
"zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
},
"signature": "0x"
},
"tokenId": "17230"
}
]
},
"msg": ""
}