获取 Art Blocks 代币元数据

工具：gettokenmetadata

通过一次调用检索单个代币的完整元数据——包括特征、媒体URL、所有者、哈希值、挂单信息和项目上下文。当您需要已知代币ID的详细代币信息时，优先使用此工具而非graphql_query。

代币ID格式

<合约地址>-<代币编号>

示例：0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78000000

参数

响应结构

响应包含三个顶级键：token、media和project。

token:
id, tokenId, chainId, contractAddress, projectId
hash — 32字节十六进制，所有随机性的来源
invocation — 项目内的铸造编号（从0开始）
features — 链上特征对象
featuresStatus — notdefined | definedempty | defined
mintedAt, mintTransactionHash
ownerAddress
listing — 未挂单时为null，否则：
listing.price — 挂单价格
listing.currency — 货币符号（ETH、WETH等）
listing.platform — 市场名称
listing.url — 挂单URL
artBlocksUrl — artblocks.io上代币页面的直接链接

media:
imageUrl — 主要渲染图像
previewUrl — 预览资源URL
liveViewUrl — 实时交互生成器URL
hasVideo — 如果存在视频渲染则为true

project:
id, name, artistName, slug
artBlocksUrl — artblocks.io上项目页面的直接链接
description, website, license
scriptTypeAndVersion
maxInvocations, invocations, remaining
active, paused, complete
aspectRatio, curationStatus, verticalName, verticalDisplay
renderComplete

何时使用 vs GraphQL

注意事项

• - liveViewUrl是分享或预览生成式代币的标准方式——在向用户展示代币时始终包含此链接
• features是链上特征对象——与Art Blocks网站上显示的数据相同
• featuresStatus区分艺术家未定义特征（notdefined）、特征已定义但此代币为空（definedempty）和特征存在（defined）
• hash唯一标识代币的视觉输出——相同的哈希值始终产生相同的艺术作品
• 当代币没有活跃的二级市场挂单时，listing为null；存在时包含price、currency、platform和url
• token.artBlocksUrl和project.artBlocksUrl都链接到artblocks.io——在向用户展示代币时使用这些链接