测试链资产查询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