earnings-trade-analyzer

1# Earnings Trade Analyzer - Post-Earnings 5-Factor Scoring
2 
3Analyze recent post-earnings stocks using a 5-factor weighted scoring system to identify the strongest earnings reactions for potential momentum trades.
4 
5## When to Use
6 
7- User asks for post-earnings trade analysis or earnings gap screening
8- User wants to find the best recent earnings reactions
9- User requests earnings momentum scoring or grading
10- User asks about post-earnings accumulation day (PEAD) candidates
11 
12## Prerequisites
13 
14- FMP API key (set `FMP_API_KEY` environment variable or pass `--api-key`)
15- Free tier (250 calls/day) is sufficient for default screening (lookback 2 days, top 20)
16- Paid tier recommended for larger lookback windows or full screening
17 
18## Workflow
19 
20### Step 1: Run the Earnings Trade Analyzer
21 
22Execute the analyzer script:
23 
24```bash
25# Default: last 2 days of earnings, top 20 results
26python3 skills/earnings-trade-analyzer/scripts/analyze_earnings_trades.py --output-dir reports/
27 
28# Custom lookback and market cap filter
29python3 skills/earnings-trade-analyzer/scripts/analyze_earnings_trades.py \
30  --lookback-days 5 \
31  --min-market-cap 1000000000 \
32  --top 30 \
33  --output-dir reports/
34 
35# Deterministic anchor date (America/New_York); the window is anchored on the
36# ET calendar date, not the runner's local clock. For reproducible runs/tests.
37python3 skills/earnings-trade-analyzer/scripts/analyze_earnings_trades.py \
38  --as-of 2026-09-15 \
39  --output-dir reports/
40 
41# With entry quality filter
42…