GammaCopilot — Logic Reference

Scout — Pre-Market Scanner

Scout runs before market open (or on-demand) against your saved basket. It fetches live quotes + nearest-expiry options data, then passes everything to Claude with a structured scoring prompt. Results are ranked by conviction and displayed in the left panel.

Data fetched per ticker

Field	Source	Used for
Last / Bid / Ask	Tradier REST quote	Current price, % change
Volume ratio	volume ÷ avg_volume	Unusual activity flag
ATM IV	Nearest expiry chain (greeks=true)	Volatility context
Nearest expiry date	Tradier expirations endpoint	0DTE vs weekly framing

Setup types Claude scores

Setup	What it means
0DTE Gamma Squeeze	Large call (or put) open interest near current price with same-day expiry. Market makers must delta-hedge aggressively as price approaches — can accelerate moves.
Support Retest	Price pulling back to a known level (PDH, PDC, R1, prior range). Watch for hold + bounce. Plays calls at support.
Resistance Break	Price approaching or breaking through a key resistance level with volume confirmation. Continuation bias.
Momentum Continuation	Strong pre-market gap or early trend with volume ratio > 1.5x. Bias to ride direction.
Avoid	No clear edge — choppy, low volume, or earnings risk within 5 days. Skip is a valid trade.

Conviction levels

Level	Criteria
High	Multiple confirming signals — level + volume + drift alignment. Clean setup with defined risk.
Medium	Setup present but one condition unclear — e.g. level held but volume below average.
Low	Speculative or early-stage. Only one signal. High uncertainty.

Note: Scout uses Claude to score setups — it is not a mechanical rules engine. The prompt instructs it to be selective and treat "skip" as the default. Earnings within 5 days are flagged because IV crush after the event changes the risk profile entirely.

Co-Pilot — Net Drift Calculation

Net drift measures signed options premium flow — how much dollar premium is being net bought vs net sold on calls and puts. It mirrors the QuantData convention: positive = net buying pressure, negative = net selling.

Core formula

flow = option_price × contracts × 100 # 1 contract = 100 shares signed_flow = +flow if aggressor == buy signed_flow = −flow if aggressor == sell call_drift += signed_flow for each call tape print put_drift += signed_flow for each put tape print net_drift = call_drift + put_drift

Aggressor classification

Each options tape print (timesale event) is classified as buyer- or seller-initiated:

Condition	Aggressor	Interpretation
Execution price ≥ bid/ask mid	Buy	Buyer lifted the offer — bullish for calls, bearish for puts
Execution price < bid/ask mid	Sell	Seller hit the bid — bearish for calls, bullish for puts (MM unhedges)
No bid/ask on print	Skip	Cannot determine direction — excluded from drift to avoid noise

TastyTrade mode: When BROKER=tastytrade, the aggressorSide field is provided directly in the DXLink TimeAndSale event (BUY / SELL / UNKNOWN). No inference needed — this is more accurate than the bid/ask comparison Tradier requires.

Bootstrap (mid-day entry)

When the Co-Pilot starts mid-session, drift is seeded from today's option chain so you see the full day's context, not just flow since you launched.

For each near-ATM option (±10% of spot) across 4 nearest expiries: open_px = option price at today's open last_px = option's most recent price if last_px > open_px → net bought → signed_flow = +(last_px × volume × 100) if last_px < open_px → net sold → signed_flow = −(last_px × volume × 100) if last_px == open_px → skip (direction unknown)

Known limitation: When the underlying moves significantly, delta drives all calls up and all puts down regardless of actual flow. The ±10% ATM filter reduces but does not eliminate this delta-noise in the bootstrap. Live tape prints (which use explicit aggressor) are not affected.

What the numbers mean

Reading	Interpretation
call_drift strongly positive put_drift near zero or negative	Net call buying + put selling = market makers buying stock to hedge. Bullish pressure.
put_drift strongly negative call_drift near zero	Aggressive put selling (income writers). MMs unhedge = buy stock. Also bullish.
call_drift negative put_drift strongly positive	Calls being sold, puts being bought. Bearish hedging. Defensive positioning.
Both near zero	Two-sided flow — no clear directional commitment from options market.

Symbols tracked

Subscription	Purpose
Underlying ticker (e.g. PLTR)	Stock quote + trade events for real-time price
Position OCC symbol (exact strike + expiry)	Tape feed for the card you're holding
~80 near-ATM OCC symbols across 4 weekly expiries	Broad drift signal — added in background after bootstrap

vs QuantData: Our drift uses the same signed premium-flow methodology. Magnitudes may differ slightly because QuantData may include different strike ranges or expiries. Direction should agree. The call/put ratio matters more than the absolute dollar figure.

Key levels used by Co-Pilot

Level	Full name	How calculated
PDH / PDL / PDC	Prior day high / low / close	Tradier daily OHLC, previous session
OVH / OVL	Overnight high / low	Extended hours high/low since prior close
R1 / S1	Pivot resistance / support	Standard floor pivot formula: P = (H+L+C)/3, R1 = 2P−L, S1 = 2P−H
Gap	Gap up / gap down	Today's open vs prior close. Direction + size in points and %