Crypto Bot Manager

Overview

OKX 全自动加密货币永续合约交易机器人。

核心流程： 全市场 Top-20 合约扫描 → 信号评分 → 7重过滤 → 风控检查 → 自动下单 → 追踪止损

运行模式

| 命令 | 作用 |

|------|------|

| python bot.py | 启动全自动交易机器人（扫描+风控+下单） |

| python bot.py --scan-only | 仅扫描信号，不下单 |

| python bot.py --status | 查看当前状态和持仓 |

| python bot.py --close-all | 平仓所有仓位 |

核心文件说明

| 文件 | 作用 |

|------|------|

| bot.py | 主入口，main loop |

| okx_client.py | OKX API 封装 |

| signal_scanner.py | 信号扫描引擎（趋势跟随+回调入场） |

| risk_manager.py | 风控引擎（日亏限制/回撤限制/连亏保护） |

| trade_executor.py | 订单执行器（入场+止损+止盈+追踪止损） |

| config.ini | 全部配置（API Key/参数/风控阈值） |

交易策略核心逻辑

入场信号生成（signal_scanner.py）：

• 1H/4H/1D 三周期趋势共振确认
• 仅顺大势方向交易（趋势跟随）
• 回调至支撑/阻力区精准入场
• 量价配合验证

7重过滤（trade_executor.py _check_confluence）：

1. 账户状态正常（未触发风控）
2. 24h回撤 < 15%
3. 日亏未超限
4. 未达最大持仓数
5. 同向持仓未达上限
6. 连亏保护未触发
7. 资金费率合理（做多 < 0.03%，做空 > -0.03%）

风控规则（risk_manager.py）：

• 每单 $15-50U，10x杠杆，固定止盈/止损
• 日亏限制：$40
• 最大敞口：$1000
• 最大持仓：6个
• 追踪止损：盈利1.5%激活，回撤0.8%触发
• 连亏3次强制冷却30分钟

配置说明（config.ini）

[okx]
api_key = your_api_key_here
secret_key = your_secret_key_here
passphrase = your_passphrase_here
demo = true                          # true=模拟盘, false=实盘
proxy = http://127.0.0.1:10808        # 代理地址

[strategy]
capital_per_trade = 15               # 每单本金 (U)
max_leverage = 10                     # 杠杆倍数
stop_loss_pct = 2.0                   # 止损 %
take_profit_pct = 6.0                 # 止盈 %
scan_interval_seconds = 300           # 扫描间隔 (秒)
kline_interval = 1H                   # K线周期
top_n_coins = 20                      # 扫描TopN合约
min_signal_strength = 2               # 最小信号强度

[risk]
daily_loss_limit = 40                 # 日亏限制 (U)
max_total_exposure = 1000             # 最大总敞口 (U)
max_positions = 6                     # 最大持仓数
max_drawdown_pct = 15.0               # 最大账户回撤 %
base_capital = 200                    # 账户基准本金
initial_equity = 89237.56            # 初始权益（首运行自动记录）

执行步骤

步骤1：配置 API Key

编辑 scripts/config.ini，填入你的 OKX API Key：

[okx]
api_key = 你的实盘API Key
secret_key = 你的实盘Secret
passphrase = 你的Passphrase
demo = false    # 改为 false 切换实盘

> ⚠️ API Key 必须有「永续合约交易」权限，建议先用模拟盘验证。

步骤2：切换运行模式

# 模拟盘全自动（推荐先用这个验证）
python scripts/bot.py

# 仅扫描信号（不交易）
python scripts/bot.py --scan-only

# 查看状态
python scripts/bot.py --status

# 平仓所有
python scripts/bot.py --close-all

步骤3：验证连接

python scripts/bot.py --status

输出账户权益和持仓明细即表示连接正常。

日志与状态

• 运行日志：scripts/logs/bot.log
• 机器人状态：scripts/crypto_bot_state.json

注意事项

1. 模拟盘优先 — 首次使用务必 demo = true，确认一切正常后再切实盘
2. 资金安全 — 实盘前为 API Key 设置只读权限或限制交易额度
3. 网络稳定 — 建议配合代理使用，避免 IP 被限
4. 风控为王 — config.ini 中风控参数已经过回测，非必要勿随意调整

触发词

• "启动交易机器人"、"开启自动交易"
• "关闭所有仓位"、"平仓"
• "查看机器人状态"、"机器人情况"
• "执行一次扫描"、"扫描信号"
• "交易机器人"、"自动交易"