用途:检测主要市场 ETF(QQQ 作为纳斯达克代理、SPY 作为标普 500 代理)的 IBD 风格派发日,生成每日市场恶化信号及 TQQQ/QQQ 敞口建议,适用于美股收盘后复盘、增加 TQQQ 敞口或调整杠杆仓位前、评估上升趋势是否走弱时,可作为 FTD 跟进日检测的上游输入。不用于执行交易或下单,也不生成 IBD 规则之外的自主预测。
主要能力:派发日定义为今日收盘较昨日下跌至少 0.2% 且成交量高于昨日。失效条件为超过 25 个交易日,或指数自派发日收盘上涨 5%(默认使用派发后最高价,可配置为收盘价);当日新派发日不会立即失效。计数采用 d5_count、d15_count、d25_count 统计 age_sessions <= N 的活跃记录(实际检查 N+1 个交易日)。风险分为 NORMAL(d25<=2)、CAUTION(d25>=3)、HIGH(d25>=5 或 d15>=3 或 d5>=2)、SEVERE(d25>=6 或 d15>=4 或市场低于 21EMA 或 50MA 且 d25>=5)。同时加载 QQQ 与 SPY 时按 QQQ 加权综合,单个 SEVERE 即升至 SEVERE,QQQ HIGH 升为整体 HIGH,QQQ NORMAL 加 SPY HIGH 仍升为 HIGH。TQQQ 敞口策略:NORMAL 保持 100%、CAUTION 避免加仓 75%、HIGH 减仓 50%、SEVERE 清仓或对冲 25%,并相应收紧跟踪止损;QQQ 因无 3 倍杠杆采用较温和策略(HIGH 75%、SEVERE 50%)。
使用方式:通过 FMP 获取 OHLCV,校验数据质量并记录跳过的交易日,重基后检测派发日、统计数量、计算 21EMA 与 50SMA 过滤、分类并组合、生成组合动作,最终将 JSON 与 Markdown 报告写入输出目录并自动脱敏 API 密钥。输入包括符号(默认 QQQ、SPY)、回溯期(默认 80 个交易日)、可选的 --as-of YYYY-MM-DD 回测日期、策略上下文(标的 TQQQ 或 QQQ、当前敞口百分比、基础跟踪止损百分比),以及 FMP API 密钥。CLI 示例:python3 skills/ibd-distribution-day-monitor/scripts/ibd_monitor.py --symbols QQQ,SPY --lookback-days 80 --instrument TQQQ --current-exposure 100 --base-trailing-stop 10 --output-dir reports/
输出与限制:结果保存为 ibd_distribution_day_monitor_YYYY-MM-DD_HHMMSS.json 和 .md,JSON 为 UTF-8(ensure_ascii=False)。需要 FMP API 密钥,免费层每日 250 次调用足以每日运行 QQQ+SPY。不得覆盖 IBD 规则定义,应说明哪些日期计入活跃数,缺失或不可靠的成交量数据仅作为警告而非派发日。组合动作仅为风险管理建议,不是执行指令;不执行交易。相关技能包括 ftd-detector、market-top-detector 和 position-sizer。