Read APIs
Use the Public Read API for data retrieval without creating purchases, shipments, listings, or other side effects.
https://www.dyli.io/api/public/v1
All endpoints require an API key. The endpoint index at GET /overview reports live status and documentation URLs.
Catalog and platform
| Method and path | Returns |
|---|---|
GET /overview | Live endpoint inventory and controls. |
GET /search | Product discovery by text, taxonomy, identifiers, and availability. |
GET /products/{productId}/cert | Grading certificate, creation date, and price for one product ID. |
GET /contracts | Current public contract references. |
GET /metadata/{tokenId} | Basic product metadata and market context. |
GET /metadata/advanced/{tokenId} | Rich metadata for one token. |
GET /metadata/advanced | Rich metadata for up to 50 token IDs. |
POST /metadata/advanced | The same read-only batch lookup with token IDs in JSON. This does not mutate data. |
Marketplace activity
| Method and path | Returns |
|---|---|
GET /listings | Active DYLI primary and secondary inventory. |
GET /ebay/listings | Approved live eBay inventory, including PSA Vault. |
GET /offers | Active or accepted secondary offers. |
GET /sales | Normalized sale and lifecycle activity. |
GET /redemptions | Completed shipping, ripping, and grading redemptions. |
GET /p2p-trades | Completed collector-to-collector trades. |
Read API prices are discovery data. Use the Commerce API to obtain partner-filtered purchase instructions and a server-priced quote.
Users and collections
| Method and path | Returns |
|---|---|
GET /sellers/{identifier} | Seller profile, products, and Boxes by username or wallet. |
GET /holdings/{identifier} | Current token holdings by username or wallet. |
GET /sets/{collection} | Set catalog and collector progress. |
GET /sets/{collection}/{setCode} | Cards and ownership state for one set. |
GET /sets/{collection}/{setCode}/missing | Missing cards with optional availability and price filters. |
Experiences, verification, and analytics
| Method and path | Returns |
|---|---|
GET /boxes and GET /boxes/{boxId} | Box catalog or one Box. |
GET /boxes/{boxId}/ranges | Odds ranges, active contents, and inventory count/value totals. |
GET /boxes/{boxId}/history | Cursor-paginated pull history. |
GET /boxes/verify | Completed Box result verification. |
GET /fair-drops | Current and historical Fair Drops. |
GET /fair-drops/{identifier}/verify | Fair Drop verification. |
GET /digital-packs | Digital pack product stats and activity. |
GET /transactions | Transaction totals by time period. |
GET /rewards | Rewards leaderboards. |
GET /referrals | Referral leaderboards. |
White-label reads
Partner-filtered catalog routes are available under /api/commerce/v1/catalog/*, including listings, Boxes, redemptions, approved eBay inventory, collections, Fair Drops, digital packs, and search.
Use these routes when an app needs a limited or branded catalog. Saved configuration will be available with the Commerce API.
Common behavior
- Use Filtering for taxonomy and market filters.
- Use Pagination for page and cursor conventions.
- Use Errors for status codes and retry behavior.
- Read routes require a
read,commerce, orwritescope.