OKX 山寨引擎（独立项目）

本项目是一个独立于原固定币种系统的山寨机会执行引擎，设计目标是：

• 人工判断结构（关键位、失效位、BTC环境）；
• 程序负责机械执行（开仓、止损监控、熔断、日志、通知）；
• 支持局域网前端录入与查看，不依赖外网控制台；
• 默认 DRY_RUN=true，先模拟再实盘。

1. 目录结构

okx_alt_engine/
├─ backend/
│  ├─ app.py
│  ├─ config.py
│  ├─ db.py
│  ├─ engine.py
│  ├─ logger.py
│  ├─ notifier.py
│  ├─ okx_client.py
│  ├─ run_backend.py
│  ├─ utils.py
│  └─ requirements.txt
├─ frontend/
│  ├─ index.html
│  ├─ app.js
│  └─ styles.css
├─ scripts/
│  └─ backup_db.sh
├─ ecosystem.config.js
├─ .env.example
└─ 部署教程_Ubuntu_PM2_局域网.md

2. 核心功能

• 机会录入（symbol/zone_top/invalid_price/entry_mode/risk_pct/btc_gate）
• 引擎启停
• BTC 门控（全局 on/off）

• 风控限制：

  • 最大并发持仓数
  • 连续亏损熔断
  • 日内回撤熔断
• 自动止损监控（价格触达 invalid_price 自动平仓）
• OKX 合约下单单位自动换算（基于 lotSz/minSz/ctVal/ctValCcy）
• 交易日志 / 审计日志
• 企业微信消息推送
• CSV 复盘导出

3. 运行前准备

1. 复制环境变量模板：

cp .env.example .env

2. 编辑 .env（至少填写）：

• AGENT_SHARED_TOKEN
• OKX_API_KEY
• OKX_API_SECRET
• OKX_PASSPHRASE
• OKX_FLAG（0 实盘 / 1 模拟）
• WECHAT_WEBHOOK（可选）

3. 先保持：

• DRY_RUN=true（强烈建议）

4. 本地开发启动（不走 PM2）

后端

cd backend
python -m venv ../.venv
../.venv/bin/pip install -r requirements.txt
../.venv/bin/python run_backend.py

Windows 下对应：

cd backend
python -m venv ..\.venv
..\.venv\Scripts\pip.exe install -r requirements.txt
..\.venv\Scripts\python.exe run_backend.py

注意：如果 PowerShell 提示执行策略限制，请先运行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。

前端

python3 -m http.server 5174 --directory frontend

打开浏览器：http://<你的IP>:5174

5. 前端使用流程

1. 填写 API 地址（默认 http://127.0.0.1:8091）和 Token；
2. 点击“保存配置”；
3. 点击“启动引擎”；
4. 填写机会并提交；
5. 观察状态面板、持仓表和日志面板。

6. API 简表

• GET /health
• GET /status
• POST /engine/start
• POST /engine/stop
• POST /risk/btc-gate
• GET /setups
• POST /setups
• PUT /setups/{id}
• DELETE /setups/{id}
• POST /setups/{id}/activate
• POST /setups/{id}/cancel
• GET /positions
• POST /position/close
• GET /trades
• GET /journal
• GET /export/trades

除 GET /health 外，默认都需要 X-Agent-Token。

7. 重要风险提示

• 本项目不能替代你对市场结构的判断；
• preload 属于提前布局，失败次数可能高于 breakout；
• 代理异常、交易所延迟、网络抖动都可能影响执行；
• 强烈建议：先 DRY_RUN=true 连续观察，再小仓实盘。

8. 后续建议

• 增加“单币当日重开限制”；
• 增加“按 setup 分组统计胜率与R值”；
• 增加“更严格的 BTC 多空状态机”。

9.部署教程

okx山寨引擎部署部署教程