unusual-options-scan

Scan US large-cap option chains for volume-to-open-interest anomalies.

4|Updated May 5, 2026
One-click install
npx skills add https://github.com/mthli/skills --skill unusual-options-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unusual-options-scan
Source: https://github.com/mthli/skills/tree/main/unusual-options-scan
Command: npx skills add https://github.com/mthli/skills --skill unusual-options-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yfinance, pandas, numpy, and includes scripts (resource) components.

What problem does it solve?

Unusual-options-scan turns daily end-of-day options chain data into a focused watchlist of US large-cap tickers showing anomalous options activity, helping you identify where smart-money positioning may be building ahead of catalysts.

Core Features & Use Cases

  • Find contract-level anomalies: Detects high Vol/OI spikes, far-out-of-the-money short-dated “lottery ticket” accumulation patterns, and extreme call/put skew.
  • Rank by institutional-grade signals: Filters by per-contract volume and notional size, and flags when total options notional is outsized versus the stock’s average dollar ADV.
  • Confirm persistence cross-day: Uses accumulated history to categorize prior-day flags into strong growth, partial retention, or closed-out noise based on overnight open-interest (OI) change.
  • Use case: Run it after market close to generate a daily “follow the flow” list of tickers worth deeper fundamental/news research, especially when you suspect M&A, earnings, or other catalyst activity is leaking through options first.

Quick Start

Use the unusual-options-scan skill to scan US large caps after the close and return the top anomalous tickers with cross-day OI confirmation.

Frequently Asked Questions about unusual-options-scan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find unusual options activity in large-cap stocks after market close?

You can find unusual options activity in large-cap stocks by scanning end-of-day option chains for volume-to-open-interest spikes, far-OTM short-dated accumulation, and extreme call/put skew. This identifies where institutional positioning may be building ahead of catalysts.

How does volume-to-open-interest ratio detect smart money options positioning?

Volume-to-open-interest ratio detects smart money positioning by flagging contracts where daily volume significantly exceeds existing open interest. High ratios indicate new positioning rather than existing trades, especially when notional size is outsized versus the stock's average dollar ADV.

Can I use yfinance to scan for anomalous options contracts across US equities?

Yes, you can use yfinance to fetch equities and option chains for US large-cap tickers. The scan computes derived metrics including Vol/OI, notional value, distance from spot, and call/put ratio to identify contract-level anomalies.

How do I confirm if unusual options activity persisted overnight or was just same-day noise?

You confirm persistence by comparing daily markdown snapshots in state history to measure overnight open-interest change. This cross-day confirmation categorizes prior flags into strong OI growth, partial retention, or closed-out noise.

What are the limitations of using end-of-day option chain snapshots for equity screening?

End-of-day option chain snapshots limit equity screening to post-close analysis, missing intraday flow. They also require Python execution and yfinance data availability, meaning real-time catalyst detection or pre-market positioning is not supported.

Do I need pandas and numpy to calculate options notional and call/put skew?

Yes, pandas and numpy are required dependencies to compute derived metrics like notional value, call/put skew, and notional-to-ADV ratios. These libraries handle the quantitative processing of option chain data fetched via yfinance.