数据源与自动刷新
仪表盘默认会定时拉取免费公开数据并覆盖 14 项输入,然后重算压力指数、阶段判定与 Checklist。 本页说明每个字段的来源、时点口径、哪三项是换算值,以及断流时的降级行为。
1. 刷新是怎么走的
所有上游请求都在服务端完成(Cloudflare Pages Function),浏览器只与本站通信,因此不存在 CORS 问题,也不暴露任何 key。
同一字段同时有「收盘」与「盘中」两个候选值时,取日期更新的那个;日期相同一律用 CBOE 收盘值,保证同一天的数值口径一致。
2. 14 项字段的数据源
| 指标 | 字段 | 来源 | 更新频率 | 口径 |
|---|---|---|---|---|
| 30 天 VIX | vix | Yahoo ^VIX(优先)/ CBOE VIX_History.csv | 盘中约 1–5 分钟延迟 | 实时 |
| VVIX | vvix | Yahoo ^VVIX / CBOE VVIX_History.csv | 收盘后(约 16:15 ET) | 收盘 |
| CBOE SKEW | skew | Yahoo ^SKEW / CBOE SKEW_History.csv | 收盘后 | 收盘 |
| DSPX | dspx | Yahoo ^DSPX / CBOE DSPX_History.csv | 收盘后 | 收盘 |
| NVIDIA | nvda | Yahoo NVDA | 盘中约 1–5 分钟延迟 | 实时 |
| VIXEQ / VIX | vixeqVix | CBOE VIXEQ_History.csv ÷ 最新 VIX | 分子收盘、分母实时 | 派生 |
| VIX / VXV | vixVxv | CBOE VIX ÷ VIX3M(见第 4 节) | 收盘,VIX 盘中变动时折算 | 派生 |
| VIX9D / VIX | vix9dVix | CBOE VIX9D_History.csv ÷ 最新 VIX | 同上 | 派生 |
| 全市场 P/C | pcTotal | CBOE 每日市场统计 · TOTAL PUT/CALL RATIO | 收盘后,常为 T+1 | 收盘 |
| 指数 P/C | pcIndex | CBOE 每日市场统计 · INDEX PUT/CALL RATIO | 同上 | 收盘 |
| 个股 P/C | pcEquity | CBOE 每日市场统计 · EQUITY PUT/CALL RATIO | 同上 | 收盘 |
| SPX GEX | spxGex | SqueezeMetrics DIX.csv 的 gex 列 × 111.667 | 收盘后 | 换算 |
| Dealer Agg Gamma | dealerGamma | 上一行 × 0.0726 | 收盘后 | 换算 |
| Net Delta Flow | netDelta | 上一行 × 1.0945 | 收盘后 | 换算 |
3. 为什么有三项是「换算」而不是「官方」
做市商敞口(GEX、Dealer Gamma、Net Delta)在业界没有免费、统一、可复现的公开源:SpotGamma 等为付费产品, 各家的合约乘数、做市商方向假设、是否含 0DTE 都不同,绝对值不可跨源比较。因此本站在拿到 SqueezeMetrics 的公开 GEX 后, 用一个固定比例因子把它映射到本模型的单位,并在界面上明确标注为「换算」。
这个做法的含义是:保留符号与相对变化(做市商翻空/翻多的时点、深度变化),并让阈值(-50 / -8.6)在锚点日上仍然成立; 但它不是三条独立观测,而是同一个 GEX 序列的三个刻度。这一点与 方法论中"三项高度共线、不可当三个信号计数"的告诫完全一致。
当锚点日的上游值发生历史修订时,比例因子会随之漂移;接口返回里 meta.gex 会给出当次的原始值与所用 k,便于核对。
4. 为什么用 VIX3M 代替 VXV
CBOE 的 VXV_History.csv 目前返回 403(对象不存在/权限关闭),而 VXV(3 个月 SPX 隐含波动率)与
VIX3M 是同一期限的官方指数,数值可直接互换。因此 vixVxv 现在按 VIX ÷ VIX3M 计算。
如果你的数据商提供的是 VXV,把 functions/api/market.js 里的 VIX3M 换成 VXV 即可,其余逻辑不变。
5. 比率的时点口径:保证图表自洽
三个比率都是"分子只在收盘更新、分母可能盘中跳动"。如果直接用收盘比值,图表上的三个点位会与 vix 当前值矛盾。
因此服务端在 VIX 拿到盘中值时,按下面的方式重算,使 VXV = VIX ÷ ratio 恒成立:
这也是为什么盘中时段你会看到比率轻微漂移、而期限结构图的两个远端点位保持不动——那不是 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 } 这个结构,不需要同步改动。