Listings
Returns current DYLI listings. eBay is not included here.
Use this when you want to show what someone can buy right now. primary means DYLI inventory is available. secondary means a user is reselling an item they own. A product can show up in either market, both markets, or neither.
Query Parameters
| Name | Description |
|---|---|
brand | Case-insensitive brand filter, for example Vibes. |
category | Case-insensitive category filter, for example TCG. |
subcategory | Case-insensitive subcategory filter, for example Ungraded Card. |
cert | Cert number. Common BGS variants are checked. |
marketType | primary for DYLI inventory, secondary for user resale listings. Alias: market_type. |
productId | Exact DYLI product id. Alias: product_id. |
tokenId | Exact ERC-1155 token id. Alias: tokenid. |
page, pageSize | Pagination. pageSize max is 200. |
Row Fields
Rows include listing_id, product_id, token_id, name, url, dyli_url, marketplace_url, metadata_url, metadata_advanced_url, market_type, market_flags, source_marketplace, price, currency, quantity_available, listing_count, pricing, availability, image_url, brand, category, subcategory, cert, and updated_at.
url is the DYLI page for the item, like https://www.dyli.io/drop/29022.
For primary rows, quantity_available and listing_count both show the total primary units available right now. For secondary rows, both fields reflect active resale listings.
The nested availability object gives the full market snapshot for the product: primary quantity, secondary listing count, units in boxes, minted circulation, total minted, and total redeemed when that data is available.
Examples
curl "https://www.dyli.io/api/public/v1/listings?marketType=secondary&page=1&pageSize=50" \
-H "x-api-key: $DYLI_API_KEY"
curl --get "https://www.dyli.io/api/public/v1/listings" \
-H "x-api-key: $DYLI_API_KEY" \
--data-urlencode "brand=Vibes" \
--data-urlencode "subcategory=Ungraded Card" \
--data-urlencode "marketType=secondary" \
--data-urlencode "page=1" \
--data-urlencode "pageSize=50"
The same request as a URL:
/api/public/v1/listings?brand=Vibes&subcategory=Ungraded%20Card&marketType=secondary&page=1&pageSize=50