options-flow-analyzer

options-flow-analyzer is a skill for Claude Code, Codex from tellmefrankie/news-engine. It costs 0 tokens per session (855 once invoked), scanned A, original, MIT.

A tool for analyzing stock options-chain data by separating ordinary trades from cheap, far-out-of-the-money “lottery” options, which are highly speculative contracts. It uses the Polygon.io market-data API and reports adjusted put/call ratios and related signals.

In plain words
What is it for?
Use it to examine options activity for tickers, compare expirations, measure speculative volume, detect unusual changes, and classify the resulting sentiment.
Why use it?
A raw put/call ratio can look bullish or bearish because of large speculative trades rather than meaningful positioning. Separating these groups gives a clearer view of the activity represented in the data.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: positional $N argument.

Good fit Use it to examine options activity for tickers, compare expirations, measure speculative volume, detect unusual changes, and classify the resulting sentiment.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/tellmefrankie/news-engine/options-flow-analyzer
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add tellmefrankie/news-engine --skill options-flow-analyzer
Clone the repo
git clone --depth 1 https://github.com/tellmefrankie/news-engine

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for options-flow-analyzer

README.md
[![agentmods](https://agentmods.dev/badge/skills/tellmefrankie/news-engine/options-flow-analyzer/github.svg)](https://agentmods.dev/skills/tellmefrankie/news-engine/options-flow-analyzer)
Your own site
<a href="https://agentmods.dev/skills/tellmefrankie/news-engine/options-flow-analyzer"><img src="https://agentmods.dev/badge/skills/tellmefrankie/news-engine/options-flow-analyzer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for options-flow-analyzer

Your own site · 80×15
<a href="https://agentmods.dev/skills/tellmefrankie/news-engine/options-flow-analyzer"><img src="https://agentmods.dev/badge/skills/tellmefrankie/news-engine/options-flow-analyzer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 855 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.00855
Opus 5 $0.00000 $0.00428
Sonnet 5 $0.00000 $0.00171
Haiku 4.5 $0.00000 $0.00085

Measured 12d ago against content hash e4024c8540c0, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

options-flow-analyzer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/options-flow-analyzer/SKILL.md · 73 lines

How it starts

The opening of the file, as written. The whole thing — 73 lines — stays where its author put it; the contents beside it link to each section on 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.

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)
TEM  $48.46  | Raw P/C: 0.50 | Lottery: 41% | Adj P/C: 0.85  ➡️ NEUTRAL

SECTORS:
XLI  | Raw P/C: 5.32 | Lottery:  8% | Adj P/C: 4.89  🔴 INSTITUTIONAL HEDGE
SPY  | Raw P/C: 0.44 | Lottery: 12% | Adj P/C: 0.40  🔥 EXTREME BULLISH

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

Read the full file on GitHub · 73 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 73 lines · 0 tokens per session scan A e4024c8540c0

Subscribe to this mod's changes

options-flow-analyzer is a skill published in the GitHub repository tellmefrankie/news-engine (1 stars, last pushed 4mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 855 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.