List tiers

GET /api/v1/mystery/catalog read:catalog

Lists the active mystery-pack tiers, derived from observed on-chain purchase activity. Use the returned tier_id with the odds and purchase endpoints. Authoritative live prices come from the MysteryComboPool contract — price_usdc may be null when the indexer has not recorded one.

Try it GET /api/v1/mystery/catalog
response
401 29ms preloaded server-side with the default context
object · 3 keys 
{
  "success": false,
  "message": "Invalid API key",
  "error": "API key not found or inactive"
}
curl (tracks the inputs above) 
curl -X GET 'https://staging-service.rip.fun/api/v1/mystery/catalog' \
  -H 'X-API-Key: rip_v1_…'

Response fields (data)

FieldDescription
tiers[].tier_idTier identifier — used by odds / purchase calls
tiers[].price_usdcLast observed price in USDC micros (string), may be null
tiers[].price_displayHuman-readable price, e.g. "$25"
tiers[].slot_countItems revealed per pack
tiers[].total_purchasesLifetime pulls observed for the tier
tiers[].last_active_atMost recent purchase timestamp

Errors

StatusCodeWhen
403Insufficient permissionskey lacks the read:catalog scope

See Errors for the response envelope and the full code list.