Metadata
Basic 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 |
|---|---|
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 boxes, when available. |
availability.in_circulation_quantity | Minted units outside redeemed supply and box inventory, when available. |
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"