---
title: "Get Score History"
method: GET
path: "/api/signals/score-history"
tags: ["Trade Signals"]
---

# Get Score History

`GET /api/signals/score-history`

## Request

- Base URL: `https://api.zerogex.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.zerogex.io/api/signals/score-history`
- Auth: HTTP bearer

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.

```json
[
  {
    "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.

## Query parameters

- `underlying` string
- `limit` integer
- `lookback_days` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zerogex/apis/zerogex-api.md) · [All operations](https://skmtc.dev/zerogex/apis/zerogex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zerogex/apis/zerogex-api/revisions/03b8b80a6cd5?raw)