Tokens & Metadata

A token is an individual NFT within a collection. Each token has metadata that describes it — its name, image, traits, and other properties.

Token metadata

Every token includes:

Field	Description
name	Display name of the token
description	Text description
imageMediaId	Handle for the primary visual asset — resolve the URL via client.media.get
animationMediaId	Handle for an optional animated asset (video, HTML, etc.) — resolve the URL via client.media.get
attributes	Array of { trait_type, value, display_type? } — read-side matches ERC-721 metadata JSON
properties	Freeform key/value object
mintedAt	ISO timestamp; null for un-minted placeholder tokens

Metadata by collection type

Editions (Open, Limited, 1/1)

All tokens in an edition share the same metadata. When you set the name, image, and description for the edition, every minted token inherits those values.

Series

Each token has unique metadata. You upload individual assets and define attributes per token. Tokens can be queried and filtered by their attributes.

Generative

Token metadata is generated at mint time. The image is captured from your generative code’s output, and the seed used for generation is stored as part of the token’s data.

Attributes

Attributes are key-value pairs that describe traits of a token:

{
  "trait_type": "Background",
  "value": "Gold"
}

Attributes are used for:

• Display — Showing traits on token detail pages
• Filtering — Searching tokens by trait values
• Gate conditions — Token attribute gates check for specific traits

Querying tokens

Tokens can be listed and filtered by:

• Collection
• Owner wallet address
• Attribute values
• Name search
• Minted date (mintedAt)

Related

• Collections — Collection types overview
• Gates — Token attribute gate conditions
• Tokens API — API reference