Skip to main content

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:

FieldMeaning
show_externalBoolean 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_droptrue for Fair Drop entry tokens and false for ordinary product tokens. Exclude true rows when only redeemable physical products are wanted.
market_flagsWhether the product is currently available in primary, secondary, or both.
pricing.primaryCurrent primary buy price, quantity available, and primary listing count.
pricing.secondaryCurrent resale floor price and secondary listing count.
availability.in_boxes_quantityUnits currently allocated inside packs, when available.
availability.in_circulation_quantityMinted 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,67890

Use 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"