市场 API

查询出价单#

该接口用于查询指定 NFT 的有效欧易 Seaport 协议出价单。

请求地址#

GET https://www.okx.com/api/v5/mktplace/nft/markets/offers

请求参数#

参数类型必传描述
chainString链名称,详情见已支持的网络
collectionAddressStringNFT 合约地址
tokenIdStringNFT 的 tokenId
makerString根据订单发起人钱包地址过滤
createAfterString只展示此时间戳之后创建的订单,单位为秒
createBeforeString只展示此时间戳之前创建的订单,单位为秒
updateAfterString只展示此时间戳之后更新的订单,单位为秒
updateBeforeString只展示此时间戳之前更新的订单,单位为秒
statusString根据订单状态过滤,包括(active、inactive、cancelled、sold)
sortString订单排序规则,create_time_desc 代表根据订单创建时间倒序排序,update_time_desc 代表根据订单更新时间倒序排序,price_desc 代表根据价格倒序排序,price_asc 代表根据价格正序排序。排序规则默认为根据时间正序排序
limitString单页条数限制,默认值为50
cursorString查询指定订单页的游标参数

响应参数#

一个欧易订单模型的对象数组

参数类型描述
orderIdString订单 ID
createTimeLong订单创建日期
updateTimeLong订单更新日期
listingTimeLong订单挂单时间
expirationTimeLong订单有效期,结束时间
statusString订单状态,包括 (active、cancelled、sold、inactive)
orderHashString订单 hash
protocolDataString订单参数 (json)
protocolAddressString订单交易合约地址
chainString链名称,包括(ETH、Polygon、AVAX、BSC、OKTC、Arbitrum One、Optimism、Klaytn、zkSync Era)
makerString订单发起人的地址
orderTypeString订单类型,Offer 代表出价单,BuyNow 代表挂单
priceString订单对应的每个.NFT 单价
currencyAddressString订单对应的代币地址
collectionAddressStringNFT 合约地址
tokenIdStringNFT Token ID
amountString订单对应的 NFT 数量

请求示例#

shell
curl -X GET "https://www.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": ""
}