测试链订单查询API
GET https://testnets-api.opensea.io/wyvern/v1 /orders
/orders
端点用来从 OpenSea 系统查询订单。
请前往测试链/events页面, 我们提供了一个默认 API 密钥供开发人员在本文档参考中使用。
查询参数
- asset_contract_address:string,按资产类别的智能合约地址过滤。需要与token_id或token_ids一起定义。
- payment_token_address:string,按订单接受或提供的支付通证的智能合约地址过滤
- maker:string,按maker的钱包地址过滤
- taker:string,按订单taker的钱包地址过滤。对任何taker开放的订单都将空地址作为taker。
- owner:string,按资产所有者的钱包地址过滤
- is_english:bool,当为“True”时,只显示英文拍卖卖单,等待最高出价者。当“False”时,排除那些。
- bundled:bool,仅显示资产包的订单
- include_bundled:bool,包括资产包订单,其中资产包中的所有资产共享asset_contract_address提供的地址, 或资产包的maker是owner提供的地址
- listed_after:date_time,仅显示此时间戳之后列出的订单。自 Unix 纪元以来的秒数。
- listed_before:date_time,仅显示此时间戳之前列出的订单。自 Unix 纪元以来的秒数。
- token_id:string,按订单资产的通证 ID 过滤。需要与asset_contract_address 一起定义。
- token_ids:字符串数组,按订单资产的通证 ID 列表过滤。需要与asset_contract_address 一起定义。
- side:int32,按顺序过滤。0对于买单和1卖单。
- sale_kind:int32,按卖单类型过滤。0适用于固定价格销售或最低出价拍卖,以及1降价荷兰式拍卖。注意:only_english=true仅用于过滤英国拍卖
- limit:int32,要返回的订单数量(上限为 50)。
- offset:int32,分页偏移量
- order_by:string,如何排序订单。可以created_date用于时间排序,或者eth_price首先查看价格最低的订单(转换为它们的 ETH 值)。 eth_price仅当asset_contract_address 和token_id也被定义时才被支持。
- order_direction:string,可以是asc或desc用于升序或降序排序。例如,要查看最便宜的订单,请执行 order_directionasc和 order_by eth_price。
响应结果
正常响应状态码为200,返回一个JSON对象。