OpenSea API文档

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

资产模型

OpenSea API 中的主要对象是资产,它代表了一个独特的数字项目,其所有权由区块链管理。下面的 CryptoSaga 英雄是 OpenSea 上显示的资产示例:

以下是资产中包含的一些字段的概述:

字段名称 描述
token_id NFT 的代币 ID
image_url 项目的图像。请注意,这是我们存储在我们端的缓存 URL。原始图片网址是image_original_url
background_color 与项目一起显示的背景颜色
name 项目名称
external_link 指向该项目原始网站的外部链接
asset_contract 合约本身的数据字典(参见资产合约部分)
owner 所有者数据字典(参见帐户部分)
traits 与物品相关的特征列表(参见特征部分)
last_sale 上次销售此商品的时间(如果没有上次销售,则为 null)

特征

特征(traits)是项目的特殊属性,可以是数字或字符串。以下是 OpenSea 如何显示特定项目的特征的示例:

以下是特征中包含的一些字段:

字段 说明
trait_type 特征的名称(例如颜色)
value 此特征的值(可以是字符串或数字)
display_type 如何显示此特征(选项为number、boost_percentage、boost_number和date)。有关更多详细信息请参阅添加元数据部分

资产合约

资产合约(asset contracts)包含合约本身的数据,例如 CryptoKitties 合约或 CoolCats 合约。 以下是与资产合约相关的字段:

字段 说明
address 资产合约地址
name 资产合约名称
symbol 符号,例如 CKITTY
image_url 与资产合约关联的图像
description 资产合约说明
external_link 链接到本合同的原始网站