Gamma-Map — Explainable Gamma-Concentration Maps

Standalone, broker-neutral library that turns an option-chain snapshot
into an explainable gamma-concentration map
For education and paper-trading research — not a trading recommendation

What it provides

A normalized OptionContract model that works with Schwab, E*TRADE, TradeStation, or any option-chain provider.
Per-strike call and put gamma concentration from gamma, open interest, the contract multiplier, and the underlying spot — plus each strike's own call/put delta, OI, and volume.
A dependency-free dark SVG chart sized for a Discord embed, and a light/dark-aware standalone HTML page with hover tooltips and a "Table view."
A second chart — combined Open Interest vs Volume per strike — so standing positioning versus today's actual activity reads at a glance.
Optional Discord delivery: one message — header → gamma chart → OI/Volume chart → strike table.

Important terminology

This library reports estimated gamma concentration, not a definitive dealer gamma wall. Open interest does not disclose who owns each contract or the market-maker hedge direction. Any signed dealer-GEX model must state and test its assumptions separately.

Open Interest vs Volume

OI is the standing/static positioning at a strike; Volume is today's actual trading activity there. A Volume bar reaching or poking above its OI bar flags unusually heavy same-day activity relative to what was already parked — not just an old static wall.

Reproducibility

A timestamped raw snapshot is persisted alongside every derived map. That makes the Discord posts reproducible and lets paper-trading results be evaluated against the exact levels visible at entry time.

Live data

The core library has no dependency on any broker SDK — it consumes OptionContract objects however you obtain them. A companion example fetches a live Schwab option chain (with a yfinance fallback for price data — note yfinance has no per-contract greeks, so a yfinance-sourced chain carries only OI/Volume/IV, not delta/gamma), renders it with delta markers and the OI-vs-Volume chart, and optionally delivers it to Discord. On the TastyDayTraders stack this runs on a schedule to post the SPX gamma map through the day.

Disclaimer

For educational and paper-trading research only. Not financial advice.

← About