1. 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.

HISTORICAL

Endpoint

GET /v1/tickers
Host: historical.flashalpha.com No auth required Rate Limited: No Public

Parameters

NameInTypeRequiredDefaultDescription
symbolquerystring-Filter to a single ticker (returns single object, not wrapped). 404 no_coverage if never backfilled.
Public route. Unlike the other historical routes, which need Alpha or higher, 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.

GET

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

FieldTypeDescription
countnumberNumber of items returned
tickersarrayOne entry per ticker - see Fields of tickers[] below
endpoint_version, data_as_of, archive_as_ofstring, objectResponse envelope, see Response envelope.

Fields of tickers[]

Field Type Description
tickers[].symbolstringUnderlying symbol
tickers[].has_flowbooleanTickers: has flow
tickers[].coverageobjectTickers: coverage
tickers[].coverage.total_daysnumberCoverage: total days
tickers[].coverage.firststringDate range of fully healthy days (intersection of stocks ∩ options ∩ option_eod ∩ svi_daily)
tickers[].coverage.laststringDate range of fully healthy days (intersection of stocks ∩ options ∩ option_eod ∩ svi_daily)
tickers[].coverage.healthy_daysnumberTrading days on which every downstream table has data
tickers[].tablesobjectTickers: tables
tickers[].tables.stocks_daysnumberDay count for the stocks source - debug signal when something is behind
tickers[].tables.options_daysnumberDay count for the options source - debug signal when something is behind
tickers[].tables.option_eod_daysnumberDay count for the option end-of-day source - debug signal when something is behind
tickers[].tables.svi_daysnumberDay count for the SVI source - debug signal when something is behind
tickers[].gapsobjectTickers: gaps
tickers[].gaps.missing_eodnumberDays 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_svinumberDays in option_eod without an SVI fit
tickers[].gaps.uncovered_calendarnumberNYSE trading days never pulled at all (genuine holidays - e.g. 2018-12-05 Bush funeral, 2025-01-09 Carter funeral)
tickers[].updated_atstringUTC timestamp of the last pipeline quality-report run

Errors

Status Error When
404no_coverageSymbol was never backfilled.

Related reading