兼容性政策
- 非破坏性变更随时发生：新增端点、新增响应字段、新增可选参数。你的解析代码应忽略未知字段。
- 正式开放（GA）的破坏性变更提前 90 天预告：删除/重命名字段或端点、改变既有字段语义。预告在本页发布并注明生效日期。
- Preview / Beta 契约校正：尚处正式契约冻结前的端点可在本页公告后直接校正；公告必须明确旧契约、替代契约与生效条件。
- 运行时的权威能力目录始终是
GET /v1/discover（见目录总览）。
记录
单合约与批量期权最新报价
- 新增
GET /v1/options/quote/{contract}与GET /v1/options/quotes?contracts=...，MCP command 为options.quote/options.quotes。批量最多 50 项，同一请求内重复合约只返回一次。 - 返回买价、卖价、中间价与报价时间
quoted_at。报价可能早于请求时间，请按该时间判断是否适用，详见报价说明。 - 批量支持部分成功：成功项在
quotes，失败项在unavailable；重试方式见错误处理。 - 每份成功合约报价计 1 unit，失败项计 0；重复查询相同价格仍计费，详见配额规则。
2026-09-22 — Flow、历史整链 Greeks 与大型集合分页
- 新增 flow 数据域：11 个 REST/MCP 只读能力覆盖成交流筛选、标的榜单与概览、合约目录、精确合约查询、分钟 bars/bucket 和最多 30 个交易日的合约历史。全部能力包含于有效的 Nightwatch 订阅。
flow.contract_lookup现在可以找到当日已经出现 Flow 活动、但尚未进入按到期日合约目录的新合约；路径、参数与响应字段不变。- 新增
options.chain_greeks_history：按 ticker、到期日、Call/Put、日期范围与 interval 查询整条期权链的历史 IV/Greeks，并附带窗口起点的 OI 快照。 options.chain_snapshot每个合约新增quoted_at报价水位，并与options.contract_volume_profile一起支持limit/ cursor 分页。完整数量、当前页数量、_meta.truncated与_meta.next_cursor让调用方可以逐页取回完整集合。- 新增
market.options_volume_rank：当日期权成交量固定 Top 150，包含 Call/Put 成交量与总量、Call、Put 三组 OI 变化。
2026-08-13 — Dealer 公共投影收窄（Beta 契约校正）
Dealer GEX 与 Dealer Heatmap 的公共契约调整为固定五分钟采样与 Top 节点窄投影；浏览器产品页面不受影响。 生效条件：对应 Dealer 公共投影版本正式发布。发布前继续以当前运行时 OpenAPI 与GET /v1/discover 为准；两者出现下述新契约即表示变更已经生效。
- Dealer GEX snapshot/history：完整分钟级行权价分布改为最多五个产品可见节点；删除逐节点 call/put 分解；history 改为最近三个 NYSE 交易时段，默认/最大
limit=78。 - Dealer Heatmap snapshot：完整网格改为每个到期日正 Top 10 + 负 Top 10；删除完整 strike 轴、call/put 分解、行聚合、比例尺、状态诊断与
format参数。 - Dealer Heatmap history：
/v1/derived/heatmap/{ticker}/cell-history替换为/v1/derived/heatmap/{ticker}/history；MCP command 从derived.dealer_heatmap_cell_history替换为derived.dealer_heatmap_history；查询从expiration + strike改为只需expiration，默认/最大limit=24。 - 两类数据都按已完成五分钟段固定读取末一分钟；末分钟缺失时不回退、不插值、不补零。
- Hosted MCP 的
dealer_gex_snapshot、dealer_gex_history与dealer_heatmap_snapshot同步采用上述窄投影；Heatmap 历史通过derived.dealer_heatmap_historycommand 查询。