Fair Drops

Fair Drops are timed drops where buyers enter for a chance to win the item. Use these endpoints to list live drops, show past results, and make the winner check easy to inspect.

Current Drops

GET /api/public/v1/fair-drops

curl "https://www.dyli.io/api/public/v1/fair-drops" \
  -H "x-api-key: $DYLI_API_KEY"

By default this returns current pending Fair Drops. Use status=completed for past winners, status=refundable for drops that ended without hitting minimum, or status=all when you want the full feed.

Rows include dropId, title, image, status, entryPrice, entryCurrency, entryPaymentType, entryPricing, seller, creator, winner fields when available, and timestamps. entryPaymentType is cash for USD entries and diamonds for diamond entries.

Query parameters:

Name	Description
status	pending, completed, refundable, or all. Defaults to pending.
q	Search by drop name or numeric drop id.
page, pageSize	Pagination. pageSize max is 24. Alias: limit.

Verify A Fair Drop

GET /api/public/v1/fair-drops/{'}dropId{'}/verify

curl "https://www.dyli.io/api/public/v1/fair-drops/31406/verify" \
  -H "x-api-key: $DYLI_API_KEY"

If you only have the order transaction hash, use the direct verify route:

curl --get "https://www.dyli.io/api/public/v1/fair-drops/verify" \
  -H "x-api-key: $DYLI_API_KEY" \
  --data-urlencode "txHash=0x..."

The response includes the drop, total entries, paginated participant odds, winner when one exists, and the generated verification number. Pending drops still return their current entry view.

Query parameters:

Name	Description
txHash	Optional order transaction hash. Use this instead of a drop id when needed.
page, pageSize	Pages participant odds rows. Defaults to page=1&pageSize=25. pageSize max is 100. Alias: limit.