List tiers

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

Lists the mystery-pack tiers you can sell. Use each tier_id with the odds and purchase endpoints. price_usdc can be null when a live price isn’t available yet.

Try it GET /api/v1/mystery/catalog
response
200 39ms preloaded server-side with the default context
object · 3 keys 
{
  "success": true,
  "data": {
    "tiers": [
      {
        "tier_id": 1,
        "price_usdc": "25",
        "price_display": "$25.00",
        "price_micros": "25000000",
        "target_ev_usdc": "25.75",
        "slot_count": 1,
        "active": true,
        "total_purchases": 7384,
        "last_active_at": "2026-07-29 17:31:59.305"
      },
      {
        "tier_id": 2,
        "price_usdc": "65",
        "price_display": "$65.00",
        "price_micros": "65000000",
        "target_ev_usdc": "65",
        "slot_count": 1,
        "active": false,
        "total_purchases": 305,
        "last_active_at": "2026-04-11 13:13:43.522"
      },
      {
        "tier_id": 3,
        "price_usdc": "5",
        "price_display": "$5.00",
        "price_micros": "5000000",
        "target_ev_usdc": "5.15",
        "slot_count": 1,
        "active": true,
        "total_purchases": 2731,
        "last_active_at": "2026-07-29 20:03:09.474"
      },
      {
        "tier_id": 4,
        "price_usdc": "15",
        "price_display": "$15.00",
        "price_micros": "15000000",
        "target_ev_usdc": "15",
        "slot_count": 1,
        "active": false,
        "total_purchases": 25,
        "last_active_at": "2026-05-24 07:44:07.373"
      },
      {
        "tier_id": 5,
        "price_usdc": "55",
        "price_display": "$55.00",
        "price_micros": "55000000",
        "target_ev_usdc": "56.25",
        "slot_count": 1,
        "active": true,
        "total_purchases": 497,
        "last_active_at": "2026-07-29 12:53:51.438"
      }
    ]
  },
  "meta": {
    "source": "onchain+observed",
    "note": "Price / EV / active are read live from MysteryComboPool; total_purchases and last_active_at are observed by the indexer."
  }
}
curl (tracks the inputs above) 
curl -X GET 'https://service.rip.fun/api/v1/mystery/catalog' \
  -H 'X-API-Key: rip_…'

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.