Repository navigation
⚡ OKX AlphaPilot v1.3.0 - 5秒级盘中阶梯止盈、双重保本与追踪止损、OKX错误智能诊断
🎯 核心新特性与增强
-
5 秒级盘中独立阶梯主动止盈 (Realtime Ladder Take Profit):
- 长短周期解耦:将阶梯主动止盈彻底解耦于 1H/4H 等长周期信号计算。在持仓生命周期内,启动独立的 5 秒高频行情监听协程;
- 毫秒级主动锁盈:标的价格浮盈冲高达到第一档(+2.5%)或第二档(+4.5%)阈值时,无需等待整点 K 线收盘,5 秒内立即向交易所发起市价减仓报单;
- 单向棘轮锁定:第一档主动减仓至 65%,第二档主动减仓至 30%,严格锁死持仓上限,杜绝大幅浮盈后遭盘中剧烈反弹回撤侵蚀。
-
阶梯保本止损与高水位动态追踪止损双重保护 (Breakeven SL & High-Water Trailing Stop):
- 保本止损联动 (Breakeven SL):触发第一档止盈(锁定 35% 利润)后,剩余 65% 底仓的止损位自动上抬至
开仓均价 + 0.15% 交易成本安全垫。若行情随后剧烈崩盘,系统在 5 秒内市价平仓,彻底消灭“由大赢变大输”,确保整笔交易在数学期望上保本退出; - 高水位动态追踪止损 (High-Water Trailing Stop):触发第二档止盈(累计锁定 70% 利润,保留 30% 趋势底仓)后,系统自动激活高水位动态追踪,持续记录开仓后的峰值最高价。当价格从峰值回撤达到 2.5% 时,5 秒内市价清空剩余 30% 仓位,彻底锁死超级大趋势大单边行情的波段暴利。
- 保本止损联动 (Breakeven SL):触发第一档止盈(锁定 35% 利润)后,剩余 65% 底仓的止损位自动上抬至
-
OKX 响应智能诊断与错误翻译 (OKX Error Diagnostics & Parse Response):
- 错误深度透传:解决原
requests.raise_for_status()吞没底层 HTTP 400/401 响应体的问题,即使 OKX 接口返回 HTTP 错误,也能优先解析 JSON 中的业务错误码; - 中文智能排查指南:自动将
50123(API Key 无对应币种交易权限)、50113(系统时间戳不同步/NTP偏差)、50111(IP 不在白名单)、50102(API 凭证或密码不正确)、51000(可用保证金不足)等常见错误转换为通俗易懂的中文解决方案。
- 错误深度透传:解决原
-
自动交易异常自愈机制与前端交互提升:
- 15秒快速自愈:后台自动执行遇到网络或权限异常时,重试间隔自动切换为 15 秒(而非原先的 3600 秒长周期),用户在交易所后台调整配置后 15 秒内即可无感恢复;
- 前端状态诊断徽标:修复前端状态渲染异常,当自动执行出错时,信号面板展示醒目的红色「异常」徽章,并提供点击弹窗查看完整诊断建议;
- 审计日志完善:新增
auto_trade_error、breakeven_stop_loss_trigger等风控事件的全程审计跟踪。
-
全套自动化测试覆盖:
- 新增 OKX 错误解析与响应诊断单元测试;
- 39 项全套测试用例全部通过(39/39 PASSED)。
📦 桌面端配置说明(开箱即用)
- 解压与配置:
- 解压
AlphaPilot-v1.3.0-windows-x64.zip; - 在
AlphaPilot.exe同级目录下找到.env.example,复制或重命名为.env;
- 解压
- 填写 API 凭据:
- 用文本编辑器打开
.env,填入您的 OKX 实盘凭证(OKX_API_KEY、OKX_API_SECRET、OKX_API_PASSPHRASE)及风控参数:TRADING_MODE=live OKX_API_KEY=你的API_KEY OKX_API_SECRET=你的API_SECRET OKX_API_PASSPHRASE=你的API_PASSPHRASE OKX_API_BASE=https://www.okx.com OKX_SIMULATED=0 MAX_POSITION_PCT=0.80 DEFAULT_LEVERAGE=5 ENABLE_LADDER_TP=1 ENABLE_BREAKEVEN_SL=1 ENABLE_TRAILING_SL=1
- 用文本编辑器打开
- 双击启动:
- 双击运行
AlphaPilot.exe,原生桌面窗口自动加载。
- 双击运行