options-flow-analyzer
Analyzes financial options data to separate real trades from speculation. Prevents important signals from being lost in irrelevant data.
What it does
This tool analyzes stock options data to separate speculative bets ('lottery' calls) from more serious trades. It helps understand true market sentiment instead of being misled by low-value bets.
When to use it
- ✓When the put/call ratio seems misleading.
- ✓When comparing options flow across different stocks or sectors.
- ✓To distinguish between institutional investments and short-term bets.
Example of what to ask your AI
“Analyze options flow for my stocks: AAPL, GOOG, MSFT. Separate 'lottery' bets and tell me the overall sentiment.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The tool examines the prices and proximity of options contracts to the current stock price. It classifies options as 'real' (closer and with significant value) or 'lottery' (far out-of-the-money and cheap), adjusting the final analysis.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill options-flow-analyzerOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/options-flow-analyzer/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Options Flow Analyzer
Analyze options chain data with real vs lottery call separation — the key insight that prevents P/C ratio misinterpretation. Uses Polygon.io API.
When to Use
- Use when raw put/call ratios appear bullish or bearish but may be distorted by cheap deep OTM contracts.
- Use when comparing options flow across watchlists, holdings, sectors, or event-driven names.
- Use when you need to separate institutional hedging from speculative lottery-ticket activity.
- Use when tracking options anomalies against a recent baseline.
What it does
Standard P/C ratio analysis is misleading. A P/C of 0.35 looks "extremely bullish" but may be 84% lottery calls ($0.01-$0.09 OTM options).
This skill separates:
- Real calls: Strike price within 5% of stock price, meaningful premium
- Lottery calls: Deep OTM, cheap premium, speculative bets
- Real puts: Actual hedging activity
- Lottery puts: Cheap downside bets
Analysis Output
For each ticker:
- Real P/C ratio (excludes lottery noise)
- Lottery percentage (what % of volume is speculation)
- Per-expiry breakdown (weekly vs monthly vs LEAPS)
- Anomaly detection: P/C shifts >0.3, Call OI surges >30%, IV spikes >20%
- Sentiment classification: Bullish/Bearish/Neutral with confidence
Example Output
Options Flow Summary — 2026-05-13
HOLDINGS:
CEG $299.69 | Raw P/C: 1.06 | Lottery: 61% | Adj P/C: 2.72 BEARISH (was neutral raw)
IREN $55.15 | Raw P/C: 0.83 | Lottery: 34% | Adj P/C: 0.55 BULLISH
KTOS $56.99 | Raw P/C: 0.53 | Lottery: 28% | Adj P/C: 0.38 EXTREME BULLISH
RXRX $3.26 | Raw P/C: 0.38 | Lottery: 84% | Adj P/C: 2.37 BEARISH (was extreme bullish raw)
SECTORS:
XLI | Raw P/C: 5.32 | Lottery: 8% | Adj P/C: 4.89 INSTITUTIONAL HEDGE
ANOMALIES:
XLI: P/C 5.32 vs 30-day baseline 0.87 — 4.5 std deviations above normal
RXRX: 84% lottery calls — raw P/C signal completely inverted after filtering
Configuration
Analyze options flow for my watchlist:
Holdings: CEG, IREN, KTOS, RXRX, TEM
Sectors: SPY, QQQ, XLI, XLK
Separate real vs lottery calls (threshold: premium < $0.10, delta < 0.05).
Flag anomalies vs 30-day baseline.
Requirements
- Polygon.io API key (free tier covers basic data; paid tier for full chain)
- WebSearch for cross-verification
Limitations
- Options data can be delayed, incomplete, or unavailable depending on the Polygon.io plan.
- Heuristics such as premium and delta thresholds need adjustment for ticker price, volatility, and expiry.
- 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.
Key Discovery
This real/lottery separation was discovered during live portfolio management when RXRX showed P/C 0.35 (looks extremely bullish) but was actually 84% lottery calls at $0.01-$0.09. The "bullish signal" was noise. This skill prevents that mistake.
Pricing
Free: Basic P/C ratio for 3 tickers Full bundle — $29 one-time: Real/lottery separation + anomaly detection + per-expiry + unlimited tickers → https://jaehyunpark.gumroad.com/l/tcyahy
Author
Built from a real trading mistake that cost money. The real/lottery discovery is documented and battle-tested across 17 tickers over 2+ months.
FAQ
What are 'lottery options'?
These are very cheap call or put options with a low chance of becoming profitable, often used for short-term speculative bets.
Why is separating 'real' from 'lottery' important?
Because many 'lottery' options can distort the overall put/call ratio, making the market seem more bullish or bearish than it actually is.
Is this financial advice?
No, this tool provides data analysis to aid your own decision-making. Always consult a financial professional before investing.
Details
Original description by the author
Real vs lottery call separation for options P/C ratio analysis — prevents signal inversion from deep OTM noise
Popularity
- GitHub stars
- 48k
- Ranking position
- #3772
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
data-throughput-accelerator
Makes your agent speed up the movement of large data volumes. It finds bottlenecks and ensures data is transferred quickly and correctly.
affaan-m/ECC
inventory-demand-planning
Helps your agent predict product demand in stores. It optimizes stock and plans when to run promotions to sell more.
affaan-m/ECC
market-research
Helps your agent conduct market research and competitive analysis. Provides summaries with source attribution.
affaan-m/ECC