5minbtc
BTC 5分钟K线实时方向预测 + 币安预测市场错价套利(paper)。v6.0 真OFI驱动: 方向由当前K线原生 in-candle OFI 净流一票决定(ofi_n=2*(tb/v)-1, REST klines[9] 聚合, 零WS依赖; WS ofi.json 做新鲜度反转保护与交叉校准), 概率=P(close>open|ofi) 经验校准表+Bayesian shrink, edge=EV=p−ask 错价检测, 方向二选一无中性。13因子自v5.9起收敛到3个有证据信号且不再决定bias。黑天鹅防护: ATR spike+FNG<25。l
Install
npx skills add https://github.com/aAAaqwq/AGI-Super-Team/tree/main/skills/5minbtc
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install aaaaqwq-agi-super-team@llmmart
git clone https://github.com/aAAaqwq/AGI-Super-Team.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole aaaaqwq/agi-super-team collection as a plugin from our marketplace. Git is the plain clone.
README
5minbtc — BTC 5 分钟实时方向预测引擎
引擎 + LLM 混合架构:真 OFI 净流定方向 + 错价检测定 edge,LLM 综合裁决,预测 BTC 单根 5 分钟 K 线的方向与收盘价区间。
⚠️ v6.0 起方向不再来自因子打分 — 13 个价量因子中 11 个经公平回测为 47–49%(等同抛硬币),现仅保留输出供参考,方向由当前 K 线原生 OFI 净流一票决定。详见 对抗式审查报告。
⚠️ NOT FINANCIAL ADVICE / 非投资建议 — 本项目仅为量化研究与学习目的,不构成任何投资、交易或持仓建议。预测存在显著误差,实际交易将面临资金损失风险。详见文末 免责声明。
目录
核心理念
5minbtc 解决一个具体问题:在每根 5 分钟 BTC K 线进行到 ~60–80% 时,预测这根 K 线收盘时的方向和价格区间。
它不是全自动交易机器人,而是一个 引擎 + LLM 混合决策系统:
量化引擎 (12 因子 + ATR 归一化) LLM (新闻 + 因子 + 裁决规则)
┌─────────────────────────┐ ┌──────────────────────────┐
│ 4 路并行拉取市场数据 │ JSON → │ 3 路并行新闻搜索 │
│ 12 正交因子打分 │ ──────→ │ 综合裁决 (可微调引擎结论) │
│ Platt Scaling 置信度 │ │ 模板化输出 (15–25 行) │
└─────────────────────────┘ └──────────────────────────┘
纯 Python 标准库 可由 cron 调度
为什么要混合? 回测证明:纯价格因子在公平(无前视)条件下无显著预测力(47–49%)。实盘的 edge 主要来自 K 线后段(progress ≥ 0.9)的"已确认走势延续"以及新闻冲击。把数值因子交给 LLM 做上下文综合,比纯规则或纯 LLM 都更稳健。
系统架构
组件
| 组件 | 文件 | 职责 |
|---|---|---|
| 引擎 | 5minbtc-engine-v6.0.py |
拉数据 → 计算 OFI(ofi_n=2*(tb/v)-1) → OFI 一票定方向 + 概率 P(close>open\|ofi) → 输出预测 JSON(stdout)。13 因子仍计算但只作参考 |
| 新闻 | 5minbtc-news.py |
抓取 CoinDesk RSS,输出风险等级到 data/news-risk-level.json |
| 日志 | 5minbtc-log.py |
预测记录追加(jsonl)+ 增量 settle(结算上一根 K 线实际结果) |
| 回测 | backtest/*.py |
历史数据回测,多版本(v5.6 / v5.7 / v5.8) |
| LLM | (外部) | 读引擎 JSON + 新闻,综合裁决并输出 |
数据流(单次预测)
cron 触发 (每根 5min K线 第4分钟)
│
├─ 5minbtc-log.py settle-all ← 结算上一根 K 线(写入实际收盘)
│
├─ 5minbtc-engine-v6.0.py ← 引擎核心
│ │
│ ├─ ThreadPoolExecutor(4) 并行:
│ │ ├─ Binance Klines (200 根 5min K线)
│ │ ├─ Binance Depth (订单簿 top-20)
│ │ ├─ alternative.me FNG (恐惧贪婪指数)
│ │ └─ Coinbase BTC-USD (Chainlink 参考)
│ │
│ ├─ 指标: EMA9/21, RSI, MACD, Bollinger, Wilder ATR, Vol-Regime
│ ├─ 12 正交因子 → score → bias / confidence
│ ├─ 黑天鹅过滤 (ATR spike / FNG<25 / 新闻熔断)
│ └─ Chainlink 偏移补偿 (±$300 上限)
│
├─ 5minbtc-news.py ← 写 news-risk-level.json
│
└─ LLM 读取引擎 JSON + 3 路新闻 → 裁决 → 写日志
引擎单次执行约 ~3 秒(v5.7.3 并行化后,原串行 ~11–18 秒)。
12 正交因子体系
v5.0 起用正交因子替代共线指标,所有阈值经 ATR 归一化,避免波动率变化导致阈值失效。
| 因子 | 类别 | 含义 |
|---|---|---|
momentum |
趋势 | EMA9−EMA21 差值,ATR 归一化的 t-stat |
meanrev |
均值回归 | 偏离布林带中轨程度 |
rsi |
动量 | Wilder RSI 的 Z-score |
volume |
量能 | 条件化放量信号(区分突破 vs 衰竭) |
fatigue |
衰竭 | 趋势动能衰减检测 |
imbalance |
微结构 | 订单簿买卖盘失衡 |
microprice |
微结构 | Stoikov microprice 偏离 mid |
decel |
衰竭 | 价格变化减速(动量冲突时动态降权) |
position |
位置 | K 线在布林带中的相对位置 |
v_reversal |
反转 | 低点抬高 + 收>开 的 V 型反转模式 |
vol_breakout |
突破 | 最近 3 根完成 K 线的放量突破 |
half_body |
半 K 线 | 核心 edge:progress≥45% 时已形成 body 的延续性 |
权重由 BASE_W 表给定,并随波动率 Regime(TREND / RANGE / HIGH_VOL / LOW_VOL)动态调整。
半 K 线预测策略(Half‑Candle)
这是 v5.7 的核心贡献,也是实盘 edge 的正式建模:
- S1:在 K 线进度 ≥ 45% 时激活
half_body因子——已经形成的 body 方向在剩余时间内倾向于延续。 - S2:预测范围收窄——ATR 乘数 × 0.55,只预测剩余 ~55% 时间内的波动。
- S3:调度时机从每根 K 线第 2 分钟推迟到第 4 分钟(progress ~60–80%),让前半段充分形成信号再预测后半段。
实证:回测中 11 因子组合无预测力(47–49%),但实盘 66% 的胜率主要来自 progress=0.9+ 时"确认已有走势"——
half_body把这个隐性逻辑变成了显式因子。
黑天鹅三重防护(v5.7.1)
引擎在输出预测前进行三层过滤,任一触发即压低置信度或转为 neutral:
- ATR Spike 检测:当前 ATR 相对历史出现尖峰时,方向可靠性下降。
- FNG < 25 过滤:恐惧贪婪指数低于 25(极度恐慌)时标记
fng_black_swan。 - 新闻冲击熔断:
5minbtc-news.py写入BLACK_SWAN/CRITICAL时,引擎强制 bias=neutral、confidence=30。
数据源
全部为公开、免认证接口,零 API Key:
| 数据 | 来源 | 用途 |
|---|---|---|
| K 线 | data-api.binance.vision/api/v3/klines |
200 根 5min OHLCV |
| 订单簿 | data-api.binance.vision/api/v3/depth |
top-20 bids/asks |
| 恐惧贪婪 | api.alternative.me/fng/ |
黑天鹅过滤 |
| 参考价 | api.coinbase.com/v2/prices/BTC-USD/spot |
Chainlink 偏移补偿 |
| 新闻 | www.coindesk.com/.../rss/ |
风险等级(~14min 延迟) |
快速开始
依赖:仅 Python 3.8+ 标准库,无需 pip install 任何第三方包。
# 单次运行引擎(输出预测 JSON 到 stdout)
python3 5minbtc-engine-v6.0.py
# 单独跑新闻扫描
python3 5minbtc-news.py
# 结算上一根 K 线 + 追加新预测
python3 5minbtc-log.py settle-all
python3 5minbtc-log.py log "<candle.iso>" <pred_close> <pred_high> <pred_low> \
<conf> <bias> <news_sent> <vol_pct>
引擎输出示例(节选):
{
"version": "5.7.3",
"candle": { "progress_pct": 72.3, "...": "..." },
"indicators": { "ema9": 61950.1, "rsi": 47.2, "atr": 85.4, "...": "..." },
"factors": { "half_body": -0.31, "momentum": -0.42, "...": "..." },
"regime": "TREND",
"news_risk": "NORMAL",
"prediction": {
"bias": "bear", "strength": "moderate",
"confidence": 48, "pred_close": 61920, "pred_high": 61960, "pred_low": 61870
}
}
完整运行流程
完整的"引擎 + LLM"混合流程由 cron 每 5 分钟触发:
SKILL_DIR=/path/to/5minbtc
# 1. 并行执行:结算 + 引擎 + 新闻
python3 $SKILL_DIR/5minbtc-log.py settle-all
python3 $SKILL_DIR/5minbtc-engine-v6.0.py
python3 $SKILL_DIR/5minbtc-news.py
# 2. LLM 侧:3 路并行新闻搜索
# - "Bitcoin BTC breaking news price"
# - "crypto market macro stocks today"
# - "比特币 BTC 最新 晚间"
# 3. LLM 综合引擎 JSON + 新闻 → 按模板输出(15–25 行)
# 4. 写入预测日志
python3 $SKILL_DIR/5minbtc-log.py log "<candle.iso>" <pred_close> ...
💡 用
cp .env.example .env并设置SKILL_DIR指向你的克隆目录,可避免把路径写死。详见 配置说明。
目录结构
5minbtc/
├── 5minbtc-engine-v6.0.py # 主引擎(cron 调用,输出预测 JSON)
├── 5minbtc-engine-v5.py # v5 旧版(回测因子模块 import 用)
├── 5minbtc-news.py # 新闻扫描(CoinDesk RSS)
├── 5minbtc-log.py # 日志记录 + settle
├── SKILL.md # 技能索引文档(Hermes/Claude skill 格式)
├── README.md # 本文件
├── .env.example # 配置模板
├── 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/ # 缓存的 K 线 JSON
│ └── results/ # 回测结果(.gitignore)
├── references/ # 深度文档(架构/教训/pitfalls/黑天鹅…)
├── reviews/ # 每日复盘报告(按月归档)
├── scripts/ # 辅助脚本
└── data/ # 运行时数据(新闻风险等级,.gitignore)
回测系统
cd backtest
# 一键回测(下载最新数据 + 运行)
./run.sh
# 快速模式(每小时采样,最近 180 天)
./run.sh --fast
# 最近 90 天,每 6 根 K 线采样
./run.sh --days 90 --sample=6
# 完整因子贡献分析
./run.sh --full-report
# 模拟 K 线进度(progress=0.5 = 中段)
python3 run_backtest.py --progress=0.5
公平性保障:
- 无前视偏差(当前 K 线价格信息被屏蔽:c=h=l=open, v=0)
- 因子仅基于 200 根已完成 K 线计算
- 回测中订单簿不可获取,imbalance/microprice 设为 0
性能快照
以下为历史实测数据,过去表现不代表未来收益,且小样本下统计显著性有限。
| 版本 | 设定 | 方向准确率 |
|---|---|---|
| v4.x | 实盘 | 62.5% |
| v5.7.1 | 实盘 273 轮 | 75.7% (+13.2pp) |
| v5.8 | 回测(前 2 根 1min) | 61.4% |
| v5.8 | 回测(前 4 根 1min) | 69.5% |
⚠️ 见 references/backtest-findings.md:公平回测下纯价格因子无预测力。实盘高胜率很可能部分来自小样本 + K 线后段信息优势,并非稳定 edge。在 edge 来源明确前,不应按高胜率预期下注。
配置说明
当前引擎不读取任何环境变量——所有参数(symbol、interval、HTTP timeout、ATR 乘数、因子权重)均硬编码在 .py 源码中,这保证了 cron 调用的零配置可复现性。
.env.example 列出了建议配置化的项(当前为预留/文档用途),供希望二次开发的用户参考。如需让引擎实际读取这些变量,需要修改对应源码(欢迎 PR)。
主要硬编码常量位置:
| 常量 | 默认值 | 位置 |
|---|---|---|
symbol |
BTCUSDT |
fetch_klines() / fetch_depth() 形参 |
interval |
5m |
fetch_klines() 形参 |
| HTTP timeout | 5–10 s |
urlopen() 调用 |
| ATR 乘数 | 0.55 |
predict_close_v5() |
BASE_W |
因子权重表 | 模块级常量 |
REGIME_ADJ |
Regime 权重调整 | 模块级常量 |
已知局限
- 回测与实盘的差距:公平回测下因子无预测力,实盘 edge 主要来自 K 线后段信息优势(可能不稳定的"半前视")。
- 订单簿简化:仅用 top-20 深度,未实现完整的 OFI(Cont et al. 2014)与 microprice 模型。
- 新闻延迟:CoinDesk RSS 约 14 分钟延迟,无法捕捉瞬时冲击。
- SSL 验证禁用:引擎全局设置
ssl._create_unverified_context,是为对抗高延迟网络下的 SSL 握手超时(见references/high-latency-network-handling.md)。在可信网络环境下可安全恢复验证。 - 无自动交易:本项目只输出预测,不执行任何下单。
路线图
- ✅ OFI 微结构因子(v6.0 已落地):引擎现由真 OFI 净流一票决定方向 +
P(close>open|ofi)概率, 见 SKILL.md 架构 与 strategy-adversarial-review.md - 🟡 HMM Regime 检测 + 自适应仓位
- 🟡 LightGBM 自动化因子筛选
- 🟡 CVaR 动态止损
- 🟢 TFT 多时间尺度模型替代贝叶斯引擎
原
references/architecture.md(13 因子模型 + 升级路线图)已于 2026-09-10 删除: 其"13 正交因子"描述被 v5.9 清零、OFI 也已从路线图变为已实现,内容已由 changelog.md 与 SKILL.md 取代。
- 🟢 Deribit 期权 IV 信号
免责声明 (NOT FINANCIAL ADVICE)
本项目是量化研究与教育项目,不构成投资建议、交易信号或任何形式的财务建议。
- 加密货币市场波动剧烈,交易可能导致全部本金损失。
- 引擎预测存在显著误差,历史准确率不代表未来表现。
- 作者与贡献者对任何基于本项目的交易决策不承担责任。
- 请在了解当地法律法规的前提下自行承担风险。
如本项目对你有帮助,欢迎 Star。但请勿将其视为稳赚的交易工具。
License
本项目暂未指定开源许可证。如需使用、修改或分发代码,请先联系作者或等待 License 文件添加。在未指定 License 前,根据默认版权法,代码保留全部权利(仅供阅读与学习)。
Skill manifest
5minbtc — BTC 5分钟实时预测 v6.0.0
BTC 单根 5min K线 方向 + 收盘价预测。引擎+LLM 混合架构。 SKILL.md 是索引, 详细内容见
references/。 v5.9 认知转变: 从"13因子预测器"→"3信号错价检测器" — 方向准确率不是 edge,EV = p − P − 成本才是 (见 对抗式审查报告) v6.0 执行转变: 方向从"body 延续统计"改成真 OFI 净流一票决定 — 赌的是"净流已发生、token 价还没定价"的 flow-gap
⚠️ 同名易混: 本 skill 只做 BTC 单标的 5min 方向 + 预测市场 EV。要做全市场永续的量价突破扫描, 用
coin-vp-scanner— 两者区别见下方 与 coin-vp-scanner 的分工。
触发
5minbtc / 5min btc / btc 5min / 监控 (配合持续盯盘)
何时使用
| 场景 | 做法 |
|---|---|
| 当前 5min K线 方向+价位 | ✅ 标准流程, 方向=OFI 净流, edge=错价 EV (v5.8 零前视回测 61.4% 是延续性不是 alpha, 见性能快照) |
| 会话内持续盯盘, 等明确信号 | ✅ 监控模式 (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 scripts/test_engine.py(13 项, 自带 runner 无需 pytest; 慢测加--slow) — 装了 pytest 也可python3 -m pytest scripts/test_engine.py -v(原文件名test_engine_v58.py带版本号, 引擎升到 v6.0 后即漂移, 2026-09-10 改为不带版本号)
快速开始
SKILL_DIR=$HOME/.hermes/profiles/cqo/skills/5minbtc
# 1. 并行: 引擎 + 新闻 + settle (前一根)
python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1
python3 $SKILL_DIR/5minbtc-engine-v6.0.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-v6.0.py(v6.0, 输出"version": "6.0.0"): bias 由真 OFI 净流一票决定 (ofi_n>0→bull / <0→bear, 二选一无中性; ofi_n 缺失/为0 用 body 符号兜底并标meta.body_fallback) + 概率P(close>open|ofi)三层(经验校准表 Bayesian shrink + flow-gap + 最近60s流) + 三层独立过滤(多周期4h/1h/15m 结构 + 跨资产ETH/SOL 广度 + WS OFI 新鲜度反转保护) + 9路并行HTTP- ⚠️ K 线开局阶段概率不可信(已知问题,见 pitfalls):主源
ofi_n = 2*(tb/v)−1取自当前进行中的 K 线,_ofi_native()只挡v<=0、无最小样本量保护 → 开局几秒的少量成交就能把 ofi_n 推到 ±0.9。而vol_gate(L692 按MIN_VOL_FRAC=0.25判断流量是否够)算出来但从不参与任何决策,只是输出里的装饰字段。建议只在进度 ≥40% 后采信概率/下单 - 门限:
T_OFI_GATE=0.20/T_OFI_60=0.35/ WS 质量闸OFI_CR_MIN=0.80/OFI_BAYES_N=30 - 13 因子仍计算并输出(JSON 契约保留), 但自 v6.0 起不参与 bias 决策 — score 只用于
strength标签与 LLM 参考
- ⚠️ K 线开局阶段概率不可信(已知问题,见 pitfalls):主源
- 订单流
scripts/ofi_feed.py: trade+bookTicker 组合流 tick规则推断主动买卖, 写~/bb-auto/ofi.json, 带 ts 保鲜(>30s 引擎降级为只信 REST 主源) (launchd: com.daniel.ofi-feed) - 日志
5minbtc-log.py: jsonl 追加 + 增量 settle (写入 logs/) - 新闻
5minbtc-news.py: CoinDesk RSS (唯一稳定源, ~14min 延迟) - 常驻进程 (launchd):
5minbtc_realtime.py(5s 刷新, 预测快照+EV下单) /5minbtc_watch.py/5minbtc_trader.py --paper-monitor - LLM: 因子打分基准 + LLM 综合裁决 + 模板输出
铁律
- 每次必须重新执行引擎脚本 — 不缓存
- 每次必须重新搜索3组新闻
- 先 settle 上一根, 再 log 新预测
- LLM 可微调引擎的
pred_close/range, 但必须说明理由 ⚠️ bias 不要轻易覆盖 (v6.0): 方向是 OFI 一票决定的, LLM 用因子/新闻翻方向 = 退回被证伪的路径。 仅在meta.body_fallback=True或 OFI 数据缺失时才允许改 bias, 并显式写明原因。 - 输出 15-25 行 (平衡深度和 Telegram 可读性)
关键裁决规则 (⚠️ 历史规则: v5.7.x 因子打分路径)
v6.0 起 bias 由真 OFI 一票决定, 下列规则不再决定方向。 仅在两条兜底路径上仍有参考价值: ①
meta.body_fallback=True(ofi_n 缺失/为0, 方向退回 body 符号) ② LLM 复核时解释meta冲突字段。 引擎的raw score仍输出, 但只影响strength标签, 不影响 bias。
- half_body vs imbalance 冲突 (v5.7.2): |half_body|>0.25 + |imbalance|>0.5 + progress≥45% → 优先 half_body (注: 两者自 v5.9 起权重已清零)
- 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-09-10 更新)
数字口径以 对抗式审查报告 为准 — 旧数字多数含前视偏差。
- v5.7 回测 71.2% 含前视偏差(文件里自己标注"已知"); 零前视 v5.8: 前2根1min=61.4%, 前4根=69.5%
- 但 61–70% 是"看着 K 线走完再确认"的延续性, 不是 alpha — 做市商已把它定价进 token 价
- 去掉水分后的真实基准: non-neutral 方向 57.7% | bull 63.9% (唯一显著) | bear 50.0% = 纯硬币
- paper 交易: 全样本 UP 成交 44% (+$0.24) | 甜区 UP ask 0.40–0.50 → 60% (+$1.39) ← 唯一正 EV 区间
- 结论: edge 不在方向准不准, 在
EV = p − P − 成本 > 0。v6.0 的错价检测(flow-gap)就是直接做这件事。 - 当前 LLM:
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 — 20 条 pitfalls 集中索引 (必读, 含并行 max() 评估陷阱; #18 = K线开局概率不可信; #19 = "真OFI" 只覆盖单一市场; #20 = 端点故障致静默断档)
- changelog.md — v5.0 ~ v6.0 详细变更
- skill-organization.md — Skill 文件结构模式 (可复用) — SKILL.md INDEX + references/ 分专题
执行与输出
- execution.md — 完整执行步骤 + 铁律 + 宽窗口处理
- output-template.md — LLM 输出模板 + 裁决规则
- monitoring-claude-code.md — 监控模式: Monitor 工具集成 + 事件协议
- telegram-push-monitor.md — Telegram 推送 daemon: watch 采样节奏/事件类型/记录与结算/launchd 持久化
- 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 超时)
Binance 三种故障模式各一份(431/451 区域、隧道抖动、高延迟 SSL 超时),不是重复文档,见 setup-from-scratch.md §6。
引擎专项
- cron-llm-provider-failure.md — Cron LLM Provider 失效诊断 (含 job 列表 §8) + 版本同步规则
回测 & 复盘
- backtest-findings.md — 365 天回测深度复盘 + 因子无预测力
- backtest-v58-1min-findings.md — v5.8 真实 1min 半 K线回测
- review-procedure.md — 每日复盘流程 + 数据质量检查
数据采集 & 仓库
- sync-procedure.md — AGI-Super-Team 同步流程 (路径映射 +
-c校验 + logs 归档策略) - archive.md — 版本归档: v5.0→v6.0 沿革 + 哪些版本已不可取回 + 归档 SOP
- setup-from-scratch.md — 从零搭建: 依赖/目录/密钥/6 个 launchd 服务/验证清单/日志轮转/故障表
- scheduled-tasks.md — 系统级定时任务教程: 常驻型vs定时型 / 2 个任务 / launchd+cc-connect+hermes 三路线 / plist 模板 / 13 条坑
- quant-knowledge-index.md — 50 轮蒸馏知识库索引
复盘记录
⚠️ reviews/ 目录本地不存在 —— 早期文件树声称有 23 份按月归档的复盘记录(2026-05/06/07),实际从未落盘。
复盘结论目前散落在 lessons.md、pitfalls.md、
strategy-adversarial-review.md 与 reports/ 里。
若要恢复这个习惯,需先补 review-procedure.md 的落盘步骤,别只在文档里声明。
报告库
14 份深度蒸馏报告在 reports/ 目录 (也同步在 AGI-Super-Team): R01-R14。
与 coin-vp-scanner 的分工
两个都是交易类 skill, 但赌的不是同一件事, 不要混用:
| 5minbtc (本 skill) | coin-vp-scanner | |
|---|---|---|
| 标的 | 单标的 BTC | 全量币安 USDT 永续 |
| 周期 | 单根 5min K线 | 1–30min 短线 |
| 核心逻辑 | 真 OFI 净流 + 错价检测 (净流已发生、token 价未定价 → flow-gap) | 确定性结构突破 (放量 + 强实体 + 收盘破 1h 结构位 + 趋势同向, 四条全 ✓) |
| 决策依据 | 概率 P(close>open\|ofi) vs 市场 token 价 → EV = p − P |
结构规则布尔判定, 非概率 |
| 输出 | 方向 bull/bear + 概率 + edge | 杠杆 / TP / SL 交易卡 |
| 落地方式 | 预测市场 Up/Down token, 仅 paper (LIVE_GATE 硬闸门) |
直接做合约短线 |
| 代码位置 | 本目录自包含 (引擎+脚本+launchd) | 代码在 ~/projects/coin-vp-scanner/, 本 skill 只是索引 |
一句话选型: 要赌"市场定价错了" → 5minbtc; 要抓"价格放量破位了" → coin-vp-scanner。
仓库同步
详见 sync-procedure.md。简述:
rsync -av --exclude='data/' --exclude='__pycache__/' \
--exclude='*.jsonl' --exclude='*.jsonl.*' --exclude='*.gz' \
$HOME/.hermes/profiles/cqo/skills/5minbtc/ \
$HOME/clawd/repos/AGI-Super-Team/skills/5minbtc/
cd $HOME/clawd/repos/AGI-Super-Team
git add skills/5minbtc/ && git commit -m "sync(skills/5minbtc): <版本>" && git push origin main
回测系统
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-v6.0.py # 主引擎 (v6.0 真OFI 一票定方向, launchd 调用)
├── 5minbtc-news.py # 新闻扫描 (CoinDesk RSS, 唯一稳定源)
├── 5minbtc-log.py # 日志记录 (写入 logs/)
├── logs/ # 日志 (当月 live + 历史按月压缩)
│ ├── 5minbtc-log.jsonl # 当月 live (不入库)
│ └── archive/*.jsonl.gz # 月度压缩归档 (入库, 见 archive.md)
├── references/ # 24 份专项 ref (含 skill-organization 模式)
├── backtest/ # 回测系统 (results/ 不入库)
├── 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, launchd com.daniel.ofi-feed)
│ ├── 5minbtc_keyless_paper.py # 免密钥模拟盘 (公开BTC数据模拟UP/DOWN价)
│ ├── telegram_push.py # 通用 Telegram 推送助手
│ ├── daily-review-stats.py
│ └── fetch-github-repo.sh
⚠️
archive/目录与reviews/目录本地并不存在 —— 本文件早期版本的文件树里声称有它们(还列了 23 份复盘),属于文档/现实漂移,已更正为上面的实际结构:
- 旧版本引擎源码不保留在本地,只留文字归档 → references/archive.md
- 每日复盘从未落盘到
reviews/,复盘结论散在references/lessons.md/pitfalls.md与reports/
最后更新: 2026-09-10 — 引擎 v5.7→v6.0 改名 (文件/SKILL/引用全线对齐, 修引擎内"无中性"过期注释) + SKILL.md 版本刷到 6.0.0 + 性能快照改为审查后的诚实口径 + 补 v5.9/v5.10/v6.0 changelog + 新增与 coin-vp-scanner 的分工说明 + 修文件树未闭合的代码块与 archive//reviews/ 假目录声明 + 新增 archive.md 与 setup-from-scratch.md + logs 月度压缩归档入库
Files (agi-super-team)
-
backtest
-
results
-
backtest_20260527_2328.json 16.3 MB
Loading… -
backtest_v57_20260528_1433.json 7.1 KB
Loading… -
backtest_v58_1min_20260528_2018.json 3.7 KB
Loading… -
backtest_v58_1min_20260528_2019.json 2 KB
Loading… -
backtest_v58_1min_20260528_2020.json 2 KB
Loading… -
latest_summary.json 5.1 KB
Loading… -
latest_v57_summary.json 10 KB
Loading… -
latest_v58_1min_summary.json 245 B
Loading…
-
-
fetch_data.py 6 KB
Loading… -
README.md 2.7 KB
Loading… -
run.sh 2.8 KB
Loading… -
run_backtest.py 19.7 KB
Loading… -
run_backtest_v57.py 25 KB
Loading… -
run_backtest_v58.py 19.8 KB
Loading…
-
-
logs
-
archive
-
5minbtc-log.2026-08.jsonl.gz 429.2 KB · in bundle
-
5minbtc-log.2026-09.jsonl.gz 636.5 KB · in bundle
-
-
-
references
-
archive.md 7.9 KB
Loading… -
backtest-findings.md 4.7 KB
Loading… -
backtest-v58-1min-findings.md 3.1 KB
Loading… -
binance-api-geo.md 2.4 KB
Loading… -
binance-endpoint-flapping.md 3.4 KB
Loading… -
changelog.md 13 KB
Loading… -
cron-llm-provider-failure.md 12.4 KB
Loading… -
execution.md 2 KB
Loading… -
high-latency-network-handling.md 3.3 KB
Loading… -
lessons.md 14.7 KB
Loading… -
monitoring-claude-code.md 4.9 KB
Loading… -
news-sources.md 812 B
Loading… -
output-template.md 12.2 KB
Loading… -
pitfalls.md 29.9 KB
Loading… -
prediction-market-strategy.md 6.7 KB
Loading… -
prediction-trading-cli.md 7.5 KB
Loading… -
quant-knowledge-index.md 3.5 KB
Loading… -
review-procedure.md 1.6 KB
Loading… -
scheduled-tasks.md 13.5 KB
Loading… -
setup-from-scratch.md 8.9 KB
Loading… -
skill-organization.md 3.6 KB
Loading… -
strategy-adversarial-review.md 18.9 KB
Loading… -
sync-procedure.md 4.5 KB
Loading… -
telegram-push-monitor.md 2.8 KB
Loading…
-
-
reports
-
R01-factor-theory.md 4.5 KB
Loading… -
R02-strategy-theory.md 4.9 KB
Loading… -
R03-crypto-quant-defi.md 4 KB
Loading… -
R04-portfolio-theory.md 4.8 KB
Loading… -
R05-ml-quant-trading.md 4.5 KB
Loading… -
R06-data-sources.md 5.1 KB
Loading… -
R07-frontier-research-2024-2026.md 5.3 KB
Loading… -
R08-options-volatility.md 6.8 KB
Loading… -
R09-market-microstructure.md 8.6 KB
Loading… -
R10-risk-management-frontier.md 7.3 KB
Loading… -
R11-institutional-methodology.md 5.4 KB
Loading… -
R12-integration-blueprint.md 9.9 KB
Loading… -
R13-accuracy-optimization-plan.md 8.8 KB
Loading… -
R14-engine-audit-report.md 4.2 KB
Loading…
-
-
scripts
-
5minbtc-engine-server.py 3.2 KB
Loading… -
5minbtc-monitor.py 6.8 KB
Loading… -
5minbtc_day_stats.py 4.2 KB
Loading… -
5minbtc_keyless_paper.py 12.7 KB
Loading… -
5minbtc_order.py 4 KB
Loading… -
5minbtc_realtime.py 22.1 KB
Loading… -
5minbtc_signal_stats.py 7.2 KB
Loading… -
5minbtc_trader.py 59.6 KB
Loading… -
5minbtc_watch.py 15 KB
Loading… -
daily-review-stats.py 7.7 KB
Loading… -
engine_client.py 2.1 KB
Loading… -
fetch-github-repo.sh 2.3 KB
Loading… -
ofi_feed.py 8.1 KB
Loading… -
prediction_ws_feed.py 7.9 KB
Loading… -
telegram_push.py 2 KB
Loading… -
test_engine.py 9.6 KB
Loading…
-
-
.env.example 3.5 KB · in bundle
-
.gitignore 626 B · in bundle
-
.npmignore 97 B · in bundle
-
5minbtc-engine-v6.0.py 52.2 KB
Loading… -
5minbtc-log.py 11.8 KB
Loading… -
5minbtc-news.py 7.9 KB
Loading… -
README.md 14.7 KB
# 5minbtc — BTC 5 分钟实时方向预测引擎 > 引擎 + LLM 混合架构:**真 OFI 净流定方向 + 错价检测定 edge**,LLM 综合裁决,预测 BTC 单根 5 分钟 K 线的方向与收盘价区间。 > > ⚠️ **v6.0 起方向不再来自因子打分** — 13 个价量因子中 11 个经公平回测为 47–49%(等同抛硬币),现仅保留输出供参考,方向由当前 K 线原生 OFI 净流一票决定。详见 [对抗式审查报告](references/strategy-adversarial-review.md)。 > > ⚠️ **NOT FINANCIAL ADVICE / 非投资建议** — 本项目仅为量化研究与学习目的,不构成任何投资、交易或持仓建议。预测存在显著误差,实际交易将面临资金损失风险。详见文末 [免责声明](#免责声明-not-financial-advice)。 []() []() []() --- ## 目录 - [核心理念](#核心理念) - [系统架构](#系统架构) - [12 正交因子体系](#12-正交因子体系) - [半 K 线预测策略](#半-k-线预测策略half--candle) - [黑天鹅三重防护](#黑天鹅三重防护) - [数据源](#数据源) - [快速开始](#快速开始) - [完整运行流程](#完整运行流程) - [目录结构](#目录结构) - [回测系统](#回测系统) - [性能快照](#性能快照) - [配置说明](#配置说明) - [已知局限](#已知局限) - [路线图](#路线图) - [免责声明](#免责声明-not-financial-advice) - [License](#license) --- ## 核心理念 5minbtc 解决一个具体问题:**在每根 5 分钟 BTC K 线进行到 ~60–80% 时,预测这根 K 线收盘时的方向和价格区间**。 它不是全自动交易机器人,而是一个 **引擎 + LLM 混合决策系统**: ``` 量化引擎 (12 因子 + ATR 归一化) LLM (新闻 + 因子 + 裁决规则) ┌─────────────────────────┐ ┌──────────────────────────┐ │ 4 路并行拉取市场数据 │ JSON → │ 3 路并行新闻搜索 │ │ 12 正交因子打分 │ ──────→ │ 综合裁决 (可微调引擎结论) │ │ Platt Scaling 置信度 │ │ 模板化输出 (15–25 行) │ └─────────────────────────┘ └──────────────────────────┘ 纯 Python 标准库 可由 cron 调度 ``` **为什么要混合?** 回测证明:纯价格因子在公平(无前视)条件下无显著预测力(47–49%)。实盘的 edge 主要来自 K 线后段(progress ≥ 0.9)的"已确认走势延续"以及新闻冲击。把数值因子交给 LLM 做上下文综合,比纯规则或纯 LLM 都更稳健。 ## 系统架构 ### 组件 | 组件 | 文件 | 职责 | |------|------|------| | **引擎** | `5minbtc-engine-v6.0.py` | 拉数据 → 计算 OFI(`ofi_n=2*(tb/v)-1`) → **OFI 一票定方向** + 概率 `P(close>open\|ofi)` → 输出预测 JSON(stdout)。13 因子仍计算但只作参考 | | **新闻** | `5minbtc-news.py` | 抓取 CoinDesk RSS,输出风险等级到 `data/news-risk-level.json` | | **日志** | `5minbtc-log.py` | 预测记录追加(jsonl)+ 增量 settle(结算上一根 K 线实际结果) | | **回测** | `backtest/*.py` | 历史数据回测,多版本(v5.6 / v5.7 / v5.8)| | **LLM** | (外部) | 读引擎 JSON + 新闻,综合裁决并输出 | ### 数据流(单次预测) ``` cron 触发 (每根 5min K线 第4分钟) │ ├─ 5minbtc-log.py settle-all ← 结算上一根 K 线(写入实际收盘) │ ├─ 5minbtc-engine-v6.0.py ← 引擎核心 │ │ │ ├─ ThreadPoolExecutor(4) 并行: │ │ ├─ Binance Klines (200 根 5min K线) │ │ ├─ Binance Depth (订单簿 top-20) │ │ ├─ alternative.me FNG (恐惧贪婪指数) │ │ └─ Coinbase BTC-USD (Chainlink 参考) │ │ │ ├─ 指标: EMA9/21, RSI, MACD, Bollinger, Wilder ATR, Vol-Regime │ ├─ 12 正交因子 → score → bias / confidence │ ├─ 黑天鹅过滤 (ATR spike / FNG<25 / 新闻熔断) │ └─ Chainlink 偏移补偿 (±$300 上限) │ ├─ 5minbtc-news.py ← 写 news-risk-level.json │ └─ LLM 读取引擎 JSON + 3 路新闻 → 裁决 → 写日志 ``` 引擎单次执行约 **~3 秒**(v5.7.3 并行化后,原串行 ~11–18 秒)。 ## 12 正交因子体系 v5.0 起用正交因子替代共线指标,所有阈值经 **ATR 归一化**,避免波动率变化导致阈值失效。 | 因子 | 类别 | 含义 | |------|------|------| | `momentum` | 趋势 | EMA9−EMA21 差值,ATR 归一化的 t-stat | | `meanrev` | 均值回归 | 偏离布林带中轨程度 | | `rsi` | 动量 | Wilder RSI 的 Z-score | | `volume` | 量能 | 条件化放量信号(区分突破 vs 衰竭)| | `fatigue` | 衰竭 | 趋势动能衰减检测 | | `imbalance` | 微结构 | 订单簿买卖盘失衡 | | `microprice` | 微结构 | Stoikov microprice 偏离 mid | | `decel` | 衰竭 | 价格变化减速(动量冲突时动态降权)| | `position` | 位置 | K 线在布林带中的相对位置 | | `v_reversal` | 反转 | 低点抬高 + 收>开 的 V 型反转模式 | | `vol_breakout` | 突破 | 最近 3 根完成 K 线的放量突破 | | **`half_body`** | **半 K 线** | **核心 edge:progress≥45% 时已形成 body 的延续性** | 权重由 `BASE_W` 表给定,并随波动率 Regime(TREND / RANGE / HIGH_VOL / LOW_VOL)动态调整。 ## 半 K 线预测策略(Half‑Candle) 这是 v5.7 的核心贡献,也是实盘 edge 的正式建模: - **S1**:在 K 线进度 ≥ 45% 时激活 `half_body` 因子——已经形成的 body 方向在剩余时间内倾向于延续。 - **S2**:预测范围收窄——ATR 乘数 × 0.55,只预测剩余 ~55% 时间内的波动。 - **S3**:调度时机从每根 K 线第 2 分钟推迟到第 4 分钟(progress ~60–80%),让前半段充分形成信号再预测后半段。 > 实证:回测中 11 因子组合无预测力(47–49%),但实盘 66% 的胜率主要来自 progress=0.9+ 时"确认已有走势"——`half_body` 把这个隐性逻辑变成了显式因子。 ## 黑天鹅三重防护(v5.7.1) 引擎在输出预测前进行三层过滤,任一触发即压低置信度或转为 neutral: 1. **ATR Spike 检测**:当前 ATR 相对历史出现尖峰时,方向可靠性下降。 2. **FNG < 25 过滤**:恐惧贪婪指数低于 25(极度恐慌)时标记 `fng_black_swan`。 3. **新闻冲击熔断**:`5minbtc-news.py` 写入 `BLACK_SWAN`/`CRITICAL` 时,引擎强制 bias=neutral、confidence=30。 ## 数据源 全部为**公开、免认证**接口,零 API Key: | 数据 | 来源 | 用途 | |------|------|------| | K 线 | `data-api.binance.vision/api/v3/klines` | 200 根 5min OHLCV | | 订单簿 | `data-api.binance.vision/api/v3/depth` | top-20 bids/asks | | 恐惧贪婪 | `api.alternative.me/fng/` | 黑天鹅过滤 | | 参考价 | `api.coinbase.com/v2/prices/BTC-USD/spot` | Chainlink 偏移补偿 | | 新闻 | `www.coindesk.com/.../rss/` | 风险等级(~14min 延迟)| ## 快速开始 **依赖**:仅 Python 3.8+ 标准库,无需 `pip install` 任何第三方包。 ```bash # 单次运行引擎(输出预测 JSON 到 stdout) python3 5minbtc-engine-v6.0.py # 单独跑新闻扫描 python3 5minbtc-news.py # 结算上一根 K 线 + 追加新预测 python3 5minbtc-log.py settle-all python3 5minbtc-log.py log "<candle.iso>" <pred_close> <pred_high> <pred_low> \ <conf> <bias> <news_sent> <vol_pct> ``` 引擎输出示例(节选): ```json { "version": "5.7.3", "candle": { "progress_pct": 72.3, "...": "..." }, "indicators": { "ema9": 61950.1, "rsi": 47.2, "atr": 85.4, "...": "..." }, "factors": { "half_body": -0.31, "momentum": -0.42, "...": "..." }, "regime": "TREND", "news_risk": "NORMAL", "prediction": { "bias": "bear", "strength": "moderate", "confidence": 48, "pred_close": 61920, "pred_high": 61960, "pred_low": 61870 } } ``` ## 完整运行流程 完整的"引擎 + LLM"混合流程由 cron 每 5 分钟触发: ```bash SKILL_DIR=/path/to/5minbtc # 1. 并行执行:结算 + 引擎 + 新闻 python3 $SKILL_DIR/5minbtc-log.py settle-all python3 $SKILL_DIR/5minbtc-engine-v6.0.py python3 $SKILL_DIR/5minbtc-news.py # 2. LLM 侧:3 路并行新闻搜索 # - "Bitcoin BTC breaking news price" # - "crypto market macro stocks today" # - "比特币 BTC 最新 晚间" # 3. LLM 综合引擎 JSON + 新闻 → 按模板输出(15–25 行) # 4. 写入预测日志 python3 $SKILL_DIR/5minbtc-log.py log "<candle.iso>" <pred_close> ... ``` > 💡 用 `cp .env.example .env` 并设置 `SKILL_DIR` 指向你的克隆目录,可避免把路径写死。详见 [配置说明](#配置说明)。 ## 目录结构 ``` 5minbtc/ ├── 5minbtc-engine-v6.0.py # 主引擎(cron 调用,输出预测 JSON) ├── 5minbtc-engine-v5.py # v5 旧版(回测因子模块 import 用) ├── 5minbtc-news.py # 新闻扫描(CoinDesk RSS) ├── 5minbtc-log.py # 日志记录 + settle ├── SKILL.md # 技能索引文档(Hermes/Claude skill 格式) ├── README.md # 本文件 ├── .env.example # 配置模板 ├── 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/ # 缓存的 K 线 JSON │ └── results/ # 回测结果(.gitignore) ├── references/ # 深度文档(架构/教训/pitfalls/黑天鹅…) ├── reviews/ # 每日复盘报告(按月归档) ├── scripts/ # 辅助脚本 └── data/ # 运行时数据(新闻风险等级,.gitignore) ``` ## 回测系统 ```bash cd backtest # 一键回测(下载最新数据 + 运行) ./run.sh # 快速模式(每小时采样,最近 180 天) ./run.sh --fast # 最近 90 天,每 6 根 K 线采样 ./run.sh --days 90 --sample=6 # 完整因子贡献分析 ./run.sh --full-report # 模拟 K 线进度(progress=0.5 = 中段) python3 run_backtest.py --progress=0.5 ``` **公平性保障**: - 无前视偏差(当前 K 线价格信息被屏蔽:c=h=l=open, v=0) - 因子仅基于 200 根已完成 K 线计算 - 回测中订单簿不可获取,imbalance/microprice 设为 0 详见 [`backtest/README.md`](backtest/README.md)。 ## 性能快照 > 以下为历史实测数据,**过去表现不代表未来收益**,且小样本下统计显著性有限。 | 版本 | 设定 | 方向准确率 | |------|------|-----------| | v4.x | 实盘 | 62.5% | | v5.7.1 | 实盘 273 轮 | **75.7%** (+13.2pp) | | v5.8 | 回测(前 2 根 1min) | 61.4% | | v5.8 | 回测(前 4 根 1min) | 69.5% | ⚠️ 见 [`references/backtest-findings.md`](references/backtest-findings.md):公平回测下纯价格因子无预测力。实盘高胜率很可能部分来自小样本 + K 线后段信息优势,并非稳定 edge。**在 edge 来源明确前,不应按高胜率预期下注。** ## 配置说明 当前引擎**不读取任何环境变量**——所有参数(symbol、interval、HTTP timeout、ATR 乘数、因子权重)均硬编码在 `.py` 源码中,这保证了 cron 调用的零配置可复现性。 `.env.example` 列出了**建议配置化**的项(当前为预留/文档用途),供希望二次开发的用户参考。如需让引擎实际读取这些变量,需要修改对应源码(欢迎 PR)。 主要硬编码常量位置: | 常量 | 默认值 | 位置 | |------|--------|------| | `symbol` | `BTCUSDT` | `fetch_klines()` / `fetch_depth()` 形参 | | `interval` | `5m` | `fetch_klines()` 形参 | | HTTP timeout | `5`–`10` s | `urlopen()` 调用 | | ATR 乘数 | `0.55` | `predict_close_v5()` | | `BASE_W` | 因子权重表 | 模块级常量 | | `REGIME_ADJ` | Regime 权重调整 | 模块级常量 | ## 已知局限 1. **回测与实盘的差距**:公平回测下因子无预测力,实盘 edge 主要来自 K 线后段信息优势(可能不稳定的"半前视")。 2. **订单簿简化**:仅用 top-20 深度,未实现完整的 OFI(Cont et al. 2014)与 microprice 模型。 3. **新闻延迟**:CoinDesk RSS 约 14 分钟延迟,无法捕捉瞬时冲击。 4. **SSL 验证禁用**:引擎全局设置 `ssl._create_unverified_context`,是为对抗高延迟网络下的 SSL 握手超时(见 `references/high-latency-network-handling.md`)。在可信网络环境下可安全恢复验证。 5. **无自动交易**:本项目只输出预测,不执行任何下单。 ## 路线图 - ✅ **OFI 微结构因子**(v6.0 已落地):引擎现由真 OFI 净流一票决定方向 + `P(close>open|ofi)` 概率, 见 [SKILL.md 架构](SKILL.md#架构-1-行组件) 与 [strategy-adversarial-review.md](references/strategy-adversarial-review.md) - 🟡 HMM Regime 检测 + 自适应仓位 - 🟡 LightGBM 自动化因子筛选 - 🟡 CVaR 动态止损 - 🟢 TFT 多时间尺度模型替代贝叶斯引擎 > 原 `references/architecture.md`(13 因子模型 + 升级路线图)已于 2026-09-10 删除: > 其"13 正交因子"描述被 v5.9 清零、OFI 也已从路线图变为已实现,内容已由 > [changelog.md](references/changelog.md) 与 [SKILL.md](SKILL.md) 取代。 - 🟢 Deribit 期权 IV 信号 ## 免责声明 (NOT FINANCIAL ADVICE) 本项目是**量化研究与教育项目**,不构成投资建议、交易信号或任何形式的财务建议。 - 加密货币市场波动剧烈,交易可能导致**全部本金损失**。 - 引擎预测存在显著误差,历史准确率不代表未来表现。 - 作者与贡献者对任何基于本项目的交易决策**不承担责任**。 - 请在了解当地法律法规的前提下自行承担风险。 如本项目对你有帮助,欢迎 Star。但**请勿**将其视为稳赚的交易工具。 ## License 本项目暂未指定开源许可证。如需使用、修改或分发代码,请先联系作者或等待 License 文件添加。在未指定 License 前,根据默认版权法,代码保留全部权利(仅供阅读与学习)。 -
SKILL.md 16.9 KB
--- name: 5minbtc version: 6.0.0 description: "BTC 5分钟K线实时方向预测 + 币安预测市场错价套利(paper)。v6.0 真OFI驱动: 方向由当前K线原生 in-candle OFI 净流一票决定(ofi_n=2*(tb/v)-1, REST klines[9] 聚合, 零WS依赖; WS ofi.json 做新鲜度反转保护与交叉校准), 概率=P(close>open|ofi) 经验校准表+Bayesian shrink, edge=EV=p−ask 错价检测, 方向二选一无中性。13因子自v5.9起收敛到3个有证据信号且不再决定bias。黑天鹅防护: ATR spike+FNG<25。launchd 常驻 realtime/watch/trader。⚠️ Binance 端点**人工**双向切换(引擎为单端点硬依赖,无自动故障切换;2026-09-11 曾因 data-api SSL 失败静默断档 6h)。" triggers: - 5minbtc - 5min btc - btc 5min tools: - terminal - web --- # 5minbtc — BTC 5分钟实时预测 v6.0.0 > BTC 单根 5min K线 方向 + 收盘价预测。引擎+LLM 混合架构。 > **SKILL.md 是索引, 详细内容见 `references/`。** > **v5.9 认知转变**: 从"13因子预测器"→"3信号错价检测器" — 方向准确率不是 edge, `EV = p − P − 成本` 才是 (见 [对抗式审查报告](references/strategy-adversarial-review.md)) > **v6.0 执行转变**: 方向从"body 延续统计"改成**真 OFI 净流一票决定** — 赌的是"净流已发生、token 价还没定价"的 flow-gap > ⚠️ **同名易混**: 本 skill 只做 BTC 单标的 5min 方向 + 预测市场 EV。要做全市场永续的量价突破扫描, 用 [`coin-vp-scanner`](../coin-vp-scanner/SKILL.md) — 两者区别见下方 [与 coin-vp-scanner 的分工](#与-coin-vp-scanner-的分工)。 ## 触发 `5minbtc` / `5min btc` / `btc 5min` / `监控` (配合持续盯盘) ## 何时使用 | 场景 | 做法 | |------|------| | 当前 5min K线 方向+价位 | ✅ 标准流程, **方向=OFI 净流, edge=错价 EV** (v5.8 零前视回测 61.4% 是延续性不是 alpha, 见性能快照) | | 会话内持续盯盘, 等明确信号 | ✅ 监控模式 (scripts/5minbtc-monitor.py + Monitor 工具) | | 币安预测市场 Up/Down 5m 交易 | ✅ paper 模拟/实时监控 (见 [预测市场策略](references/prediction-market-strategy.md)) | | "今晚 BTC 涨跌" (宽窗口) | ⚠️ 跑当前 K线 + 给方向倾向, 标注"超出引擎置信区间" | | "下根 K线" / "1小时后" | 引导在该 K线 起始时间再触发 | ## 监控模式 (Claude Code) > 详见 [monitoring-claude-code.md](references/monitoring-claude-code.md) ```bash # 无限持续, 直到用户喊停 (会话内盯盘推荐) 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 scripts/test_engine.py` (13 项, 自带 runner **无需 pytest**; 慢测加 `--slow`) — 装了 pytest 也可 `python3 -m pytest scripts/test_engine.py -v` (原文件名 `test_engine_v58.py` 带版本号, 引擎升到 v6.0 后即漂移, 2026-09-10 改为不带版本号) ## 快速开始 ```bash SKILL_DIR=$HOME/.hermes/profiles/cqo/skills/5minbtc # 1. 并行: 引擎 + 新闻 + settle (前一根) python3 $SKILL_DIR/5minbtc-log.py settle-all 2>&1 python3 $SKILL_DIR/5minbtc-engine-v6.0.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-v6.0.py` (v6.0, 输出 `"version": "6.0.0"`): **bias 由真 OFI 净流一票决定** (ofi_n>0→bull / <0→bear, **二选一无中性**; ofi_n 缺失/为0 用 body 符号兜底并标 `meta.body_fallback`) + **概率 `P(close>open|ofi)`** 三层(经验校准表 Bayesian shrink + flow-gap + 最近60s流) + 三层独立过滤(多周期4h/1h/15m 结构 + 跨资产ETH/SOL 广度 + WS OFI 新鲜度反转保护) + 9路并行HTTP - ⚠️ **K 线开局阶段概率不可信**(已知问题,见 [pitfalls](references/pitfalls.md)):主源 `ofi_n = 2*(tb/v)−1` 取自**当前进行中**的 K 线,`_ofi_native()` 只挡 `v<=0`、**无最小样本量保护** → 开局几秒的少量成交就能把 ofi_n 推到 ±0.9。而 `vol_gate`(L692 按 `MIN_VOL_FRAC=0.25` 判断流量是否够)**算出来但从不参与任何决策**,只是输出里的装饰字段。**建议只在进度 ≥40% 后采信概率/下单** - 门限: `T_OFI_GATE=0.20` / `T_OFI_60=0.35` / WS 质量闸 `OFI_CR_MIN=0.80` / `OFI_BAYES_N=30` - **13 因子仍计算并输出**(JSON 契约保留), 但自 v6.0 起**不参与 bias 决策** — score 只用于 `strength` 标签与 LLM 参考 - **订单流** `scripts/ofi_feed.py`: trade+bookTicker 组合流 tick规则推断主动买卖, 写 `~/bb-auto/ofi.json`, 带 ts 保鲜(>30s 引擎降级为只信 REST 主源) (launchd: com.daniel.ofi-feed) - **日志** `5minbtc-log.py`: jsonl 追加 + 增量 settle (写入 logs/) - **新闻** `5minbtc-news.py`: CoinDesk RSS (唯一稳定源, ~14min 延迟) - **常驻进程** (launchd): `5minbtc_realtime.py` (5s 刷新, 预测快照+EV下单) / `5minbtc_watch.py` / `5minbtc_trader.py --paper-monitor` - **LLM**: 因子打分基准 + LLM 综合裁决 + 模板输出 ## 铁律 1. 每次必须重新执行引擎脚本 — 不缓存 2. 每次必须重新搜索3组新闻 3. 先 settle 上一根, 再 log 新预测 4. LLM 可微调引擎的 `pred_close`/range, 但必须说明理由 ⚠️ **bias 不要轻易覆盖** (v6.0): 方向是 OFI 一票决定的, LLM 用因子/新闻翻方向 = 退回被证伪的路径。 仅在 `meta.body_fallback=True` 或 OFI 数据缺失时才允许改 bias, 并显式写明原因。 5. 输出 15-25 行 (平衡深度和 Telegram 可读性) ## 关键裁决规则 (⚠️ 历史规则: v5.7.x 因子打分路径) > **v6.0 起 bias 由真 OFI 一票决定, 下列规则不再决定方向。** 仅在两条兜底路径上仍有参考价值: > ① `meta.body_fallback=True` (ofi_n 缺失/为0, 方向退回 body 符号) ② LLM 复核时解释 `meta` 冲突字段。 > 引擎的 `raw score` 仍输出, 但只影响 `strength` 标签, 不影响 bias。 - **half_body vs imbalance 冲突** (v5.7.2): |half_body|>0.25 + |imbalance|>0.5 + progress≥45% → 优先 half_body <sub>(注: 两者自 v5.9 起权重已清零)</sub> - **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-09-10 更新) > 数字口径以 [对抗式审查报告](references/strategy-adversarial-review.md) 为准 — 旧数字多数含前视偏差。 - **v5.7 回测 71.2% 含前视偏差**(文件里自己标注"已知"); 零前视 v5.8: 前2根1min=**61.4%**, 前4根=69.5% - 但 61–70% 是"看着 K 线走完再确认"的延续性, **不是 alpha** — 做市商已把它定价进 token 价 - 去掉水分后的真实基准: non-neutral 方向 **57.7%** | bull **63.9%** (唯一显著) | **bear 50.0% = 纯硬币** - paper 交易: 全样本 UP 成交 **44%** (+$0.24) | 甜区 UP ask 0.40–0.50 → **60%** (+$1.39) ← 唯一正 EV 区间 - **结论: edge 不在方向准不准, 在 `EV = p − P − 成本 > 0`。v6.0 的错价检测(flow-gap)就是直接做这件事。** - 当前 LLM: `zai/glm-5.2` (8-15s/次) | opencaio 实测 MiniMax-M3 ~2.7s 可作更快选项 ## 📚 引用索引 (references/) ### 核心方法论 - [strategy-adversarial-review.md](references/strategy-adversarial-review.md) — **对抗式审查报告: 第一性原理 + 13因子证伪 + 该留/删/缺失 + P0/P1/P2行动清单** (v5.9 依据) - [lessons.md](references/lessons.md) — **25 条核心教训** (必读, 含 2026-07-05 新增 23-25) - [pitfalls.md](references/pitfalls.md) — **20 条 pitfalls 集中索引** (必读, 含并行 max() 评估陷阱; #18 = K线开局概率不可信; #19 = "真OFI" 只覆盖单一市场; #20 = 端点故障致静默断档) - [changelog.md](references/changelog.md) — v5.0 ~ v6.0 详细变更 - [skill-organization.md](references/skill-organization.md) — **Skill 文件结构模式 (可复用)** — SKILL.md INDEX + references/ 分专题 ### 执行与输出 - [execution.md](references/execution.md) — 完整执行步骤 + 铁律 + 宽窗口处理 - [output-template.md](references/output-template.md) — LLM 输出模板 + 裁决规则 - [monitoring-claude-code.md](references/monitoring-claude-code.md) — **监控模式: Monitor 工具集成 + 事件协议** - [telegram-push-monitor.md](references/telegram-push-monitor.md) — **Telegram 推送 daemon: watch 采样节奏/事件类型/记录与结算/launchd 持久化** - [prediction-trading-cli.md](references/prediction-trading-cli.md) — **币安预测交易 CLI: 5minbtc_trader.py 用法/参数/安全契约/API端点 (含 --paper/--paper-monitor 模拟)** - [prediction-market-strategy.md](references/prediction-market-strategy.md) — **预测市场盈利策略: EV=p−P, 价格门控, 凯利仓位, paper 模拟** ### 数据源 & 网络 - [news-sources.md](references/news-sources.md) — 新闻源评估 (清理后只剩 CoinDesk) - [binance-api-geo.md](references/binance-api-geo.md) — Binance 端点区域问题 - [binance-endpoint-flapping.md](references/binance-endpoint-flapping.md) — 端点双向故障切换 - [high-latency-network-handling.md](references/high-latency-network-handling.md) — 高延迟网络处理 (SSL 超时) > Binance 三种故障模式各一份(431/451 区域、隧道抖动、高延迟 SSL 超时),**不是重复文档**,见 [setup-from-scratch.md §6](references/setup-from-scratch.md#6-网络地区修复geo)。 ### 引擎专项 - [cron-llm-provider-failure.md](references/cron-llm-provider-failure.md) — Cron LLM Provider 失效诊断 (含 job 列表 §8) + 版本同步规则 ### 回测 & 复盘 - [backtest-findings.md](references/backtest-findings.md) — 365 天回测深度复盘 + 因子无预测力 - [backtest-v58-1min-findings.md](references/backtest-v58-1min-findings.md) — v5.8 真实 1min 半 K线回测 - [review-procedure.md](references/review-procedure.md) — 每日复盘流程 + 数据质量检查 ### 数据采集 & 仓库 - [sync-procedure.md](references/sync-procedure.md) — AGI-Super-Team 同步流程 (路径映射 + `-c` 校验 + logs 归档策略) - [archive.md](references/archive.md) — **版本归档: v5.0→v6.0 沿革 + 哪些版本已不可取回 + 归档 SOP** - [setup-from-scratch.md](references/setup-from-scratch.md) — **从零搭建: 依赖/目录/密钥/6 个 launchd 服务/验证清单/日志轮转/故障表** - [scheduled-tasks.md](references/scheduled-tasks.md) — **系统级定时任务教程: 常驻型vs定时型 / 2 个任务 / launchd+cc-connect+hermes 三路线 / plist 模板 / 13 条坑** - [quant-knowledge-index.md](references/quant-knowledge-index.md) — 50 轮蒸馏知识库索引 ## 复盘记录 ⚠️ **`reviews/` 目录本地不存在** —— 早期文件树声称有 23 份按月归档的复盘记录(2026-05/06/07),实际从未落盘。 复盘结论目前散落在 [lessons.md](references/lessons.md)、[pitfalls.md](references/pitfalls.md)、 [strategy-adversarial-review.md](references/strategy-adversarial-review.md) 与 `reports/` 里。 若要恢复这个习惯,需先补 `review-procedure.md` 的落盘步骤,别只在文档里声明。 ## 报告库 14 份深度蒸馏报告在 `reports/` 目录 (也同步在 AGI-Super-Team): R01-R14。 ## 与 coin-vp-scanner 的分工 两个都是交易类 skill, **但赌的不是同一件事, 不要混用**: | | **5minbtc** (本 skill) | [coin-vp-scanner](../coin-vp-scanner/SKILL.md) | |---|---|---| | 标的 | **单标的 BTC** | 全量币安 USDT 永续 | | 周期 | 单根 5min K线 | 1–30min 短线 | | 核心逻辑 | **真 OFI 净流 + 错价检测** (净流已发生、token 价未定价 → flow-gap) | **确定性结构突破** (放量 + 强实体 + 收盘破 1h 结构位 + 趋势同向, 四条全 ✓) | | 决策依据 | 概率 `P(close>open\|ofi)` vs 市场 token 价 → `EV = p − P` | 结构规则布尔判定, 非概率 | | 输出 | 方向 bull/bear + 概率 + edge | 杠杆 / TP / SL 交易卡 | | 落地方式 | 预测市场 Up/Down token, **仅 paper** (`LIVE_GATE` 硬闸门) | 直接做合约短线 | | 代码位置 | 本目录自包含 (引擎+脚本+launchd) | 代码在 `~/projects/coin-vp-scanner/`, 本 skill 只是索引 | **一句话选型**: 要赌"市场定价错了" → 5minbtc; 要抓"价格放量破位了" → coin-vp-scanner。 ## 仓库同步 详见 [sync-procedure.md](references/sync-procedure.md)。简述: ```bash rsync -av --exclude='data/' --exclude='__pycache__/' \ --exclude='*.jsonl' --exclude='*.jsonl.*' --exclude='*.gz' \ $HOME/.hermes/profiles/cqo/skills/5minbtc/ \ $HOME/clawd/repos/AGI-Super-Team/skills/5minbtc/ cd $HOME/clawd/repos/AGI-Super-Team git add skills/5minbtc/ && git commit -m "sync(skills/5minbtc): <版本>" && git push origin main ``` ## 回测系统 ``` 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-v6.0.py # 主引擎 (v6.0 真OFI 一票定方向, launchd 调用) ├── 5minbtc-news.py # 新闻扫描 (CoinDesk RSS, 唯一稳定源) ├── 5minbtc-log.py # 日志记录 (写入 logs/) ├── logs/ # 日志 (当月 live + 历史按月压缩) │ ├── 5minbtc-log.jsonl # 当月 live (不入库) │ └── archive/*.jsonl.gz # 月度压缩归档 (入库, 见 archive.md) ├── references/ # 24 份专项 ref (含 skill-organization 模式) ├── backtest/ # 回测系统 (results/ 不入库) ├── 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, launchd com.daniel.ofi-feed) │ ├── 5minbtc_keyless_paper.py # 免密钥模拟盘 (公开BTC数据模拟UP/DOWN价) │ ├── telegram_push.py # 通用 Telegram 推送助手 │ ├── daily-review-stats.py │ └── fetch-github-repo.sh ``` > ⚠️ **`archive/` 目录与 `reviews/` 目录本地并不存在** —— 本文件早期版本的文件树里声称有它们(还列了 23 份复盘),属于文档/现实漂移,已更正为上面的实际结构: > - 旧版本引擎源码**不保留在本地**,只留文字归档 → [references/archive.md](references/archive.md) > - 每日复盘从未落盘到 `reviews/`,复盘结论散在 `references/lessons.md` / `pitfalls.md` 与 `reports/` --- 最后更新: 2026-09-10 — 引擎 v5.7→**v6.0** 改名 (文件/SKILL/引用全线对齐, 修引擎内"无中性"过期注释) + SKILL.md 版本刷到 6.0.0 + 性能快照改为审查后的诚实口径 + 补 v5.9/v5.10/v6.0 changelog + 新增与 coin-vp-scanner 的分工说明 + **修文件树未闭合的代码块与 `archive/`/`reviews/` 假目录声明** + 新增 [archive.md](references/archive.md) 与 [setup-from-scratch.md](references/setup-from-scratch.md) + logs 月度压缩归档入库
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.