FlashAlpha 历史数据 API（金融/量化）

每个 FlashAlpha 实时分析端点的历史时间点回放。覆盖范围：SPY 标的自 2018 年 4 月 16 日起完整回填，分辨率为 1 分钟（共 67 亿条期权记录）。其他标的符号支持按需回填（约需 48 小时）。所有端点均需使用 Alpha 级别 API 密钥；历史请求与实时请求共享每日配额额度。 关于响应结构的说明： 大多数历史响应与实时 API 的响应结构完全一致，因此同一套 SDK 代码仅需切换基础 URL 即可同时对接两者。少数响应存在差异，具体如下：`OptionQuoteResponse`（返回扁平化数组，而非封装对象）、`MaxPainResponse`（字段名为 `max_pain_by_expiration`，而非 `_by_expiry`）、`StockSummaryResponse`（包含嵌套的 `{value, change, change_pct}` 宏对象，并新增 `exposure.hedging_estimate.dealer_shares` 字段；该字段在独立端点 `/v1/exposure/summary` 中命名为 `dealer_shares_to_trade`）。请以本文件中定义的 Schema 为准，作为历史 API 的权威规范。 关于 `examples` 示例块： 每个操作均引用一个真实捕获的响应样本，位于 `https://flashalpha.com/docs/samples/historical-*.json`，该样本系从 `historical.flashalpha.com` 实时获取，并于 `at=2024-08-05T10:30:00`（即 2024 年 8 月波动率曲面展期 unwind 及 VIX 脉冲飙升期间）冻结存档。这些示例并非示意性或人工构造的数据——其中每个数值均为该时间戳下 API 实际返回的结果。它们可作为响应结构（SHAPE）的权威参考，亦可作为测试中可复现的固定时间点快照（point fixture），但显然不可视作对当前市场状态的预测。 实时 API 规范详见：https://lab.flashalpha.com/swagger/v1/swagger.json 或 https://flashalpha.com/docs/api.md。 完整可读式规范文档：https://flashalpha.com/docs/historical.md。