get_token_metadataRetrieves a single token's full metadata in one call — traits, media URLs, owner, hash, listing info, and project context. Prefer this over graphql_query when you need rich token details for a known token ID.
Example: 0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78000000
| Param | Required | Notes |
|---|---|---|
| ----------- | ---------- | -------------------------------------------- |
tokenId | yes | Full token ID |
chainId | — | Default 1 (Ethereum). 1, 42161 (Arbitrum), 8453 (Base) |
The response has three top-level keys: token, media, and project.
token:
id, tokenId, chainId, contractAddress, projectId
hash — 32-byte hex, the source of all randomness
invocation — mint number within the project (0-indexed)
features — on-chain traits object
featuresStatus — "not_defined" | "defined_empty" | "defined"
mintedAt, mintTransactionHash
ownerAddress
listing — null if not listed, otherwise:
listing.price — listing price
listing.currency — currency symbol (ETH, WETH, etc.)
listing.platform — marketplace name
listing.url — listing URL
artBlocksUrl — direct link to the token page on artblocks.io
media:
imageUrl — primary rendered image
previewUrl — preview asset URL
liveViewUrl — live interactive generator URL
hasVideo — true if a video render exists
project:
id, name, artistName, slug
artBlocksUrl — direct link to the project page on artblocks.io
description, website, license
scriptTypeAndVersion
maxInvocations, invocations, remaining
active, paused, complete
aspectRatio, curationStatus, verticalName, verticalDisplay
renderComplete
Use get_token_metadata when... | Use graphql_query when... |
|---|---|
| --- | --- |
| You have a specific token ID and want everything about it | You need to query multiple tokens at once |
You need media URLs (liveViewUrl, imageUrl) | You need fields not in this response |
| You want features + project context in one call | You're building complex filters or aggregations |
liveViewUrl is the canonical way to share or preview a generative token — always include it when presenting a token to a userfeatures is the on-chain traits object — same data shown on Art Blocks websitefeaturesStatus distinguishes between "artist hasn't defined features" (not_defined), "features are defined but empty for this token" (defined_empty), and "features exist" (defined)hash uniquely identifies the token's visual output — same hash always produces the same artworklisting is null when the token has no active secondary-market listing; when present it contains price, currency, platform, and urltoken.artBlocksUrl and project.artBlocksUrl link to artblocks.io — use these when presenting tokens to users共 1 个版本