Skip to main content

Offers

GET /api/public/v1/offers

Returns secondary-market offers. Active offers can be accepted by a holder. Accepted offers are historical offer fills.

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

Query Parameters

NameDescription
statusactive, accepted, or all. Defaults to active.
brandCase-insensitive brand filter, for example Vibes.
categoryCase-insensitive category filter, for example TCG.
subcategoryCase-insensitive subcategory filter, for example Ungraded Card.
certCert number. Common BGS variants are checked.
productIdExact DYLI product id. Alias: product_id.
tokenIdExact ERC-1155 token id. Alias: tokenid.
sortprice, created, or expiration. Defaults to price.
directiondesc or asc. Defaults to desc.
page, pageSizePagination. pageSize max is 200.

Row Fields

Rows include offer_id, order_id, reservoir_id, product_id, token_id, product_name, market_type, market_flags, source_marketplace, price, currency, quantity, status, offerer, maker_wallet, accepted_by, accepted_at, expiration, expires_at, tx_hash, image_url, brand, category, subcategory, cert, created_at, updated_at, dyli_url, metadata_url, and metadata_advanced_url.

currency is USDC.e. market_type is always secondary.

Examples

curl --get "https://www.dyli.io/api/public/v1/offers" \
-H "x-api-key: $DYLI_API_KEY" \
--data-urlencode "brand=Vibes" \
--data-urlencode "status=active" \
--data-urlencode "sort=price" \
--data-urlencode "page=1" \
--data-urlencode "pageSize=50"
curl "https://www.dyli.io/api/public/v1/offers?tokenId=12345" \
-H "x-api-key: $DYLI_API_KEY"