Get Score History

Time series of the composite MSI, newest-first.

Params: underlying (default SPY), limit (default 600, max 5000), lookback_days (default 4, max 30). The DB read caps results to the requested calendar-day window so the default response covers the current and previous sessions across a normal weekend; raise lookback_days to drive multi-day chart presets (e.g. 5-trading-day view).

Returns. An array of objects with timestamp, composite_score, and components (same shape as /score). Rows are ordered by timestamp DESC so index 0 is the most recent. timestamp is ISO-8601 UTC of the engine cycle that produced the row.

[
  {
    "timestamp": "2026-04-22T18:55:00Z",
    "composite_score": 63.42,
    "components": {
      "net_gex_sign":          {"max_points": 16, "contribution":  9.60, "score":  0.6},
      "gamma_anchor":          {"max_points": 30, "contribution": -2.10, "score": -0.07,
                                "context": {"flip_distance_subscore": 0.21,
                                            "local_gamma_subscore": -0.42,
                                            "price_vs_max_gamma_subscore": 0.17}},
      "put_call_ratio":        {"max_points": 12, "contribution":  2.40, "score":  0.2},
      "volatility_regime":     {"max_points":  6, "contribution": -0.08, "score": -0.013},
      "order_flow_imbalance":  {"max_points": 19, "contribution":  6.65, "score":  0.35},
      "dealer_delta_pressure": {"max_points": 17, "contribution":  3.40, "score":  0.2}
    }
  }
]

Page design. Line chart of composite_score over timestamp with shaded regime bands at 20/40/70. Stacked-area chart of component contribution values underneath shows which component flipped the regime.