What is whale-hunting?

An options-flow scanner looks for unusually large trades in an options market for a chosen stock or fund. It first checks the option chain, then examines detailed trading data for potential institutional-sized activity.

Use it to investigate possible institutional options activity, whale trades, unusual options volume, or large block trades for a ticker such as AAPL, NVDA, or SPY.

It helps locate unusually large options trades without manually reviewing every contract and transaction.

whale-hunting — Skill for Claude Code by staskh

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 staskh/trading_skills --skill whale-hunting

Clone the repo

git clone --depth 1 https://github.com/staskh/trading_skills

Made for: Claude Code.

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.

README.md

[![agentmods](https://agentmods.dev/badge/skills/staskh/trading_skills/whale-hunting/github.svg)](https://agentmods.dev/skills/staskh/trading_skills/whale-hunting)

Your own site

<a href="https://agentmods.dev/skills/staskh/trading_skills/whale-hunting"><img src="https://agentmods.dev/badge/skills/staskh/trading_skills/whale-hunting/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.

Your own site · 80×15

<a href="https://agentmods.dev/skills/staskh/trading_skills/whale-hunting"><img src="https://agentmods.dev/badge/skills/staskh/trading_skills/whale-hunting.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 42 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,144 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. Third-party audits

NVIDIA SkillSpector pass 7 Sept 2026

How audits are shown

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.

Model	Per session	Once invoked
Fable 5.1	$0.00042	$0.01144
Opus 5	$0.00021	$0.00572
Sonnet 5	$0.00008	$0.00229
Haiku 4.5	$0.00004	$0.00114

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

Security

Grade A, and why

whale-hunting 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 11d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/whale_hunting.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

.claude/skills/whale-hunting/SKILL.md · 92 lines

How it starts

The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Whale Hunting

Scans option chains for a given underlying to identify institutional-sized trades using a two-step approach:

Crude scan (Yahoo Finance) — finds contracts with anomalous daily investment vs the rest of the chain.
Precise drill-down (Massive API) — fetches per-second bars for each candidate and flags seconds with outlier dollar invested.

Instructions

Note: If uv is not installed or pyproject.toml is not found, replace uv run python with python in all commands below.

uv run python .claude/skills/whale-hunting/scripts/whale_hunting.py SYMBOL [--months N] [--date YYYY-MM-DD] [--sigma F] [--sigma-z F] [--summary]

Arguments

SYMBOL — Underlying ticker (e.g. AAPL, NVDA, SPY)
--months — Max months until option expiration to consider (default: 2)
--date — Trading date to analyze in YYYY-MM-DD format (default: latest trading day)
--sigma — Std-deviation multiplier for crude outlier threshold (default: 3.0)
--sigma-z — Modified Z-Score threshold for per-second small-sample detection (default: 3.5)
--summary — Also compute per-ticker summary and include it in the JSON output

Output

Returns JSON with:

underlying — The scanned symbol
trading_date — Date analyzed
source — "massive" (per-second data) or "yahoo only" (daily chain data)
total_whales — Total whale events found
total_call_invested — Sum of invested dollars in call whale events
total_put_invested — Sum of invested dollars in put whale events
call_put_ratio — Call invested / put invested (null if no puts)
whales — List of whale events:
- timestamp, ticker, type, strike, expiry
- close, volume, transactions, invested, break_even
summary (present only when --summary is passed) — List of per-ticker aggregates:
- ticker, type, strike, expiry, whale_count, total_invested, break_even

Examples

# Hunt whales for AAPL (latest trading day)
uv run python .claude/skills/whale-hunting/scripts/whale_hunting.py AAPL

# Hunt whales for NVDA on a specific date
uv run python .claude/skills/whale-hunting/scripts/whale_hunting.py NVDA --date 2026-03-13

# With per-ticker summary
uv run python .claude/skills/whale-hunting/scripts/whale_hunting.py HOOD --months 3 --summary

# Looser detection threshold
uv run python .claude/skills/whale-hunting/scripts/whale_hunting.py SPY --sigma 2.0

Read the full file on GitHub · 92 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

scripts/whale_hunting.py 3.4 KB runs code

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.

11d ago First seen · 92 lines · 42 tokens per session scan A fcbffb456f3c

Subscribe to this mod's changes

whale-hunting is a skill published in the GitHub repository staskh/trading_skills (363 stars, last pushed 10d ago), licensed MIT. It adds 42 tokens to every session and 1,144 once invoked, about $0.0002 per session on Opus 5. 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-30.

Finance and fintech ai-trading claude claude-skills mcp-server option-trading options-trading

find-cpa-firm

Use whenever the user wants to find, shortlist, vet, or enrich US accounting and tax firms (CPA firms) — financial-statement audit, SOC 1/2 audit, corporate tax, bookkeeping for businesses, advisory/fractional CFO, M&A diligence, 409A valuations, R&D tax credits, IPO readiness, sales-and-use tax. Triggers on "find me…

nostrband/ServiceGraph · 238 tokens

clawby-data

Query and analyze real financial data for any asset (US stocks / options / crypto / forex / perps / prediction markets) — quotes, volume, short volume & short interest, borrow fee, dark pool, options chain, Reddit sentiment, OHLC bars, FTDs, dividends & splits, stock screener, company financials & SEC filings (income…

openclawby/openclawby-skills · 215 tokens

second-order-thinking

Think beyond immediate consequences to understand the chain reactions of decisions. Master Howard Marks' investment framework for seeing what others miss. Use when: Strategic decisions where long-term consequences matter; Policy/rule changes that will trigger behavioral responses; Competitive moves to anticipate…

guia-matthieu/clawfu-skills · 82 tokens

forecast-scenarios

Model best-case, worst-case, and likely revenue scenarios with sensitivity analysis for strategic planning. Use when: building financial forecasts; presenting board scenarios; planning headcount around revenue uncertainty; modeling pricing changes impact; preparing investor updates with upside/downside ranges.

guia-matthieu/clawfu-skills · 54 tokens

commission-intelligence

Explain sales commission calculations, resolve discrepancies, and model compensation scenarios for quota planning.

guia-matthieu/clawfu-skills · 19 tokens

pipeline-forecasting

Generate predictive pipeline forecasts with confidence intervals and scenario modeling for revenue planning.

guia-matthieu/clawfu-skills · 18 tokens