主题

订单相关模型#

订单状态枚举#

枚举	描述
active	表示该订单当前有效，可以被成交
inactive	表示该订单当前暂时失效，在后续可能重新变为 active 状态
cancelled	表示该订单已经被取消，无法被交易
sold	表示该订单已经被成交，无法再次被交易

订单返回数据模型模型

参数	类型	描述
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 数量
availableAmount	String	订单当前可成交的 NFT 数量

订单请求参数详情

参数	类型	描述
offerer	String	订单发起人的地址
offer	Array	订单发起方提供的所有商品列表，一个挂单项目模型数组
consideration	Array	订单接收方所提供的所有商品列表，一个订单项目模型数组
startTime	timestamp	订单有效期，起始时间
endTime	timestamp	订单有效期，结束时间
orderType	Number	orderType 根据两个不同的首选项为订单指定四种类型之一：OrderType
zone	String
zoneHash	String	固定值：0x0000000000000000000000000000000000000000000000000000000000000000
salt	String	随机数
conduitKey	String	固定值：0x066003C1493A346357Af15158cD985b4A6e29D3F888888888888888888888888
totalOriginalConsiderationItems	Number	订单列表数量
counter	Number	订单发起次数的计数器

订单发起方提供的所有商品列表。如果是 listing 单，应该是一个 ERC721 或者 ERC1155 的 NFT 列表，如果是 offer 单，应该是一个只有代币信息的列表。

参数	类型	描述
itemType	number	item 类型：itemType
token	String	item 资产对应的合约地址
identifierOrCriteria	String	item 如果是 NFT，那么代表的是 NFT 的 tokenId，如果是代币，可以忽略这个值
startAmount	number	订单成交时，item 提供的数量
endAmount	number	订单最终成交的 item 数量

订单接收方所提供的所有商品列表。这个列表包含三部分内容 (按照排序)：

参数名	类型	描述
itemType	number	item 类型：itemType
token	String	item 资产对应的合约地址
identifierOrCriteria	String	item 如果是 NFT，那么代表的是 NFT 的 tokenId，如果是代币，可以忽略这个值
startAmount	number	订单成交时，item 提供的数量
endAmount	number	订单最终成交的 item 数量
recipient	String	每一个 item 对应的接收地址

enum OrderType {
  FULL_OPEN,
  PARTIAL_OPEN,
  FULL_RESTRICTED,
  PARTIAL_RESTRICTED
}

enum ItemType {
    NATIVE,
    ERC20,
    ERC721,
    ERC1155,
    ERC721_WITH_CRITERIA,
    ERC1155_WITH_CRITERIA
}

订单请求参数详情

参数名	类型	描述
orderId	String	要购买的订单 ID
takeCount	Array	购买数量