insider-flowlisted

# insider-flow You hand over a ticker. The skill pulls every Form 4 filed against the issuer over the lookback window, classifies each transaction, separates the signal (open-market buys, non-scheduled sales) from the noise (grants, option exercises, 10b5-1 scheduled sales), detects cluster buys, and emits a sentiment label backed by the underlying dollar flow. The point is to answer the question a PM actually asks: **are insiders buying or selling this name, and does it matter?** The default read ignores 10b5-1 sales (pre-committed months in advance) and comp-related grants because they carry no signal about what management thinks of the current price. ## When to invoke - A PM asks "any insider activity on NVDA in the last 6 months?" - A fundamental analyst wants a heads-up on the CEO's stock transactions over a cycle - Screening a watchlist for cluster buys as a bullish overlay on weakness - The user says "insider flow", "Form 4 activity", "who's buying / selling", "insider signal" Not for: real-time (Form 4 is filed within 2 business days, so this is days-fresh, not tick-fresh). Not for 13-F holdings (institutional ownership is a separate skill). ## What you need - A ticker (`--ticker`, required) - `MASSIVE_API_KEY` exported in the environment - Stocks Basic plan minimum. The `/stocks/filings/vX/form-4` endpoint is included on every Stocks plan. Optional: - `--lookback-days` (default 180): calendar-day window back from today. - `--exclude-directors`: drop