pead-screener

name

pead-screener

description

Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns. Analyzes weekly candle formation to detect red candle pullbacks and breakout signals. Supports two input modes - FMP earnings calendar (Mode A) or earnings-trade-analyzer JSON output (Mode B). Use when user asks about PEAD screening, post-earnings drift, earnings gap follow-through, red candle breakout patterns, or weekly earnings momentum setups.

PEAD Screener - Post-Earnings Announcement Drift

Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns using weekly candle analysis to detect red candle pullbacks and breakout signals.

When to Use

• User asks for PEAD screening or post-earnings drift analysis
• User wants to find earnings gap-up stocks with follow-through potential
• User requests red candle breakout patterns after earnings
• User asks for weekly earnings momentum setups
• User provides earnings-trade-analyzer JSON output for further screening

Prerequisites

• FMP API key (set FMP_API_KEY environment variable or pass --api-key)

  export FMP_API_KEY=your_api_key_here
  

• Free tier (250 calls/day) is sufficient for default screening
• For Mode B: earnings-trade-analyzer JSON output file with schema_version "1.0"

Workflow

Step 1: Prepare and Execute Screening

Run the PEAD screener script in one of two modes:

Mode A (FMP earnings calendar):

# Default: last 14 days of earnings, 5-week monitoring window
python3 skills/pead-screener/scripts/screen_pead.py --output-dir reports/

# Custom parameters
python3 skills/pead-screener/scripts/screen_pead.py \
  --lookback-days 21 \
  --watch-weeks 6 \
  --min-gap 5.0 \
  --min-market-cap 1000000000 \
  --output-dir reports/