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
Section titled “Token metadata”Every token includes:
| Field | Description |
|---|---|
| Name | Display name of the token |
| Description | Text description |
| Image | Primary visual asset URL |
| Animation URL | Optional animated asset URL (video, HTML, etc.) — field: animationUrl |
| Attributes | Key-value trait pairs |
Metadata by collection type
Section titled “Metadata by collection type”Editions (Open, Limited, 1/1)
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “Querying tokens”Tokens can be listed and filtered by:
- Collection
- Owner wallet address
- Attribute values
- Name search
- Minted date (
mintedAt)
Related
Section titled “Related”- Collections — Collection types overview
- Gates — Token attribute gate conditions
- Tokens API — API reference