Whale Hunting

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

1. Crude scan (Yahoo Finance) — finds contracts with anomalous daily investment vs the rest of the chain.
2. 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