Metadata
Basic Metadata
Get product details, images and token metadata.
GET /api/public/v1/metadata/{'}tokenid{'}Returns product metadata for a token, plus current availability and pricing context.
Use this when you have a token id and need the product behind it: name, image, traits, availability, price context, and the DYLI drop-page url.
Metadata responses include the same market snapshot used by search and listings:
| Field | Meaning |
|---|---|
show_external | Boolean flag for filtering external displays. false for print-on-demand products (is_pod), products that are not live, products whose subcategory/Type is Sticker, and Fair Drops (any non-null queue_override_actual, including 0); true otherwise. Included in basic and advanced metadata. |
is_fair_drop | true for Fair Drop entry tokens and false for ordinary product tokens. Exclude true rows when only redeemable physical products are wanted. |
market_flags | Whether the product is currently available in primary, secondary, or both. |
pricing.primary | Current primary buy price, quantity available, and primary listing count. |
pricing.secondary | Current resale floor price and secondary listing count. |
availability.in_boxes_quantity | Units currently allocated inside packs, when available. |
availability.in_circulation_quantity | Minted units outside redeemed supply and pack inventory, when available. |
Standard NFT attributes also include Fair Drop: Yes or Fair Drop: No for systems that index traits instead of top-level fields.
curl "https://www.dyli.io/api/public/v1/metadata/12345" \
-H "x-api-key: $DYLI_API_KEY"
Advanced Metadata
GET /api/public/v1/metadata/advanced/{'}tokenid{'}Returns richer metadata: image arrays, normalized collectible fields, Alt identifiers, and pricing context.
Use this for richer product pages, pricing tools, or resolvers that need more than the basic token payload.
curl "https://www.dyli.io/api/public/v1/metadata/advanced/12345" \
-H "x-api-key: $DYLI_API_KEY"
Batch Advanced Metadata
GET /api/public/v1/metadata/advanced?tokenIds=12345,67890Use batch metadata when you already have token ids and want to hydrate them in one request.
curl "https://www.dyli.io/api/public/v1/metadata/advanced?tokenIds=12345,67890" \
-H "x-api-key: $DYLI_API_KEY"