Staple / Hot Cache API

Top 150 most used cards from tournament decklists. 1 count per deck presence. Legal only. Rebuilt 2× weekly via cron; /api/cards/hot can trigger rebuild if stale.

Endpoints

GET /api/staple/query

Returns all staples with usage stats and card details. No query params.

GET /api/cards/hot

Same data as staple/query but returns full card info and can trigger cache rebuild. See Cards API.

Response

{
  "staples": [
    {
      "card_id": "me2pt5-183",
      "name": "Boss's Orders",
      "usage_rate": 87.83,
      "deck_count": 431268,
      "total_decks": 491009,
      "image_url": "...",
      "set_id": "me2pt5",
      "release_date": "..."
    }
  ],
  "count": 150
}