测试链事件查询API

GET https://testnets-api.opensea.io/api/v1 /events

/events事件查询API端点提供在OpenSea 跟踪的资产上发生的事件列表。“event_type”字段指示它是什么类型的事件（转移、成功拍卖等）。 结果按事件时间戳排序。请注意，由于区块重组，最近的事件（不到 10 分钟）可能无法反映区块链的最终状态。

请注意：此 API 端点需要 API 密钥才能使用。请填写 API 申请表以获取一份。请求 API 密钥

端点将返回以下字段：

查询参数

• only_opensea：布尔值，仅限于 OpenSea 拍卖活动。可以是true或false
• token_id：32位整数，可以选择过滤的NFT通证的 id
• asset_contract_address：string，显示事件的资产的 NFT 合约地址
• collection_slug：string，限制对集合中事件的响应。区分大小写，并且必须与 collection slug 完全匹配。 将返回集合中所有合约的所有资产。有关集合的更多信息，请参阅我们的集合文档。
• collection_editor：string
• account_address：string，用户账户的钱包地址，用于过滤账户上的事件
• event_type：string，要过滤的事件类型。created- 用于新的拍卖、successful - 销售、cancelled、bid_entered、bid_withdrawn、transfer、approve
• auction_type：string，按拍卖类型过滤。english - 用于英语拍卖、dutch - 固定价格和降价卖单（荷兰拍卖）、min-price - CryptoPunks 竞价拍卖。
• occurred_before：date-time，仅显示此时间戳之前列出的事件。自 Unix 纪元以来的秒数。
• occurred_after：date-time，仅显示此时间戳之后列出的事件。自 Unix 纪元以来的秒数。
• cursor：指向要检索的页面的游标

响应结果

正常响应的状态代码为200，返回一个JSON对象，结构如下：

• next：string
• previous：string
• asset_events：资产事件对象数组，对象结构如下：
  • approved_account：string
  • asset：资产对象，结构如下
  • asset_bundle：string，资产包
  • auction_type：string，拍卖类型
  • bid_amount：string，投标数量
  • collection_slug：string
  • contract_address：string，合约地址
  • created_date：string，创建日期
  • custom_event_name：string，自定义事件名称
  • dev_fee_payment_event：string，
  • dev_seller_fee_basis_points：integer
  • duration：string
  • ending_price：string
  • event_type：string
  • from_account：账号对象，结构如下
  • id：integer
  • is_private：string
  • owner_account：string
  • payment_token：支付通证对象
  • quantity：string
  • seller：string
  • starting_price：string
  • to_account：string
  • total_price：string
  • transaction：string
  • winner_account：string
  • listing_time：string