ibd-distribution-day-monitor

1# IBD Distribution Day Monitor
2 
3## Purpose
4Detect IBD-style Distribution Days for major market ETFs (QQQ as Nasdaq proxy, SPY as S&P 500 proxy) and produce a daily market deterioration signal plus a TQQQ/QQQ exposure recommendation. Designed for post-market review.
5 
6## When to Use
7Invoke this skill:
8- Daily after the US market close.
9- Before increasing TQQQ exposure or rebalancing leveraged positions.
10- When evaluating whether an uptrend is becoming vulnerable to a correction.
11- As an upstream input to FTD (Follow-Through Day) detection or other market-state frameworks.
12 
13Do NOT use this skill to:
14- Execute trades or modify orders.
15- Generate discretionary market predictions outside of the IBD ruleset.
16 
17## Inputs
18- Symbols (default: QQQ, SPY) and lookback (default 80 trading sessions).
19- Optional `--as-of YYYY-MM-DD` for backtesting against a historical session.
20- Strategy context: instrument (TQQQ or QQQ), current exposure %, base trailing stop %.
21- FMP API key via `--api-key`, `config.data.api_key`, or `FMP_API_KEY` env var (in that priority order).
22 
23## Core Rules
24A Distribution Day is detected when:
251. Today's close is at least 0.2% below yesterday's close.
262. Today's volume is greater than yesterday's volume.
27 
28A Distribution Day is removed from the active count when either:
29- More than 25 trading sessions have elapsed since the DD.
30- The index has gained 5% from the DD close (using post-DD high by default; configurable to close-source).
31…