- Historical Replay
- Replay Reference
- Coverage Endpoint
Historical Coverage Endpoint API
Query the coverage manifest programmatically: every symbol with historical options coverage, its date range, healthy-day count, and data-quality gaps. For the human-readable live table see Current Coverage. No API key needed for this route; the other historical routes need an Alpha plan key (passed as X-Api-Key) and share the live daily request bucket.
Endpoint
historical.flashalpha.com
No auth required
Rate Limited: No
Public
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
symbol | query | string | - | Filter to a single ticker (returns single object, not wrapped). 404 no_coverage if never backfilled. |
GET /v1/tickers answers without an API key.
Request
curl -H "X-Api-Key: YOUR_API_KEY" \
"https://historical.flashalpha.com/v1/tickers"import requests
resp = requests.get(
"https://historical.flashalpha.com/v1/tickers",
headers={"X-Api-Key": "YOUR_API_KEY"}
)
resp.raise_for_status()
data = resp.json()
for t in data["tickers"]:
print(t["symbol"], t["coverage"]["first"], t["coverage"]["last"])const resp = await fetch(
"https://historical.flashalpha.com/v1/tickers",
{ headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
for (const t of data.tickers) console.log(t.symbol, t.coverage.first, t.coverage.last);Try it live
Replays archived data as of the at time you pick (ET wall-clock). Needs an Alpha plan API key.
Response
{
"count": 209,
"tickers": [
{
"symbol": "AA",
"has_flow": false,
"coverage": {
"first": "2026-06-02",
"last": "2026-10-29",
"total_days": 150,
"healthy_days": 105
},
"tables": {
"stocks_days": 105,
"options_days": 105,
"option_eod_days": 105,
"svi_days": 105
},
"gaps": {
"missing_eod": 0,
"missing_svi": 0,
"uncovered_calendar": 0
},
"updated_at": "2026-10-30T05:01:27.177369"
},
{
"symbol": "AAL",
"has_flow": false,
"coverage": {
"first": "2018-01-02",
"last": "2026-10-29",
"total_days": 3223,
"healthy_days": 2217
},
"tables": {
"stocks_days": 2219,
"options_days": 2219,
"option_eod_days": 2219,
"svi_days": 2217
},
"gaps": {
"missing_eod": 0,
"missing_svi": 2,
"uncovered_calendar": 0
},
"updated_at": "2026-10-30T05:01:34.065102"
}
],
"endpoint_version": "2026.09.30",
"data_as_of": {
"node": "f3",
"equity_feed": null,
"equity_options_feed": null,
"index_feed": null,
"index_options_feed": null,
"futures_feed": null,
"futures_options_feed": null,
"flow_feed": null,
"oi_feed": null,
"macro_feed": null
},
"archive_as_of": {
"node": "f3",
"equity_feed": null,
"equity_options_feed": null,
"index_feed": null,
"index_options_feed": null,
"futures_feed": null,
"futures_options_feed": null,
"flow_feed": null,
"oi_feed": null,
"macro_feed": null
}
}Sending request…
See this endpoint on archived data
Send this exact request and the real response shows up here, right next to the example.
Response Fields
| Field | Type | Description |
|---|---|---|
count | number | Number of items returned |
tickers | array | One entry per ticker - see Fields of tickers[] below |
endpoint_version, data_as_of, archive_as_of | string, object | Response envelope, see Response envelope. |
Fields of tickers[]
| Field | Type | Description |
|---|---|---|
tickers[].symbol | string | Underlying symbol |
tickers[].has_flow | boolean | Tickers: has flow |
tickers[].coverage | object | Tickers: coverage |
tickers[].coverage.total_days | number | Coverage: total days |
tickers[].coverage.first | string | Date range of fully healthy days (intersection of stocks ∩ options ∩ option_eod ∩ svi_daily) |
tickers[].coverage.last | string | Date range of fully healthy days (intersection of stocks ∩ options ∩ option_eod ∩ svi_daily) |
tickers[].coverage.healthy_days | number | Trading days on which every downstream table has data |
tickers[].tables | object | Tickers: tables |
tickers[].tables.stocks_days | number | Day count for the stocks source - debug signal when something is behind |
tickers[].tables.options_days | number | Day count for the options source - debug signal when something is behind |
tickers[].tables.option_eod_days | number | Day count for the option end-of-day source - debug signal when something is behind |
tickers[].tables.svi_days | number | Day count for the SVI source - debug signal when something is behind |
tickers[].gaps | object | Tickers: gaps |
tickers[].gaps.missing_eod | number | Days with stock data but no option_eod row. Affects only EOD-stamped derived fields (SVI surface, term VRP percentiles, EOD at=yyyy-MM-dd calls); minute-resolution analytics on those days remain queryable. |
tickers[].gaps.missing_svi | number | Days in option_eod without an SVI fit |
tickers[].gaps.uncovered_calendar | number | NYSE trading days never pulled at all (genuine holidays - e.g. 2018-12-05 Bush funeral, 2025-01-09 Carter funeral) |
tickers[].updated_at | string | UTC timestamp of the last pipeline quality-report run |
Errors
| Status | Error | When |
|---|---|---|
404 | no_coverage | Symbol was never backfilled. |
Use This Coverage With
- Current Coverage - live human-readable table of every covered symbol
- Historical GEX - gamma exposure by strike, replayable at any minute
- Historical VRP - leak-free volatility risk premium percentiles
- Historical Max Pain - pain curve and pin probability
- Historical Stock Summary - composite snapshot (price, IV, exposure, macro)
- Historical API overview →
Related reading
- Complete guide to quant options backtesting - end-to-end backtest workflow
- Replaying GEX, VRP & dealer positioning - building studies across the covered universe