Skill

Analyze Options Flow with Real vs Lottery Separation

Separates real vs lottery options calls to fix misleading put/call ratios, using Polygon.io data.

Works with polygon.io

91
Spark score
out of 100
Updated today
Version 15.7.0

Add to Favorites

Why it matters

Gain deeper insights into options market sentiment by distinguishing between genuine hedging activity and speculative 'lottery ticket' trades, preventing misinterpretations of raw put/call ratios.

Outcomes

What it gets done

01

Separate 'real' options trades from speculative 'lottery' trades based on premium and strike price.

02

Calculate an adjusted Put/Call ratio that excludes speculative noise.

03

Detect anomalies in options flow, such as P/C ratio shifts, call open interest surges, and IV spikes.

04

Classify overall sentiment (Bullish/Bearish/Neutral) with confidence based on filtered data.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/ag-options-flow-analyzer | bash

Overview

Options Flow Analyzer

A skill that separates real options hedging activity from speculative lottery-ticket calls/puts using Polygon.io data, producing an adjusted put/call ratio and anomaly flags per ticker. Use it when a raw put/call ratio might be distorted by cheap deep-OTM contracts; treat output as an analytical signal, not financial advice, and cross-check against price action and news.

What it does

This skill analyzes options chain data with a real-vs-lottery call separation - the key insight that prevents put/call (P/C) ratio misinterpretation. Standard P/C ratio analysis can be misleading: a P/C of 0.35 might look extremely bullish but actually be 84% cheap deep out-of-the-money "lottery" calls. It separates real calls (strike within 5% of stock price, meaningful premium) and real puts (actual hedging activity) from lottery calls and lottery puts (deep OTM, cheap premium, speculative bets), using Polygon.io API data. For each ticker it outputs a real P/C ratio that excludes lottery noise, a lottery percentage, a per-expiry breakdown (weekly vs monthly vs LEAPS), anomaly detection (P/C shifts over 0.3, call OI surges over 30%, IV spikes over 20%), and a sentiment classification with confidence.

When to use - and when NOT to

Use it when raw put/call ratios appear bullish or bearish but may be distorted by cheap deep OTM contracts, when comparing options flow across watchlists, holdings, sectors, or event-driven names, when you need to separate institutional hedging from speculative lottery-ticket activity, or when tracking options anomalies against a recent baseline.

Sentiment classifications are analytical signals, not financial advice or trade recommendations - always cross-check unusual flow against price action, news catalysts, liquidity, and risk controls before acting. Options data can be delayed, incomplete, or unavailable depending on the Polygon.io plan, and the premium/delta thresholds used to classify real vs lottery contracts need adjustment for ticker price, volatility, and expiry.

Inputs and outputs

Input: a watchlist of tickers/sectors and optional real-vs-lottery thresholds (e.g. premium under $0.10, delta under 0.05). Output: a per-ticker options flow summary with raw and lottery-adjusted P/C ratios, lottery percentage, and flagged anomalies.

CEG  $299.69 | Raw P/C: 1.06 | Lottery: 61% | Adj P/C: 2.72  BEARISH (was neutral raw)
RXRX $3.26   | Raw P/C: 0.38 | Lottery: 84% | Adj P/C: 2.37  BEARISH (was extreme bullish raw)
XLI: P/C 5.32 vs 30-day baseline 0.87 - 4.5 std deviations above normal

Integrations

Requires a Polygon.io API key (free tier covers basic data, paid tier needed for full options chain access) and WebSearch for cross-verification. A free tier covers basic P/C ratio analysis for 3 tickers; the full $29 one-time bundle adds real/lottery separation, anomaly detection, per-expiry breakdown, and unlimited tickers.

Who it's for

Active traders and portfolio managers who track options flow and need to filter out lottery-ticket noise before drawing sentiment conclusions from put/call ratios - the discovery behind this skill came from a real trading mistake where an 84%-lottery P/C ratio was misread as a strong bullish signal.

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.