查询挂单#

该接口用于查询指定 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 数量

请求示例#

shell

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' \

响应示例#

200

{
  "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": ""
}