Skip to main content

GET /trending/catalog

Fetch the trending catalog as this end user sees it. The user's own discount is already applied to the prices. When their next trending order earns the loyalty reward, the promo prices are shown instead (see loyalty).

The prices you get are the prices the user pays.

Use case​

Render a price list / product picker before the user pastes a pair link.

Headers​

HeaderRequiredDescription
AuthorizationyesBearer <accessToken>
x-user-idyesEnd-user id, 1–256 chars [A-Za-z0-9_-].

Response 200​

{ "catalog": { "services": { "...": "..." } } }

catalog.services is keyed by service name (reactions, dex-trending, other-services). Each service lists its orderTypes, every entry with an id you pass as orderTypeId when ordering. reactions also lists its speeds. Treat the rest of the catalog as data to render, not a fixed schema: it may gain fields.

Errors​

StatusMeaning
401 / 403Token missing, invalid, expired or revoked / API inactive.
429Per-client rate limit hit.
503Trending disabled, or the catalog is unavailable.

Example​

curl -H "Authorization: Bearer $ACCESS" -H "x-user-id: $USER_ID" \
"$BASE_URL/trending/catalog"