FlashAlpha Historical API
Point-in-time replay of every FlashAlpha live analytics endpoint. Coverage: SPY fully backfilled from 2018-04-16 at 1-minute resolution (6.7B option rows). Other symbols backfill on demand (~48h). All endpoints require Alpha-tier API key; historical requests share the live daily quota bucket. Note on response shapes: most historical responses match the live API shape exactly so the same SDK code works against both with a base-URL swap. A few responses diverge from live — see the schemas for `OptionQuoteResponse` (flat array, not wrapped object), `MaxPainResponse` (`max_pain_by_expiration`, not `_by_expiry`), `StockSummaryResponse` (nested `{value, change, change_pct}` macro objects, plus an `exposure.hedging_estimate.dealer_shares` field that is named `dealer_shares_to_trade` on the standalone `/v1/exposure/summary` endpoint). Treat the schemas in this file as authoritative for historical. About the `examples` blocks: every operation references a real captured response under `https://flashalpha.com/docs/samples/historical-*.json`, fetched live from `historical.flashalpha.com` and frozen at `at=2024-08-05T10:30:00` (the August 2024 carry-unwind / VIX spike). They are NOT illustrative or fabricated — every numeric value is what the API actually returned for that timestamp. Treat them as authoritative for the SHAPE of a response and as a reproducible point fixture for tests, but obviously not as predictions of current market state. For the live API spec, see https://lab.flashalpha.com/swagger/v1/swagger.json or https://flashalpha.com/docs/api.md. Full human-readable spec: https://flashalpha.com/docs/historical.md.
