A personal knowledge base for understanding the S&P 500 options market and its impact on ES futures trading. Built from the perspective of a retail ES futures trader who trades intraday to 1-3 day holds with 15-30 point profit targets.
The project contains 7 analysis documents, 27 Python-generated charts, and an AI agent system for ongoing research.
| # | Document | Lines | Charts | What It Covers |
|---|---|---|---|---|
| 1 | Market Structure Full Analysis | ~523 | -- | Who the 7 market participant types are, what they do, and how their actions shape ES price action |
| 2 | How Options and Greeks Actually Work | ~500+ | 13 | Visual deep dive into options pricing, delta/gamma/theta/vega behavior, 0DTE dynamics, pin risk |
| 3 | Options Strategy Primer | ~695 | -- | 11 options structures with Greek profiles, ES flow signatures, and three-regime framework |
| 4 | Options Strategies Visual Guide | ~700+ | 14 | P&L payoff charts and Greek dashboards for 7 core strategies + 4 lighter treatments |
| 5 | Options as Stop-Loss Alternatives | ~499 | -- | 7 strategies for using options instead of stop losses, with premium tables and a tiered recommendation |
| 6 | Catastrophic Risk Protection | ~760 | -- | 10 cost-reduction strategies for tail-risk hedging, crash scenario analysis, rolling mechanics |
Reference: SPX_OPTIONS_MARKET_STRUCTURE.md -- compact bullet-point source for document #1.
- The collar is the clear winner for catastrophic protection -- selling a call 100-150 pts above entry easily funds a put 300 pts below at zero cost.
- Every strategy is either paying theta to own gamma, or earning theta while being short gamma. There is no free lunch.
- Put skew is significant. Deep OTM S&P 500 puts trade at 20-30% IV vs 15% ATM. All pricing in these documents incorporates skew.
- Greeks are additive across legs -- this single principle unlocks all multi-leg strategy analysis.
financials-analysis/
|
|-- README.md
|
|-- Analysis Documents (project root)
| |-- SPX_OPTIONS_MARKET_STRUCTURE_FULL_ANALYSIS.md
| |-- HOW_OPTIONS_AND_GREEKS_ACTUALLY_WORK.md
| |-- OPTIONS_STRATEGY_PRIMER_FOR_ES_TRADERS.md
| |-- OPTIONS_STRATEGIES_VISUAL_GUIDE.md
| |-- OPTIONS_AS_STOP_LOSS_ALTERNATIVES_FOR_ES_TRADERS.md
| |-- CATASTROPHIC_RISK_PROTECTION_WITHOUT_STOP_LOSSES.md
|
|-- scripts/ # Python chart generation scripts
| |-- chart_strategy_*.py # Strategy visual guide charts (14)
| |-- chart_delta_profiles.py # Greeks document charts (13)
| |-- chart_gamma_*.py
| |-- chart_theta_*.py
| |-- chart_vega_*.py
| |-- ...
|
|-- outputs/
| |-- charts/ # Greeks document charts (13 PNGs)
| |-- charts/strategies/ # Strategy guide charts (14 PNGs)
| |-- research_reports/
| |-- quick_answers/
|
|-- agents/ # AI agent system
| |-- prompts/ # 6 agent configurations
| |-- workflows/
| |-- tools/
| |-- templates/
|
|-- knowledge_base/
| |-- catalog.md # Searchable document index (v4.0)
| |-- primary/
| |-- supplementary/
|
|-- .venv/ # Python environment
13 charts illustrating options pricing and Greek behavior:
- Put/call payoff diagrams, value curves before vs at expiration
- Delta S-curves across expirations, gamma bell curves and explosion near expiry
- Theta decay curves, theta vs strike profiles
- Vega profiles, volatility skew visualization
- Greek interaction scenarios (quiet day vs crash)
- 4-panel Greek dashboard, expiration transformation, pin risk gamma spike
14 charts covering multi-leg strategy analysis:
| Chart | Description |
|---|---|
multi_leg_greek_addition.png |
Educational: call delta + put delta = straddle delta |
straddle_pnl.png |
Long straddle P&L at expiration and 10 DTE |
straddle_greeks.png |
4-panel Greek dashboard (delta, gamma, theta, vega) |
strangle_pnl.png |
Long strangle P&L at expiration and 10 DTE |
put_spread_pnl.png |
Bear put spread P&L |
call_spread_pnl.png |
Bull call spread P&L |
iron_condor_pnl.png |
Short iron condor "mesa" payoff |
iron_condor_greeks.png |
4-panel: short gamma, positive theta in center |
collar_pnl.png |
Collar P&L vs naked ES |
collar_greeks.png |
4-panel: delta bounded from constant 1.00 |
covered_call_pnl.png |
Covered call P&L vs naked ES |
calendar_spread_pnl.png |
Calendar put spread at front-month expiry |
strategy_risk_reward_comparison.png |
All 7 strategies: max loss vs max profit |
strategy_theta_gamma_tradeoff.png |
Scatter: every strategy picks a side |
Six-agent architecture for conducting ongoing research:
- Senior Market Analyst -- Orchestrator and final approver
- Task Manager -- Research coordinator
- Market Researcher -- Qualitative analysis specialist
- Quantitative Analyst -- Data and numbers expert
- Report Reviewer -- QA and synthesis specialist
- Quantitative Visualization Analyst -- Chart generation (Black-Scholes pricing, Greek calculations, consistent visual standards)
See agents/README.md for full documentation.
Charts are generated using Python with matplotlib, numpy, and scipy.
# Activate the virtual environment
source .venv/bin/activate
# Run any chart script
MPLCONFIGDIR=/tmp/mpl_config python3 scripts/chart_strategy_straddle_pnl.pyDependencies: matplotlib 3.10.8, numpy 2.4.2, scipy 1.17.0
Baseline assumptions used across all scripts: ES ~6,100, VIX ~15, risk-free rate 4.5%, ES multiplier $50/point.
knowledge_base/catalog.md (v4.0) provides:
- Full metadata for all 7 documents
- Topic-based cross-reference index
- Recommended reading order
- Common question lookup table
- Chart inventory with descriptions
All analysis uses consistent baseline parameters:
| Parameter | Value |
|---|---|
| ES price | ~6,100 |
| VIX | ~15 |
| ATM implied volatility | 15% (annualized) |
| Risk-free rate | 4.5% |
| ES multiplier | $50 per point |
| Put skew | +0.02% IV per point OTM |
| Trading style | Intraday to 1-3 day holds, 15-30 pt targets |
New to this knowledge base?
- Start with Market Structure Full Analysis to understand who moves the market
- Read How Options and Greeks Actually Work to build visual intuition
- Use Options Strategies Visual Guide to see how strategies create their payoff shapes
- Apply with Options as Stop-Loss Alternatives for practical risk management
Looking for something specific? Check knowledge_base/catalog.md -- the topic index maps common questions to exact document sections.