查询出价单#
该接口用于查询指定 NFT 的有效欧易 Seaport 协议出价单。
请求地址#
GET https://web3.okx.com/api/v5/mktplace/nft/markets/offers
请求参数#
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| 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） |
| 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 | 链名称，包括（ETH、Polygon、AVAX、BSC、OKTC、Arbitrum One、Optimism、Klaytn、zkSync Era） |
| maker | String | 订单发起人的地址 |
| orderType | String | 订单类型，Offer 代表出价单，BuyNow 代表挂单 |
| price | String | 订单对应的每个.NFT 单价 |
| currencyAddress | String | 订单对应的代币地址 |
| collectionAddress | String | NFT 合约地址 |
| tokenId | String | NFT Token ID |
| amount | String | 订单对应的 NFT 数量 |
请求示例#
shell
curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/markets/offers?{REQUEST PARAMS}" \
-H 'OK-ACCESS-KEY: XXX' \
-H 'OK-ACCESS-TIMESTAMP: XXX' \
-H 'OK-ACCESS-PASSPHRASE: XXX' \
-H 'OK-ACCESS-SIGN: XXX' \
响应示例#
200
{
"code": 0,
"data": {
"cursor": "ODg0MjY2NDgz",
"data": [
{
"amount": "1",
"chain": "eth",
"collectionAddress": "0x457efd33def0bff2dfe33089d385898d919d3a10",
"createTime": 1680047938,
"currencyAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"expirationTime": 1680307118,
"listingTime": 1680047927,
"maker": "0x72fde15006cff1bfc1be596f03855a2c55b546e1",
"orderHash": "0x48cc57480fdbe993821b6679910657845201351448bca623a6b7726fc1f7ff4b",
"orderType": "Offer",
"price": "110000",
"protocolAddress": "0x90a77dd8ae0525e08b1c2930eb2eb650e78c6725",
"protocolData": {
"parameters": {
"conduitKey": "0x618Cf13c76c1FFC2168fC47c98453dCc6134F5c8888888888888888888888888",
"consideration": [
{
"endAmount": "1",
"identifierOrCriteria": "77735144008553370296572895450686144694166639583550383356598452408298996120723",
"itemType": 2,
"recipient": "0x72fde15006cff1bfc1be596f03855a2c55b546e1",
"startAmount": "1",
"token": "0x457efd33def0bff2dfe33089d385898d919d3a10"
}
],
"counter": "0",
"endTime": 1680307118,
"offer": [
{
"endAmount": "110000",
"identifierOrCriteria": "0",
"itemType": 1,
"startAmount": "110000",
"token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
],
"offerer": "0x72fde15006cff1bfc1be596f03855a2c55b546e1",
"orderType": 3,
"salt": "1144075581",
"startTime": 1680047927,
"totalOriginalConsiderationItems": 1,
"zone": "0x868B0635A8858dB9D984B5A27559f961Fd2736c0",
"zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
},
"signature": "0xa413e6e3496fcd8bc28af88d4e1f2db4ccb7b524763ba6d87a56b15b20510d5d1eb782121c96ed61e2b68d537e03f96c51b37e0c325d03ad035091bf1933d4b81b"
},
"status": "active",
"tokenId": "77735144008553370296572895450686144694166639583550383356598452408298996120723",
"updateTime": 1680047938
}
]
},
"msg": ""
}