INSTITUTIONAL MONITOR 美股期权微观结构与流动性踩踏监控
Data Sources

数据源与自动刷新

仪表盘默认会定时拉取免费公开数据并覆盖 14 项输入,然后重算压力指数、阶段判定与 Checklist。 本页说明每个字段的来源、时点口径、哪三项是换算值,以及断流时的降级行为。

这些源均为免费公开、非交易级数据:Yahoo 为未公开文档的接口,CBOE 只提供收盘后更新,P/C 常为 T+1。 适合做结构性复盘与压力测试,不要用于实盘下单的价格判断。

1. 刷新是怎么走的

所有上游请求都在服务端完成(Cloudflare Pages Function),浏览器只与本站通信,因此不存在 CORS 问题,也不暴露任何 key。

浏览器(每 60s,页面可见时) └─ GET /api/market ← 边缘缓存 60s(命中约 20–30ms) ├─ CBOE 日线 CSV × 7 ← VIX / VIX9D / VIX3M / VVIX / SKEW / DSPX / VIXEQ ├─ Yahoo chart × 6 ← ^VIX / ^VIX9D / ^VVIX / ^SKEW / ^DSPX / NVDA ├─ CBOE 每日市场统计页 × 1 ← TOTAL / INDEX / EQUITY PUT/CALL RATIO └─ SqueezeMetrics DIX.csv × 1 ← GEX(date,price,dix,gex) └─ 合并 → 每字段带 {value, source, mode, ts} → 写入 state → updateDashboard()

同一字段同时有「收盘」与「盘中」两个候选值时,取日期更新的那个;日期相同一律用 CBOE 收盘值,保证同一天的数值口径一致。

2. 14 项字段的数据源

指标字段来源更新频率口径
30 天 VIXvixYahoo ^VIX(优先)/ CBOE VIX_History.csv盘中约 1–5 分钟延迟实时
VVIXvvixYahoo ^VVIX / CBOE VVIX_History.csv收盘后(约 16:15 ET)收盘
CBOE SKEWskewYahoo ^SKEW / CBOE SKEW_History.csv收盘后收盘
DSPXdspxYahoo ^DSPX / CBOE DSPX_History.csv收盘后收盘
NVIDIAnvdaYahoo NVDA盘中约 1–5 分钟延迟实时
VIXEQ / VIXvixeqVixCBOE VIXEQ_History.csv ÷ 最新 VIX分子收盘、分母实时派生
VIX / VXVvixVxvCBOE VIX ÷ VIX3M(见第 4 节)收盘,VIX 盘中变动时折算派生
VIX9D / VIXvix9dVixCBOE VIX9D_History.csv ÷ 最新 VIX同上派生
全市场 P/CpcTotalCBOE 每日市场统计 · TOTAL PUT/CALL RATIO收盘后,常为 T+1收盘
指数 P/CpcIndexCBOE 每日市场统计 · INDEX PUT/CALL RATIO同上收盘
个股 P/CpcEquityCBOE 每日市场统计 · EQUITY PUT/CALL RATIO同上收盘
SPX GEXspxGexSqueezeMetrics DIX.csv 的 gex 列 × 111.667收盘后换算
Dealer Agg GammadealerGamma上一行 × 0.0726收盘后换算
Net Delta FlownetDelta上一行 × 1.0945收盘后换算

3. 为什么有三项是「换算」而不是「官方」

做市商敞口(GEX、Dealer Gamma、Net Delta)在业界没有免费、统一、可复现的公开源:SpotGamma 等为付费产品, 各家的合约乘数、做市商方向假设、是否含 0DTE 都不同,绝对值不可跨源比较。因此本站在拿到 SqueezeMetrics 的公开 GEX 后, 用一个固定比例因子把它映射到本模型的单位,并在界面上明确标注为「换算」。

锚点(原始快照日 2026-11-19): 本模型 SPX GEX = -100.5 $B / 1% SqueezeMetrics GEX = -0.900B $ / 1% (CSV 原始值 -900,000,756.19) 换算系数 k = -100.5 ÷ (-0.900) = 111.667 spxGex = (smGex ÷ 1e9) × 111.667 dealerGamma = spxGex × (7.3 ÷ 100.5) = spxGex × 0.0726 netDelta = spxGex × (110 ÷ 100.5) = spxGex × 1.0945

这个做法的含义是:保留符号与相对变化(做市商翻空/翻多的时点、深度变化),并让阈值(-50 / -8.6)在锚点日上仍然成立; 但它不是三条独立观测,而是同一个 GEX 序列的三个刻度。这一点与 方法论中"三项高度共线、不可当三个信号计数"的告诫完全一致。

当锚点日的上游值发生历史修订时,比例因子会随之漂移;接口返回里 meta.gex 会给出当次的原始值与所用 k,便于核对。

4. 为什么用 VIX3M 代替 VXV

CBOE 的 VXV_History.csv 目前返回 403(对象不存在/权限关闭),而 VXV(3 个月 SPX 隐含波动率)与 VIX3M 是同一期限的官方指数,数值可直接互换。因此 vixVxv 现在按 VIX ÷ VIX3M 计算。

2026-11-19 收盘:VIX 28.44,VIX3M 27.03 → 1.052(四舍五入 1.05) 对照仪表盘原始快照的 1.05,口径一致。

如果你的数据商提供的是 VXV,把 functions/api/market.js 里的 VIX3M 换成 VXV 即可,其余逻辑不变。

5. 比率的时点口径:保证图表自洽

三个比率都是"分子只在收盘更新、分母可能盘中跳动"。如果直接用收盘比值,图表上的三个点位会与 vix 当前值矛盾。 因此服务端在 VIX 拿到盘中值时,按下面的方式重算,使 VXV = VIX ÷ ratio 恒成立:

vixVxv = vix_live ÷ VIX3M_close vix9dVix = VIX9D_close ÷ vix_live vixeqVix = VIXEQ_close ÷ vix_live 由此:图上 VXV = vix_live ÷ vixVxv = VIX3M_close (保持不变,符合事实) 图上 VIX9D = vix_live × vix9dVix = VIX9D_close (保持不变)

这也是为什么盘中时段你会看到比率轻微漂移、而期限结构图的两个远端点位保持不动——那不是 bug,是数据源本身只更新收盘值。

6. 刷新、缓存与降级

  • 客户端:进入页面立即拉一次,此后每 60 秒一次;标签页隐藏时暂停,回到前台若距上次超过 60 秒立即补拉。
  • 边缘缓存:/api/market 的响应缓存 60 秒,多人同时打开页面只有第一个请求会打上游(命中时约 20–30ms,未命中约 1.5–2.5s)。
  • 部分失败:某个源挂了只会让对应字段缺失(或回退到收盘值),其余字段照常刷新;状态条会显示"n 条降级提示"。
  • 整体失败:状态条转为红色"取数失败 · 仍在显示 x 分钟前的数据",页面不会空白,也不会把数值清零。
  • 量程保护:任何字段若超出滑块量程(例如 SKEW 冲到 190 > 185),会被截断到量程边缘并弹提示,避免滑块与数字不一致。
  • 状态标记:状态条区分"实时(部分盘中)/ 收盘数据 / 数据不完整",并用三个点颜色区分绿(盘中)、蓝(收盘)、红(失败)。

7. 已知限制

限制影响应对
Yahoo 为非官方接口可能随时改字段、限流或对机房 IP 返回 401失败自动回退 CBOE 收盘值;状态条会标记降级
CBOE 只在收盘后更新盘中除 VIX / NVDA 外,其余字段是昨日收盘状态条按字段统计"盘中 x 项 / 收盘 y 项"
P/C 常为 T+1流量维度可能比价格慢一个交易日判读时以"结构"而非"当日"为准,见复盘手册
GEX 为换算值绝对值不可与 SpotGamma 等直接对照只看符号与相对变化;阈值仅在锚点口径下有效
节假日/半日市最新收盘日可能比"昨天"更早状态条显示的是数据自带日期,不是日历日期
时区所有时间按浏览器本地时区显示数据本身均为美东收盘口径

8. 关闭自动刷新与回退到快照

  • 点状态条上的「自动刷新:开/关」即可停止轮询(开关状态存在 localStorage,下次打开仍生效);关闭后当前数值保留,可继续手动拖动推演。
  • 点「立即刷新」做一次强制拉取(仍受 60 秒边缘缓存限制)。
  • 点仪表盘右上角的「重置为 11/19 实盘数据」可随时回到原始快照,用于对照或演示。
  • 若把站点部署成纯静态(不带 functions/),页面会自动显示"取数失败",退化为原来的静态快照模式,其余功能不受影响。

需要更细的口径(例如把 P/C 换成 5 日均值、把 GEX 换成自建估算),改 functions/api/market.js 即可, 前端只认 { value, source, mode, ts } 这个结构,不需要同步改动。

继续阅读

字段的金融含义见指标词典; 刷新后数值如何进入公式见计算规则; 拿到实时数据后怎么用见复盘手册。