This project develops a signal-generating diagnostic framework for identifying where market stress and downside hedging pressure may be concentrating, using option market structure as the analytical lens.
Rather than producing forecasts or trading rules, the framework focuses on mapping stress concentration by decomposing put–call ratios into short-term hedging flow, embedded positioning, and term-structure placement across expirations.
The output consists of interpretable signals designed to highlight where stress may be building, at which maturities, and whether current activity is reinforcing or diverging from existing exposure. These signals are intended to inform broader market analysis and risk assessment, not to serve as standalone conclusions.
The analysis uses listed index ETF options, sourced live from public option chain data.
Covered underlyings include:
These instruments are selected for their liquidity, depth across expirations, and relevance for assessing both broad market and sector-specific stress dynamics.
All outputs are snapshots at the time of execution. The framework does not construct historical datasets or perform backtests.
The framework computes multiple complementary metrics. Each captures a different dimension of market stress.
Two distinct put–call ratios are computed.
Keeping these measures separate allows the framework to distinguish new hedging activity from existing risk inventory.
Divergencevol−OI = PCRvol − PCROI
This metric compares current flow to existing positioning.
General signal interpretation:
Impulsevol/OI = PCRvolPCROI
This ratio measures how aggressive current hedging activity is relative to embedded positioning.
General interpretation guidelines:
These thresholds are context-dependent and should be calibrated against historical distributions for reliable interpretation.
EventScorei = (TotalOIiΣj TotalOIj) × PCROI,i
This metric combines:
General interpretation:
Signals are computed at the individual expiration level, preserving full granularity across the option curve.
As an additional summary layer, expirations are aggregated into non-overlapping maturity buckets:
Bucketed summaries provide a high-level view of whether stress is concentrated in the near term or extending further along the curve. The per-expiry signals remain the primary analytical output.
Loads the latest saved SPY (S&P 500) options snapshot generated offline from Yahoo Finance data. It aggregates put/call volume and open interest across expirations, computes diagnostic signals (Volume PCR, OI PCR, Impulse, Divergence, Event Score), and shows ranked tables and plots of where downside hedging pressure and positioning are most concentrated. Results are fixed to the timestamp below and do not update automatically. For generating a new snapshot (or running the full multi-index version), use the GitHub link at the top of this page to access the code and reproduce the latest outputs.