AlphaGBM Unusual Options Activity
Detects unusual options activity and classifies smart money signals to help you follow institutional positioning.
What This Skill Does
| Concept |
Description |
| Volume/OI Ratio |
When today's volume far exceeds open interest, it signals new positioning |
| Block Trade |
A single large transaction (typically 100+ contracts) executed at one price |
| Sweep Order |
Aggressive order that sweeps across multiple exchanges to get filled fast — indicates urgency |
| Premium Flow |
Net dollar amount of call vs put premium — shows directional conviction |
| Sentiment Classification |
Categorizes activity as bullish sweep, bearish block, hedging, or earnings positioning |
| Historical Accuracy |
How often past unusual activity correctly predicted direction |
How to Use
Input: A ticker symbol or market-wide scan request.
Output:
- Unusual activity list: timestamp, strike, expiry, type (call/put), volume, OI, premium, trade classification
- Sentiment classification per trade (bullish sweep, bearish block, hedging, earnings positioning)
- Net premium flow (calls vs puts in dollar terms)
- Historical accuracy: how often similar signals preceded the expected move
- Aggregated smart money score
Example Queries:
unusual options activity — Market-wide scan of today's most unusual tradessmart money AAPL — Institutional flow signals for Applelarge trades NVDA — Block and sweep orders for NVIDIAwho's buying TSLA puts — Bearish flow analysis for Teslaoptions flow SPY — Net premium flow for S&P 500 ETF
Mock Data
Mock data files are located in mock-data/unusual-activity/ and include:
aapl-unusual-trades.json — Recent unusual trades for AAPLmarket-wide-scan.json — Top 20 unusual activity signals across all tickersflow-summary.json — Aggregated premium flow by sector
API Endpoint
GET /api/options/unusual-activity/{symbol}
GET /api/options/unusual-activity/scan
Query parameters:
min_premium (int, default 100000) — Minimum trade premium in dollarsmin_vol_oi_ratio (float, default 3.0) — Minimum volume-to-OI ratiotrade_type (string) — Filter: "sweep", "block", "all"sentiment (string) — Filter: "bullish", "bearish", "all"
Response fields: trades[], net_premium_flow, sentiment_summary, smart_money_score, historical_accuracy
Related Skills
Powered by AlphaGBM — Real-data options & research intelligence. 10K+ users.
1---2name: alphagbm-unusual-activity3description: Detects unusual options activity and smart money signals. Monitors volume/OI ratio spikes, large block trades, unusual strike/expiry combinations, and net premium flow. Triggers: "unusual options activity", "smart money AAPL", "large trades NVDA", "who's buying TSLA puts", "options flow", "block trades", "sweep orders", "unusual volume", "dark pool activity", "whale trades"4---56# AlphaGBM Unusual Options Activity78Detects unusual options activity and classifies smart money signals to help you follow institutional positioning.910## What This Skill Does1112| Concept | Description |13|---------|-------------|14| Volume/OI Ratio | When today's volume far exceeds open interest, it signals new positioning |15| Block Trade | A single large transaction (typically 100+ contracts) executed at one price |16| Sweep Order | Aggressive order that sweeps across multiple exchanges to get filled fast — indicates urgency |17| Premium Flow | Net dollar amount of call vs put premium — shows directional conviction |18| Sentiment Classification | Categorizes activity as bullish sweep, bearish block, hedging, or earnings positioning |19| Historical Accuracy | How often past unusual activity correctly predicted direction |2021## How to Use2223**Input:** A ticker symbol or market-wide scan request.2425**Output:**26- Unusual activity list: timestamp, strike, expiry, type (call/put), volume, OI, premium, trade classification27- Sentiment classification per trade (bullish sweep, bearish block, hedging, earnings positioning)28- Net premium flow (calls vs puts in dollar terms)29- Historical accuracy: how often similar signals preceded the expected move30- Aggregated smart money score3132**Example Queries:**33- `unusual options activity` — Market-wide scan of today's most unusual trades34- `smart money AAPL` — Institutional flow signals for Apple35- `large trades NVDA` — Block and sweep orders for NVIDIA36- `who's buying TSLA puts` — Bearish flow analysis for Tesla37- `options flow SPY` — Net premium flow for S&P 500 ETF3839## Mock Data4041Mock data files are located in `mock-data/unusual-activity/` and include:42- `aapl-unusual-trades.json` — Recent unusual trades for AAPL43- `market-wide-scan.json` — Top 20 unusual activity signals across all tickers44- `flow-summary.json` — Aggregated premium flow by sector4546## API Endpoint4748```49GET /api/options/unusual-activity/{symbol}50GET /api/options/unusual-activity/scan51```5253Query parameters:54- `min_premium` (int, default 100000) — Minimum trade premium in dollars55- `min_vol_oi_ratio` (float, default 3.0) — Minimum volume-to-OI ratio56- `trade_type` (string) — Filter: "sweep", "block", "all"57- `sentiment` (string) — Filter: "bullish", "bearish", "all"5859Response fields: `trades[]`, `net_premium_flow`, `sentiment_summary`, `smart_money_score`, `historical_accuracy`6061## Related Skills6263| Skill | Relevance |64|-------|-----------|65| [alphagbm-options-score](../alphagbm-options-score/) | Combines unusual activity into the overall options score |66| [alphagbm-market-sentiment](../alphagbm-market-sentiment/) | Market-wide context for interpreting flow signals |6768---6970*Powered by [AlphaGBM](https://alphagbm.com) — Real-data options & research intelligence. 10K+ users.*
gabrielmoreira