FlashAlpha Logo
ALPHA HISTORICAL

Historical Coverage Endpoint — /v1/tickers

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. Requires an Alpha-tier API key (passed as X-Api-Key); historical replay shares the live daily request bucket.

Endpoint

GET /v1/tickers
Host: historical.flashalpha.com Auth: X-Api-Key Tier: Alpha

Parameters

NameInRequiredDescription
symbolquerynoFilter to a single ticker (returns single object, not wrapped). 404 no_coverage if never backfilled.
 
curl -H "X-Api-Key: YOUR_ALPHA_KEY" https://historical.flashalpha.com/v1/tickers

Response Schema

{
  "count": 1,
  "tickers": [
    {
      "symbol": "SPY",
      "coverage": {
        "first": "2018-04-16",
        "last":  "2026-04-02",
        "total_days":   2909,
        "healthy_days": 1972
      },
      "tables": {
        "stocks_days":     2009,
        "options_days":    1972,
        "option_eod_days": 2006,
        "svi_days":        1972
      },
      "gaps": {
        "missing_eod":         3,
        "missing_svi":         36,
        "uncovered_calendar":  3
      },
      "updated_at": "2026-04-14T07:07:36"
    }
  ]
}
FieldMeaning
coverage.first / coverage.lastDate range of fully healthy days (intersection of stocks ∩ options ∩ option_eod ∩ svi_daily)
coverage.healthy_daysTrading days on which every downstream table has data
tables.*_daysPer-source day counts — debug signal when something is behind
gaps.missing_eodDays 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.
gaps.missing_sviDays in option_eod without an SVI fit
gaps.uncovered_calendarNYSE trading days never pulled at all (genuine holidays — e.g. 2018-12-05 Bush funeral, 2025-01-09 Carter funeral)
updated_atUTC timestamp of the last pipeline quality-report run