OpenSea API文档

测试链集合查询API

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

使用/collections端点获取 OpenSea 上的集合

/collections端点提供了 OpenSea 支持和审查的所有集合的列表。要包含与用户相关的所有集合(包括未列入白名单的集合), 请设置owner参数。

返回区域中的每个集合都有一个primary_asset_contracts属性,包含属于该集合的智能合约的信息。例如,ERC-1155 合约可能 有多个集合都引用同一个合约,但许多 ERC-721 合约可能都属于同一个集合(dapp)。

还可以使用此端点来查找帐户使用的 dapps,以及它们在每个应用程序中拥有多少项目 - 所有这些都在一个 API 调用中!

查询参数

  • asset_owner:string,一个钱包地址。如果指定,将返回所有者在集合中拥有至少一项属于智能合约的资产的集合。 帐户拥有的资产数量为每个集合显示为owned_asset_count。
  • offset:int32,用于分页。从结果列表的开头偏移的合约数量。
  • limit:int32,用于分页。返回的最大合约数。

消息头

  • X-API-KEY:string,可选 API 密钥

响应结果

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

  • banner_image_url:string
  • chat_url:string
  • created_date:string
  • default_to_fiat:boolean
  • description:string
  • dev_buyer_fee_basis_points:string
  • dev_seller_fee_basis_points:string
  • discord_url:string
  • display_data:对象
  • external_url:string
  • featured:boolean
  • featured_image_url:string
  • hidden:boolean
  • image_url:string
  • instagram_username:string
  • is_subject_to_whitelist:boolean
  • large_image_url:string
  • medium_username:string
  • name:string
  • only_proxied_transfers:boolean
  • opensea_buyer_fee_basis_points:string
  • opensea_seller_fee_basis_points:string
  • owned_asset_count:integer
  • payout_address:string
  • primary_asset_contracts:对象数组
  • address:string
  • asset_contract_type:string
  • buyer_fee_basis_points:integer
  • created_date:string
  • default_to_fiat:boolean
  • description:string
  • dev_buyer_fee_basis_points:integer
  • dev_seller_fee_basis_points:integer
  • external_link:string
  • image_url:string
  • name:string
  • nft_version:string
  • only_proxied_transfers:boolean
  • opensea_buyer_fee_basis_points:integer
  • opensea_seller_fee_basis_points:integer
  • opensea_version:string
  • owner:integer
  • payout_address:string
  • schema_name:string
  • seller_fee_basis_points:integer
  • symbol:string
  • total_supply:string
  • require_email:boolean
  • safelist_request_status:string
  • short_description:string
  • slug:string
  • stats:object
  • telegram_url:string
  • traits:对象
  • twitter_username:string
  • wiki_url:string