OpenSea API文档

测试链资产查询API

GET hhttps://testnets-api.opensea.io/api/v1 /assets

要从 API 中检索资产,请使用所需的过滤器参数调用 /assets 端点。

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

在 OpenSea 上创建的拍卖不使用托管合同,该合同支持无气体拍卖,并允许用户在销售时保留其物品的所有权。所以这只是一个提示,以防您注意到 opensea.io 中的一些资产没有出现在 API 中。

端点将返回以下字段:

assets 资产对象列表
next 要作为查询参数提供的游标以检索下一页
previous 要作为查询参数提供的游标以检索上一页

查询参数

  • owner: string,资产所有者的地址
  • token_ids:string,要搜索的通证ID 数组(例如?token_ids=1&token_ids=209)。将返回 token_id 与此数组中的任何 ID 匹配的资产列表。
  • collection:string,限制对集合成员的响应。区分大小写,并且必须与 collection slug 完全匹配。将返回集合中所有合约的所有 资产。有关集合的更多信息,请参阅我们的集合文档。
  • collection_slug:string,限制对集合成员的响应。区分大小写,并且必须与 collection slug 完全匹配。将返回集合中所有合约 的所有资产。有关集合的更多信息,请参阅我们的集合文档。
  • collection_editor:string
  • order_direction:string,asc- 升序,desc-降序
  • asset_contract_addresses:string,资产的 NFT 合约地址
  • asset_contract_addresses:string,要搜索的合约地址数组(例如?asset_contract_addresses=0x1...&asset_contract_addresses=0x2...)。 将返回与此数组中的任何地址匹配的合约的资产列表。如果还指定了“token_ids”,那么它只会返回匹配每个(address, token_id) 配对的资产,尊重顺序。
  • limit:string,返回记录数限制。默认为 20,上限为 50。
  • cursor:string,指向要检索的页面的游标
  • include_orders:string,确定是否应在响应中包含订单信息的标志。

消息头

  • X-API-KEY:string

响应

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

  • next:string
  • previous:string
  • assets:对象数组,每个对象结构如下:
    • id: integer
    • num_sales: integer
    • background_color: string
    • image_url: string
    • image_preview_url: string