Whale Hunting

Detect institutional-sized options trades for one underlying: a Yahoo chain scan for anomalous flow, then a per-second drill-down when a Massive API key is set.

⚠️ **Trading warning / Avertissement trading** : informational only, not investment advice. A large options trade is not automatically a bullish or bearish bet: it can be a hedge, one leg of a spread, or a closing trade, and the detector cannot tell which; copying flow you cannot interpret carries a real risk of loss. No output here is a promise of return. Curated by Skill Harbor: a two-step detector for institutional-sized options activity on one underlying. The first step scans the Yahoo Finance chain for contracts whose daily invested dollars are anomalous against the rest of the chain (a standard-deviation threshold, 3.0 by default). The second step, when a Massive API key is available, drills into each candidate with per-second bars and flags the seconds whose invested dollars are outliers (a modified Z-score, 3.5 by default), which is how a single block trade inside a busy contract gets isolated. The output names the source honestly (massive for the per-second pass, yahoo only for the daily fallback), totals the call and put dollars invested with their ratio, and lists each whale event with its time, contract, strike, expiry, volume, transaction count, dollars invested and breakeven; an optional summary aggregates events per contract. The skill's own reading guide is included: a call to put ratio under 0.5 reads bearish, over 2.0 bullish, and a single-transaction event is the strongest signal. It runs as a Python script from the staskh/trading_skills repo, over options expiring within two months by default, for the latest trading day or a date you name. From the staskh/trading_skills repository (MIT). Honest caveats: the precise mode needs a MASSIVE_API_KEY environment variable (a paid third-party data service), and without it you get the daily-level fallback, which the output labels as such; outlier thresholds are statistical, so quiet contracts throw false positives and hedged flow looks directional; and flow data arrives after the trade, so it is a research lens, not a live tape. Skill Harbor never reviews the code, review it yourself before use.

At a glance

What: Detect institutional-sized options trades for one underlying: a Yahoo chain scan for anomalous flow, then a per-second drill-down when a Massive API key is set.
Cost: Free
Needs: Use "Whale Hunting" with your Muse.
Install: Copy the installer prompt below into your Muse — your agent does the rest.

⚠️ **Trading warning / Avertissement trading** : informational only, not investment advice. A large options trade is not automatically a bullish or bearish bet: it can be a hedge, one leg of a spread, or a closing trade, and the detector cannot tell which; copying flow you cannot interpret carries a real risk of loss. No output here is a promise of return. Curated by Skill Harbor: a two-step detector for institutional-sized options activity on one underlying. The first step scans the Yahoo Finance chain for contracts whose daily invested dollars are anomalous against the rest of the chain (a standard-deviation threshold, 3.0 by default). The second step, when a Massive API key is available, drills into each candidate with per-second bars and flags the seconds whose invested dollars are outliers (a modified Z-score, 3.5 by default), which is how a single block trade inside a busy contract gets isolated. The output names the source honestly (massive for the per-second pass, yahoo only for the daily fallback), totals the call and put dollars invested with their ratio, and lists each whale event with its time, contract, strike, expiry, volume, transaction count, dollars invested and breakeven; an optional summary aggregates events per contract. The skill's own reading guide is included: a call to put ratio under 0.5 reads bearish, over 2.0 bullish, and a single-transaction event is the strongest signal. It runs as a Python script from the staskh/trading_skills repo, over options expiring within two months by default, for the latest trading day or a date you name. From the staskh/trading_skills repository (MIT). Honest caveats: the precise mode needs a MASSIVE_API_KEY environment variable (a paid third-party data service), and without it you get the daily-level fallback, which the output labels as such; outlier thresholds are statistical, so quiet contracts throw false positives and hedged flow looks directional; and flow data arrives after the trade, so it is a research lens, not a live tape. Skill Harbor never reviews the code, review it yourself before use.

Version:

s

Created by: staskh

Not verified? How to check before you trust →

Install — Free · open source (MIT) View source code

⌁

Install

Copy the install package below, then paste it into Muse

Wanna be extra careful?

The install prompt below already includes the vetting steps: your agent follows the community checklist before installing anything with executable code. Want more?

How to check a build before installing →

After installation, ask me if I want to leave private feedback
Private for now: only the Skill Harbor team sees it. Sellers may be looped in later.

Use "Whale Hunting" with your Muse. Prerequisites: clone the repo once (git clone https://github.com/staskh/trading_skills) and keep the folder handy; the skills live in .claude/skills/ and the scripts run from the repo with uv (uv run python), or with plain python if uv is not installed. For the precise per-second mode, set a MASSIVE_API_KEY environment variable (paid third-party data service, key in the environment only, never pasted into the chat); without it the skill falls back to Yahoo Finance daily chain data and labels the output yahoo only. No brokerage account is required. 1. Open the skill: https://github.com/staskh/trading_skills/blob/main/.claude/skills/whale-hunting/SKILL.md and copy the full SKILL.md text. 2. Paste it into a chat with Muse and add: "Hunt whales for NVDA on the latest trading day, with the per-ticker summary: total call and put dollars, the call to put ratio, and each event with strike, expiry and dollars invested." 3. Ask what kind of trade each event could be before treating it as a signal: a single block can be a hedge or a spread leg, and the breakeven shown assumes it stands alone. Tip: loosen the sigma threshold to 2.0 on a quiet symbol and tighten it on SPY; the default 3.0 is tuned for ordinary large-cap flow. Safety: a skill is plain-text instructions; it runs nothing by itself. Flow is context, not a signal to copy. This is informational only, not investment advice.

?

Questions

How do I install a build?

Every product page includes a copy-paste install prompt. Paste it into your Muse and it sets the build up for you — no manual configuration.

Where does my money go?

Straight to the seller. Skill Harbor never processes payments: checkout happens on the seller’s own page, usually Stripe.

What does the ✓ next to a creator’s name mean?

It means we confirmed the identity of the person behind the listing. It says nothing about the code itself — always check a build before installing it.