5minbtc — BTC 5分钟实时预测 v5.9.0
BTC 单根 5min K线 方向 + 收盘价预测。引擎+LLM 混合架构。 SKILL.md 是索引, 详细内容见
references/。 v5.9 核心转变: 从"13因子预测器"→"3信号错价检测器"(见 对抗式审查报告)
触发
5minbtc / 5min btc / btc 5min / 监控 (配合持续盯盘)
何时使用
| 场景 | 做法 | |------|------| | 当前 5min K线 方向+价位 | ✅ 标准流程, 有真实 edge (v5.8 回测 61-70%) | | 会话内持续盯盘, 等明确信号 | ✅ 监控模式 (scripts/5minbtc-monitor.py + Monitor 工具) | | 币安预测市场 Up/Down 5m 交易 | ✅ paper 模拟/实时监控 (见 预测市场策略) | | "今晚 BTC 涨跌" (宽窗口) | ⚠️ 跑当前 K线 + 给方向倾向, 标注"超出引擎置信区间" | | "下根 K线" / "1小时后" | 引导在该 K线 起始时间再触发 |
监控模式 (Claude Code)
# 无限持续, 直到用户喊停 (会话内盯盘推荐)
Monitor(command: "python3 <SKILL>/scripts/5minbtc-monitor.py --max-runs 0", persistent: true)
# 默认 20 次采样 (约 40 分钟)
python3 <SKILL>/scripts/5minbtc-monitor.py
# 单次判断 (非持续)
python3 <SKILL>/scripts/5minbtc-monitor.py --dry-run
- 明确信号 = bias 非中性 + strength∈{medium,moderate,strong} + conf≥50 → 自动停
(⚠️ 实测引擎 strength 输出
medium, 判定集合需同时含medium和moderate) - 每根 K 线第 2/3 分钟采样 (progress ~40-70%), 比 cron 第 4 分钟更早
- 事件流:
START/DIR-CHANGE/CLEAR-SIGNAL/ENGINE-ERR/MAX-RUNS - 停止: 用户说「停/结束」→
TaskStop停 Monitor CLEAR-SIGNAL后必须拉一次完整引擎快照二次确认- 引擎验证:
python3 -m pytest scripts/test_engine_v58.py -v(12 项)
快速开始
SKILL_DIR=/home/aa/.hermes/profiles/cqo/skills/5minbtc
# 1. 并行: 引擎 + 新闻 + settle (前一根)
python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1
python3 $SKILL_DIR/5minbtc-engine-v5.7.py 2>&1
python3 $SKILL_DIR/5minbtc-news.py 2>&1
# 2. 3 路 web_search (并行)
# "Bitcoin BTC breaking news price" / "crypto market macro stocks today" / "比特币 BTC 最新 晚间"
# 3. LLM 分析 → 输出 (见 output-template.md)
# 4. 写日志
python3 $SKILL_DIR/5minbtc-log.py log \
"<candle.iso>" <pred_close> <pred_high> <pred_low> \
<conf> <bias> <news_sent> <vol_pct>
架构 (1 行/组件)
- 引擎
5minbtc-engine-v5.7.py(v5.9): 3信号方向判断(half_body延续1.2 + volume放量0.8 + meanrev回归0.3) + 三层独立过滤(多周期4h/1h/15m + 跨资产ETH/SOL + 真订单流OFI) + 9路并行HTTP - 订单流
scripts/ofi_feed.py: trade+bookTicker 组合流 tick规则推断主动买卖, 写 ~/bb-auto/ofi.json (launchd: com.daniel.ofi-feed) - 日志
5minbtc-log.py: jsonl 追加 + 增量 settle (写入 logs/) - 新闻
5minbtc-news.py: CoinDesk RSS (唯一稳定源, ~14min 延迟) - LLM: 因子打分基准 + LLM 综合裁决 + 模板输出
铁律
- 每次必须重新执行引擎脚本 — 不缓存
- 每次必须重新搜索3组新闻
- 先 settle 上一根, 再 log 新预测
- LLM 可微调引擎的 bias/pred_close/range, 但必须说明理由
- 输出 15-25 行 (平衡深度和 Telegram 可读性)
关键裁决规则 (LLM 决策时必查, 详见 output-template.md)
- half_body vs imbalance 冲突 (v5.7.2): |half_body|>0.25 + |imbalance|>0.5 + progress≥45% → 优先 half_body
- TREND 强趋势 decel 约束 (v5.7.4): EMA delta>$100 时 |decel|>0.7 需 |half_body|>0.15 同向确认
- fatigue≥0.8: conf 上限 40, 反向 +10pp
- chainlink_offset 矛盾: bias=bull 但 pred_close<current → 以 current 为锚 ±ATR×0.3
- 极端进度 (>80%): pred_close 按剩余时间比例缩放
- Body=0 持续模式: pred_close → current ± ATR×0.2, conf 降至 35-42%
性能快照 (2026-07-05)
- v5.7.1 实盘 273 轮方向 75.7% (v4.x 62.5%, +13.2pp)
- v5.8 回测: 前2根 1min=61.4%, 前4根=69.5% (半 K线延续性)
- 当前 cron:
zai/glm-5.2(8-15s/次) | opencaio 实测 MiniMax-M3 ~2.7s 可作更快选项
📚 引用索引 (references/)
核心方法论
- strategy-adversarial-review.md — 对抗式审查报告: 第一性原理 + 13因子证伪 + 该留/删/缺失 + P0/P1/P2行动清单 (v5.9 依据)
- lessons.md — 25 条核心教训 (必读, 含 2026-07-05 新增 23-25)
- pitfalls.md — 17 条 pitfalls 集中索引 (必读, 含并行 max() 评估陷阱)
- changelog.md — v5.0 ~ v5.7.4 详细变更
- architecture.md — 引擎架构 + 因子模型 + v5.0 升级路线图
- skill-organization.md — Skill 文件结构模式 (可复用) — SKILL.md INDEX + references/ 分专题
执行与输出
- execution.md — 完整执行步骤 + 铁律 + 宽窗口处理
- output-template.md — LLM 输出模板 + 裁决规则
- monitoring-claude-code.md — 监控模式: Monitor 工具集成 + 事件协议
- prediction-trading-cli.md — 币安预测交易 CLI: 5minbtc_trader.py 用法/参数/安全契约/API端点 (含 --paper/--paper-monitor 模拟)
- prediction-market-strategy.md — 预测市场盈利策略: EV=p−P, 价格门控, 凯利仓位, paper 模拟
数据源 & 网络
- news-sources.md — 新闻源评估 (清理后只剩 CoinDesk)
- binance-api-geo.md — Binance 端点区域问题
- binance-endpoint-flapping.md — 端点双向故障切换
- high-latency-network-handling.md — 高延迟网络处理 (SSL 超时)
- polymarket-data-source.md — Polymarket 结算源 (Chainlink)
引擎专项
- engine-parallelization-v573.md — v5.7.3 HTTP 并行化 + positional arg 陷阱
- black-swan-defense-v571.md — v5.7.1 黑天鹅防护 (ATR+FNG+news)
- decel-collapse-pattern.md — decel 极值崩塌 = V反完成
- cron-llm-provider-failure.md — Cron LLM Provider 失效诊断
- cron-setup.md — Cron Job 配置 + 版本同步
- dreaming-cron-recovery.md — Dreaming Cron 恢复
回测 & 复盘
- backtest-findings.md — 365 天回测深度复盘 + 因子无预测力
- backtest-v58-1min-findings.md — v5.8 真实 1min 半 K线回测
- review-procedure.md — 每日复盘流程 + 数据质量检查
- performance-history.md — 273 笔全量战绩 + 引擎迭代对比
单次 session 记录
- session-2026-06-17.md — 5 轮实时预测, v5.7.2 验证
- session-2026-06-18.md — 00:10 mispredict 复盘 → v5.7.4 规则
数据采集 & 仓库
- daily-stock-analysis-data-sources.md — daily_stock_analysis 17-fetcher 评估
- sync-procedure.md — AGI-Super-Team 同步流程
- quant-knowledge-index.md — 50 轮蒸馏知识库索引
复盘记录 (reviews/)
按月归档:
reviews/
├── 2026-05/ (6 份: review-2026-05-05.md, 24, 25, 27, 27-backtest, 29)
├── 2026-06/ (15 份: 03, 06, 09, 12, 14, 15, 16, 17, 18, 19, 21, 23, 24, 27, 28)
└── 2026-07/ (2 份: 01, 02)
报告库
14 份深度蒸馏报告在 reports/ 目录 (也同步在 AGI-Super-Team): R01-R14。
仓库同步
详见 sync-procedure.md。简述:
rsync -av --exclude='data/' --exclude='__pycache__/' \
--exclude='*.jsonl' --exclude='*.jsonl.*' --exclude='*.gz' \
/home/aa/.hermes/profiles/cqo/skills/5minbtc/ \
/home/aa/clawd/repos/AGI-Super-Team/skills/5minbtc/
cd /home/aa/clawd/repos/AGI-Super-Team
git add skills/5minbtc/ && git commit -m "sync(skills/5minbtc): <版本>" && git push origin master
回测系统
backtest/
├── fetch_data.py # Binance 历史数据下载
├── run_backtest.py # v5.6 回测 (因子无预测力, 公平回测)
├── run_backtest_v57.py # v5.7 回测 (含前视偏差, 已知)
├── run_backtest_v58.py # v5.8 回测 (真实 1min 半 K线, 零前视) ← 推荐
├── run.sh # 一键运行
├── data/ # 5min (105K) + 1min (259K) K线
└── results/ # 回测结果 (gitignore)
文件结构
5minbtc/
├── SKILL.md # 本文件 (~170 行 INDEX)
├── 5minbtc-engine-v5.7.py # 主引擎 (v5.7.4 规则, cron 调用)
├── 5minbtc-news.py # 新闻扫描 (CoinDesk RSS, 唯一稳定源)
├── 5minbtc-log.py # 日志记录 (写入 logs/)
├── archive/ # 归档
│ └── engines/
│ └── 5minbtc-engine-v5.py # v5 旧版 (回测因子模块 import)
├── logs/ # 日志输出
│ ├── 5minbtc-log.jsonl # 当前活跃 (cron 写入)
│ ├── 5minbtc-log.jsonl.1 # 最新备份
│ └── 5minbtc-log.jsonl.{2..22}.gz # 历史归档
├── reviews/ # 每日复盘 (按月归档)
│ ├── 2026-05/ (6 份)
│ ├── 2026-06/ (15 份)
│ └── 2026-07/ (2 份)
├── references/ # 26 份专项 ref (含 skill-organization 模式)
├── backtest/ # 回测系统
├── data/ # 运行时 (news-risk-level.json 等)
├── scripts/ # 复盘/监控/交易脚本
│ ├── 5minbtc-monitor.py # ★ 监控脚本 (Claude Code Monitor 集成, v1.0)
│ ├── 5minbtc_watch.py # ★ Telegram 推送监控 daemon (事件驱动+预测记录+收盘结算)
│ ├── 5minbtc_day_stats.py # 预测战绩查询 (今日/历史, --push 推送)
│ ├── 5minbtc_trader.py # ★ 币安预测交易桥接 (--once/--loop/--monitor/--paper/--paper-monitor)
│ ├── prediction_ws_feed.py # 币安 w3w-prediction WS 实时价源 (<200ms)
│ ├── ofi_feed.py # ★ 真订单流采集 (trade+bookTicker tick规则, launchd com.daniel.ofi-feed)
│ ├── 5minbtc_keyless_paper.py # 免密钥模拟盘 (公开BTC数据模拟UP/DOWN价)
│ ├── telegram_push.py # 通用 Telegram 推送助手
│ ├── daily-review-stats.py
│ └── fetch-github-repo.sh
14. 🔴 高延迟网络 — 引擎timeout临时修补 (2026-06-24)
15. 🔴 Web搜索不可用时的降级策略
16. 🔴 并行工具调用延迟评估 = max() not sum() (2026-07-05)
17. 🔴 SKILL.md 维护: 定期重构为 INDEX 风格 (2026-07-05)
---
最后更新: 2026-07-05 — 清理 news.py 死代码 (-54%) + SKILL.md 重构为 INDEX (-82%) + logs/reviews 归档 + 25 条教训