OpenSea API文档

在线工具推荐: Three.js AI纹理开发包 - YOLO合成数据生成器 - GLTF/GLB在线编辑 - 3D模型格式在线转换 - 可编程3D场景编辑器

测试链订单查询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对象。