# Alphagbm Unusual Activity

> |

- **Type:** Skill
- **Install:** `agentstack add skill-alphagbm-skills-alphagbm-unusual-activity`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AlphaGBM](https://agentstack.voostack.com/s/alphagbm)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [AlphaGBM](https://github.com/AlphaGBM)
- **Source:** https://github.com/AlphaGBM/skills/tree/main/skills/alphagbm-unusual-activity
- **Website:** https://www.alphagbm.com/skills

## Install

```sh
agentstack add skill-alphagbm-skills-alphagbm-unusual-activity
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 trades
- `smart money AAPL` — Institutional flow signals for Apple
- `large trades NVDA` — Block and sweep orders for NVIDIA
- `who's buying TSLA puts` — Bearish flow analysis for Tesla
- `options 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 AAPL
- `market-wide-scan.json` — Top 20 unusual activity signals across all tickers
- `flow-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 dollars
- `min_vol_oi_ratio` (float, default 3.0) — Minimum volume-to-OI ratio
- `trade_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

| Skill | Relevance |
|-------|-----------|
| [alphagbm-options-score](../alphagbm-options-score/) | Combines unusual activity into the overall options score |
| [alphagbm-market-sentiment](../alphagbm-market-sentiment/) | Market-wide context for interpreting flow signals |

---

*Powered by [AlphaGBM](https://alphagbm.com) — Real-data options & research intelligence. 10K+ users.*

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AlphaGBM](https://github.com/AlphaGBM)
- **Source:** [AlphaGBM/skills](https://github.com/AlphaGBM/skills)
- **License:** MIT
- **Homepage:** https://www.alphagbm.com/skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-alphagbm-skills-alphagbm-unusual-activity
- Seller: https://agentstack.voostack.com/s/alphagbm
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.