earnings-blackoutlisted

# earnings-blackout You have a watchlist of 20 names. Which print this week? Which printed yesterday and might gap on follow-up news? Which are clear to trade without earnings-event risk? Run the scanner. One pass per ticker over Benzinga (or SEC EDGAR as fallback), one classification per ticker, one grouped exception report at the end. This is the pre-trade hygiene check, not a full preview. For a single name's full sell-side preview (implied move, beat/miss history, peer reaction, drift), use [`earnings-drilldown`](../earnings-drilldown/). For the per-event windowing study, use [`event-study`](../event-study/). ## When to invoke - Morning watchlist scan before the market opens - Position-sizing check: which names in the book have earnings risk in the next N days - Post-mortem: which name in the watchlist already printed and might have residual gap risk ## What you need - A watchlist (`--watchlist NVDA,TSLA,AMZN,GOOGL,META,AAPL,MSFT`) - `MASSIVE_API_KEY` exported in the environment - Optional: Benzinga earnings add-on for forward dates + consensus EPS (Tier A). Without it, the skill falls back to SEC EDGAR 8-K filings (Tier B, past-only). ## Quick start ```bash python3 examples/run-earnings-blackout.py \ --watchlist NVDA,TSLA,AMZN,GOOGL,META,AAPL,MSFT \ --window-days 7 ``` ## Status buckets Seven, returned in `results[].status`: - `blackout_imminent` — earnings 0-3 days forward. Position-sizing decisions need to be locked in NOW. - `blackout_soon` —