Multi-Exchange Strategy Automation System
这是一个企业级的多交易所加密货币自动化交易系统，以高级套利系统为核心，提供高性能、高可靠性的分段套利、网格交易、刷量交易和市场监控功能。系统采用严格的分层架构设计，支持 Hyperliquid、Backpack、Lighter、Paradex、Binance、OKX、EdgeX、GRVT、Variational 等多个主流交易所的完整适配。
本系统的套利引擎是其最核心、最先进的功能模块，具备以下独特优势：
- 网格套利模式（分段系统）：采用分段网格策略，价差扩大时逐步开仓、收敛时逐步平仓，降低市场冲击和滑点损耗。支持剥头皮变体（触发格子后锁定持仓等待止盈）和拆单变体（单格子多笔累积）
- 基于历史数据的决策模式：通过历史价差记录器持续记录各交易所对的价差和资金费率数据，由历史数据计算器计算"天然价差"（历史中位数）和"天然资金费率差"，决策引擎基于历史平均值和用户设定的阈值参数，自动判断两个方向的套利机会：价差套利（当前价差超过历史基准+用户阈值时触发）和资金费率套利（资金费率差持续满足条件时触发）
- 总量驱动算法：
target - actual = delta，精准控制持仓 - 多交易对独立配置：每个交易对独立风控、独立决策
- 多腿套利支持：支持复杂的多腿对冲策略
- 多交易所套利：跨交易所价差捕捉，最大化收益
- WebSocket 批量下单：
place_market_orders_ws_batch，极速执行 - 智能补单策略：单腿成交检测 + 3次重试（REST市价 → REST市价 → 激进限价IOC）
- 订单推送去重：基于 deque+set 同步缓存，精准状态追踪
- 动态滑点保护：支持 1x~100x 动态滑点，适应极端行情
- 价格稳定性检测：过滤虚假突破，避免追涨杀跌
- 对手盘流动性校验：确保订单能够完全成交
- Reduce-Only 智能管理：自动探测恢复，避免平仓失败
- 错误避让控制器：交易所异常时自动暂停/恢复
- 🏆 高级套利系统：分段套利、多腿套利、跨交易所套利，统一决策引擎，智能补单机制
- 📊 网格交易系统：普通/马丁/移动网格，剥头皮、本金保护、止盈止损
- 💹 刷量交易系统：挂单模式（Backpack）、市价模式（Lighter）
- 🔔 价格提醒系统：多交易所价格突破监控，声音提醒
- 🔗 多交易所适配：9大交易所完整适配（Hyperliquid、Backpack、Lighter、Paradex、Binance、OKX、EdgeX、GRVT、Variational）
- 🛡️ 智能风控：多层风控体系，流动性校验，错误避让，reduce-only 管理
- 🎨 实时监控 UI：Rich 库实现的现代化终端界面
- 🏗️ 企业级架构：分层设计、依赖注入、接口分离、高可扩展性
多交易所策略自动化系统
├── 📊 网格交易系统 (Grid Trading)
│ ├── 普通网格 # 固定价格区间网格
│ ├── 马丁网格 # 马丁格尔递增策略
│ ├── 价格移动网格 # 动态跟随价格
│ ├── 剥头皮模式 # 快速止损策略
│ ├── 智能剥头皮 # 多次深跌检测
│ ├── 本金保护模式 # 自动止损保护
│ ├── 止盈模式 # 到达目标自动平仓
│ └── 现货预留管理 # 现货币种预留
├── 🔍 网格波动率扫描器 (Grid Volatility Scanner)
│ ├── 虚拟网格模拟 # 无需实际下单的模拟网格
│ ├── 实时APR计算 # 准确预测年化收益率
│ ├── 代币排行榜 # 按波动率和APR排序
│ ├── 智能评级系统 # S/A/B/C/D等级评估
│ └── 终端 UI # Rich 实时监控界面
├── 💹 刷量交易系统 (Volume Maker)
│ ├── 挂单模式 # 限价单刷量（Backpack）
│ └── 市价模式 # 市价单快速刷量（Lighter）
├── 🔄 套利监控与执行系统 (Arbitrage Monitor & Execution)
│ ├── 基础模式套利 # 历史数据决策 + 自动执行
│ ├── 分段套利系统 # 高级分段执行策略（网格模式）
│ ├── 价格监控 # 实时价格差监控
│ ├── 资金费率监控 # 跨交易所费率差异
│ ├── 套利机会识别与执行 # 价差和费率套利自动执行
│ ├── 终端 UI # Rich 实时监控界面
│ └── 交易对自动发现 # 多交易所交易对匹配
├── 🔔 价格提醒系统 (Price Alert)
│ ├── 价格突破监控 # 价格触及目标提醒
│ ├── 多交易所支持 # 支持所有接入的交易所
│ ├── 终端 UI # 实时价格显示
│ └── 声音提醒 # 突破时声音通知
├── 🔗 交易所适配层 (Exchange Adapters)
│ ├── Hyperliquid 适配器 # 永续合约 + 现货
│ ├── Backpack 适配器 # 永续合约
│ ├── Lighter 适配器 # 永续合约 + 现货（WS批量下单、智能补单）
│ ├── Binance 适配器 # 现货 + 永续合约
│ ├── OKX 适配器 # 现货 + 永续合约
│ ├── EdgeX 适配器 # 永续合约
│ ├── Paradex 适配器 # 永续合约（Starknet）
│ ├── GRVT 适配器 # 永续合约（去中心化）
│ ├── Variational 适配器 # 永续合约（仅BBO行情）
│ └── 统一接口标准 # 标准化 API 接口
└── 🏛️ 基础设施层 (Infrastructure)
├── 依赖注入容器 # DI 容器管理
├── 事件系统 # 事件驱动架构
├── 日志系统 # 结构化日志
├── 配置管理 # YAML 配置系统
└── 数据聚合器 # 多交易所数据聚合
- Python 3.8+（推荐 Python 3.12）
- 支持的操作系统：Linux、macOS、Windows
- 可选：tmux（用于多进程管理）
# 方式1：主环境依赖（套利、永续合约网格、刷量）
pip install -r requirements.txt
# 方式2：Python 3.12 环境依赖
pip install -r requirements-py312.txt
# 方式3：Lighter 现货专用环境（自动安装）
./setup_lighter_spot_env.sh依赖说明：
requirements.txt- 标准依赖包requirements-py312.txt- Python 3.12 兼容依赖requirements-lighter-spot.txt- Lighter 现货专用依赖（新版 SDK）- 详细依赖冲突说明：docs/dependency_conflicts.md
在 config/exchanges/ 目录下配置对应交易所的 API 密钥：
config/exchanges/
├── hyperliquid_config.yaml # Hyperliquid 配置
├── backpack_config.yaml # Backpack 配置
├── lighter_config.yaml # Lighter 配置
├── binance_config.yaml # Binance 配置
├── okx_config.yaml # OKX 配置
├── edgex_config.yaml # EdgeX 配置
├── paradex_config.yaml # Paradex 配置
└── grvt_config.yaml # GRVT 配置# 激活主环境
source .venv-py312/bin/activate
# 启动网格交易
python3 run_grid_trading.py config/grid/lighter-long-perp-btc.yaml# 激活 Lighter 现货专用环境
source .venv-lighter-spot/bin/activate
# 或使用快捷脚本
source activate_lighter_spot.sh
# 启动现货网格交易
python3 run_grid_trading.py config/grid/lighter-long-spot-eth.yamlpython3 run_volume_maker.py config/volume_maker/backpack_btc_volume_maker.yamlpython3 run_lighter_volume_maker.py config/volume_maker/lighter_volume_maker.yaml# 基础模式套利（历史数据决策 + 自动执行）
python3 run_arbitrage_monitor.py
# 套利系统 V2（增强监控 + 执行）
python3 run_arbitrage_monitor_v2.py
# 分段套利系统（网格模式，推荐）
python3 main_unified.py \
--config config/arbitrage/arbitrage_segmented.yaml \
--monitor-config config/arbitrage/monitor_v2.yaml
# 单独监控模式（仅监控，不执行）
python3 main_unified.py \
--monitor-config config/arbitrage/monitor_lighter_gold.yaml
# ========== 快速参考命令 ==========
# 环境激活
source .venv-py312/bin/activate # Python 3.12 环境
source .venv-lighter-spot/bin/activate # Lighter 现货专用环境
# 套利系统启动示例
# Lighter 黄金监控配置
python main_unified.py \
--monitor-config config/arbitrage/monitor_lighter_gold.yaml
# Lighter 多交易对 BTC 监控
python main_unified.py \
--config config/arbitrage/arbitrage_segmented.yaml \
--monitor-config config/arbitrage/monitor_lighter_multi_btc.yaml
# ETH 现货套利
python main_unified.py \
--config config/arbitrage/arbitrage_segmented.yaml \
--monitor-config config/arbitrage/monitor_lighter_eth_spot.yaml
# 测试工具
python test/ws_rest_fill_probe.py --exchange backpack --mode limitpython3 run_price_alert.py config/price_alert/binance_alert.yamlpython3 grid_volatility_scanner/run_scanner.py- 多种网格模式：普通网格、马丁网格、价格移动网格
- 智能策略：剥头皮、智能剥头皮、本金保护、止盈模式
- 健康检查：自动订单校验和修复机制
- 终端 UI：实时监控界面，显示持仓、盈亏、网格状态
- 现货支持：现货预留管理（自动维持币种余额）、市场类型自动适配
- 多交易所：支持 Hyperliquid、Backpack、Lighter（含现货和永续）
config/grid/
├── lighter-long-perp-btc.yaml # Lighter BTC 永续做多
├── lighter-long-perp-eth.yaml # Lighter ETH 永续做多
├── lighter-long-spot-eth.yaml # Lighter ETH 现货做多（需新版环境）
├── lighter-long-spot-模版.yaml # Lighter 现货模板
├── hyperliquid_btc_perp_long.yaml # Hyperliquid BTC 做多
├── hyperliquid_btc_perp_short.yaml # Hyperliquid BTC 做空
├── hyperliquid_btc_spot_long.yaml # Hyperliquid 现货做多
├── backpack_capital_protection_long_btc.yaml # Backpack BTC 本金保护
├── backpack_capital_protection_long_eth.yaml # Backpack ETH 本金保护
├── backpack_capital_protection_long_sol.yaml # Backpack SOL 本金保护
├── backpack_capital_protection_long_bnb.yaml # Backpack BNB 本金保护
└── backpack_capital_protection_long_hype.yaml # Backpack HYPE 本金保护
# 方式1：永续合约网格（主环境）
source .venv-py312/bin/activate
python3 run_grid_trading.py config/grid/lighter-long-perp-btc.yaml
python3 run_grid_trading.py config/grid/lighter-long-perp-eth.yaml
# 方式2：现货网格（Lighter 专用环境）
source activate_lighter_spot.sh
python3 run_grid_trading.py config/grid/lighter-long-spot-eth.yaml
# 方式3：DEBUG 模式启动（查看详细日志）
python3 run_grid_trading.py config/grid/lighter-long-perp-btc.yaml --debug
# 方式4：使用 Shell 脚本批量启动（tmux）
./scripts/start_all_grids.sh| 文件路径 | 说明 |
|---|---|
run_grid_trading.py |
网格交易系统主启动脚本 |
core/services/grid/coordinator/grid_coordinator.py |
网格系统协调器（核心逻辑） |
core/services/grid/implementations/grid_engine_impl.py |
网格执行引擎 |
core/services/grid/implementations/grid_strategy_impl.py |
网格策略实现 |
core/services/grid/implementations/position_tracker_impl.py |
持仓跟踪器 |
core/services/grid/implementations/order_health_checker.py |
订单健康检查器 |
core/services/grid/scalping/scalping_manager.py |
剥头皮管理器 |
core/services/grid/scalping/smart_scalping_tracker.py |
智能剥头皮追踪器 |
core/services/grid/capital_protection/capital_protection_manager.py |
本金保护管理器 |
core/services/grid/terminal_ui.py |
终端 UI 界面 |
- 双交易模式：挂单模式（Backpack）、市价模式（Lighter）
- 信号源支持：Backpack REST API、Hyperliquid WebSocket
- 智能判断：买卖单数量对比、价格变动监控
- 实时统计：成交量、成交金额、手续费统计
- 终端 UI：实时显示交易状态和统计信息
config/volume_maker/
├── backpack_btc_volume_maker.yaml # Backpack 挂单模式
└── lighter_volume_maker.yaml # Lighter 市价模式（支持多信号源）
# Backpack 挂单模式刷量
python3 run_volume_maker.py config/volume_maker/backpack_btc_volume_maker.yaml
# 或使用快速启动脚本
./scripts/start_volume_maker.sh
# Lighter 市价模式刷量（支持 Backpack/Hyperliquid 信号源）
python3 run_lighter_volume_maker.py config/volume_maker/lighter_volume_maker.yaml
# 或使用快速启动脚本
./scripts/start_lighter_volume_maker.sh| 文件路径 | 说明 |
|---|---|
run_volume_maker.py |
挂单模式刷量启动脚本（Backpack） |
run_lighter_volume_maker.py |
市价模式刷量启动脚本（Lighter） |
core/services/volume_maker/implementations/volume_maker_service_impl.py |
挂单模式服务实现 |
core/services/volume_maker/implementations/lighter_market_volume_maker_service.py |
市价模式服务实现 |
core/services/volume_maker/terminal_ui.py |
刷量系统终端 UI |
core/services/volume_maker/hourly_statistics.py |
小时统计模块 |
- 双模式支持：基础模式和分段模式
- 基础模式：基于历史数据的决策引擎 + 自动套利执行
- 分段模式：高级分段网格执行策略，降低滑点和市场冲击
- 支持 SEG-GRID（分段网格）、SEG-SCALP（分段剥头皮）、SEG-GRID+（分段拆单）三种模式
- 统一决策引擎：总量驱动算法（target - actual = delta）
- 支持多交易对独立配置、多腿套利、多交易所套利
- 价格监控：实时监控多交易所价格差（EdgeX、Lighter、Paradex、GRVT）
- 资金费率监控：跨交易所资金费率差异追踪
- 套利机会识别：价差套利和费率套利机会
- Lighter 批量执行优化：
- WebSocket 批量市价单下单（
place_market_orders_ws_batch） - 单腿成交检测与智能补单策略（3次重试：REST市价 → REST市价 → 激进限价IOC）
- 订单推送去重机制（基于 deque+set 同步缓存）
- 动态滑点保护价格计算（支持多倍滑点，最高100倍）
- WebSocket 批量市价单下单（
- 风控系统：
- 价格稳定性检测、对手盘流动性校验
- reduce-only 状态管理与探测恢复
- 错误避让控制器（自动暂停/恢复异常交易所）
- 终端 UI：Rich 库实现的现代化实时监控界面
- 交易对自动发现：自动匹配多交易所支持的交易对
- 费率差持续时间追踪：记录高费率差持续时长
- 动态价格精度：根据价格大小自动调整显示精度
- 智能排序：按价差排序，定时刷新避免界面抖动
config/arbitrage/
├── monitor.yaml # 基础监控配置
├── monitor_v2.yaml # V2 监控配置
├── monitor_lighter_gold.yaml # Lighter 黄金监控
├── monitor_lighter_multi_btc.yaml # Lighter 多交易对监控
├── arbitrage_segmented.yaml # 分段套利配置
└── （其他监控配置）
# 方式1：基础套利监控
python3 run_arbitrage_monitor.py
# 方式2：套利监控 V2
python3 run_arbitrage_monitor_v2.py
# 方式3：统一套利系统（分段模式）
python3 main_unified.py \
--config config/arbitrage/arbitrage_segmented.yaml \
--monitor-config config/arbitrage/monitor_v2.yaml
# 方式4：单独监控配置
python3 main_unified.py \
--monitor-config config/arbitrage/monitor_lighter_gold.yaml
# 方式5：使用快速启动脚本
./scripts/start_arbitrage_monitor.sh| 文件路径 | 说明 |
|---|---|
run_arbitrage_monitor.py |
基础套利系统启动脚本（监控+执行） |
run_arbitrage_monitor_v2.py |
套利系统 V2 启动脚本（增强版） |
main_unified.py |
统一分段套利系统启动脚本（网格模式） |
core/services/arbitrage_monitor_v2/core/unified_orchestrator.py |
统一调度器（监控+决策+执行） |
core/services/arbitrage_monitor_v2/execution/arbitrage_executor.py |
套利执行器（订单执行核心） |
core/services/arbitrage_monitor_v2/execution/lighter_batch_executor.py |
Lighter 批量执行模块（WS批量+补单） |
core/services/arbitrage_monitor_v2/decision/unified_decision_engine.py |
统一决策引擎（总量驱动算法） |
core/services/arbitrage_monitor_v2/decision/arbitrage_decision.py |
基础模式决策引擎（历史数据分析） |
core/services/arbitrage_monitor_v2/history/history_calculator.py |
历史数据计算器（天然价差/资金费率差） |
core/services/arbitrage_monitor_v2/utils/risk_control_utils.py |
风控工具（流动性校验、价格稳定性） |
core/services/arbitrage_monitor/implementations/arbitrage_monitor_impl.py |
基础模式监控与执行服务实现 |
core/services/arbitrage_monitor/interfaces/arbitrage_monitor_service.py |
套利服务接口 |
core/services/arbitrage_monitor/models/arbitrage_models.py |
套利数据模型 |
core/services/arbitrage_monitor/utils/symbol_converter.py |
交易对转换器 |
- 价格突破监控：监控价格触及设定的上下限
- 多交易所支持：支持所有接入的交易所
- 终端 UI：实时显示当前价格和目标价格
- 声音提醒：价格突破时发出声音通知
- 自动退出：触发提醒后自动退出程序
config/price_alert/
└── binance_alert.yaml # 价格提醒配置
# 直接启动
python3 run_price_alert.py config/price_alert/binance_alert.yaml
# 使用快速启动脚本
./scripts/start_price_alert.sh| 文件路径 | 说明 |
|---|---|
run_price_alert.py |
价格提醒系统启动脚本 |
core/services/price_alert/implementations/price_alert_service_impl.py |
提醒服务实现 |
core/services/price_alert/interfaces/price_alert_service.py |
提醒服务接口 |
core/services/price_alert/models/alert_config.py |
提醒配置模型 |
core/services/price_alert/models/alert_statistics.py |
提醒统计模型 |
- 虚拟网格模拟：模拟网格交易，无需实际下单
- 实时APR计算：准确预测年化收益率
- 代币排行榜：按波动率和APR排序，展示Top代币
- 智能评级系统：S/A/B/C/D等级评估（S级≥500% APR）
- 终端 UI：Rich库实现的现代化实时监控界面
- 灵活配置：支持自定义网格宽度、间距、扫描时长
- 多交易所支持：支持Lighter、Hyperliquid等交易所
grid_volatility_scanner/config/
└── market_config.yaml # 市场配置（网格参数）
# 基础启动（扫描1小时）
python3 grid_volatility_scanner/run_scanner.py
# 自定义扫描时长（30分钟）
python3 grid_volatility_scanner/run_scanner.py --duration 1800
# 指定交易所（Hyperliquid）
python3 grid_volatility_scanner/run_scanner.py --exchange hyperliquid
# 使用自定义配置文件
python3 grid_volatility_scanner/run_scanner.py --config my_config.yaml| 文件路径 | 说明 |
|---|---|
grid_volatility_scanner/run_scanner.py |
扫描器启动脚本 |
grid_volatility_scanner/scanner.py |
主扫描器逻辑 |
grid_volatility_scanner/models/virtual_grid.py |
虚拟网格模型 |
grid_volatility_scanner/models/simulation_result.py |
模拟结果模型 |
grid_volatility_scanner/core/price_monitor.py |
价格监控器 |
grid_volatility_scanner/core/cycle_detector.py |
循环检测器 |
grid_volatility_scanner/core/apr_calculator.py |
APR计算器 |
grid_volatility_scanner/ui/scanner_ui.py |
Rich终端UI |
APR = (格子间距% - 手续费%) × 格子间距% / 网格宽度% × 每小时循环 × 8760
| 评级 | APR范围 | 说明 |
|---|---|---|
| 🔥 S | ≥ 500% | 极度推荐 |
| ⭐ A | ≥ 300% | 强烈推荐 |
| ✅ B | ≥ 150% | 推荐 |
| 🟡 C | ≥ 50% | 可考虑 |
| ❌ D | < 50% | 不推荐 |
| 交易所 | 现货 | 永续合约 | REST API | WebSocket | 状态 |
|---|---|---|---|---|---|
| Hyperliquid | ✅ | ✅ | ✅ | ✅ | ✅ 完整适配 |
| Backpack | ❌ | ✅ | ✅ | ✅ | ✅ 完整适配 |
| Lighter | ✅ | ✅ | ✅ | ✅ | ✅ 完整适配（现货需新版 SDK） |
| Binance | ✅ | ✅ | ✅ | ✅ | ✅ 完整适配 |
| OKX | ✅ | ✅ | ✅ | ✅ | ✅ 完整适配 |
| EdgeX | ❌ | ✅ | ✅ | ✅ | ✅ 完整适配 |
| Paradex | ❌ | ✅ | ✅ | ✅ | ✅ 完整适配（Starknet） |
| GRVT | ❌ | ✅ | ✅ | ✅ | ✅ 完整适配（去中心化） |
| Variational | ❌ | ✅ | ❌ | 🟡 仅BBO行情 |
注意：
- Lighter 现货交易需要使用独立的虚拟环境和新版 SDK，详见 Lighter 现货设置指南
- Variational 当前仅支持 BBO（最佳买卖价）行情获取，不支持完整交易功能
core/adapters/exchanges/adapters/
├── hyperliquid.py # Hyperliquid 统一接口
├── hyperliquid_base.py # 基础类
├── hyperliquid_rest.py # REST API
├── hyperliquid_websocket.py # WebSocket
├── backpack.py # Backpack 统一接口
├── backpack_base.py # 基础类
├── backpack_rest.py # REST API
├── backpack_websocket.py # WebSocket
├── lighter.py # Lighter 统一接口
├── lighter_base.py # 基础类
├── lighter_rest.py # REST API（支持WS批量下单、滑点保护）
├── lighter_websocket.py # WebSocket（支持订单推送去重、统一日志）
├── binance.py # Binance 统一接口
├── okx.py # OKX 统一接口
├── edgex.py # EdgeX 统一接口
├── paradex.py # Paradex 统一接口（Starknet）
├── grvt.py # GRVT 统一接口（去中心化）
└── variational.py # Variational 接口（仅BBO行情）
crypto-trading/
├── 🚀 启动脚本 (Root Scripts)
│ ├── run_grid_trading.py # 网格交易系统启动
│ ├── run_volume_maker.py # 挂单刷量系统启动（Backpack）
│ ├── run_lighter_volume_maker.py # 市价刷量系统启动（Lighter）
│ ├── run_arbitrage_monitor.py # 基础套利系统启动（监控+执行）
│ ├── run_arbitrage_monitor_v2.py # 套利系统 V2 启动（增强版）
│ ├── run_arbitrage_monitor_simple.py # 简化套利系统启动
│ ├── run_arbitrage_execution_v3.py # 套利执行系统 V3 启动（已废弃）
│ ├── main_unified.py # 统一分段套利系统启动（网格模式）
│ ├── run_price_alert.py # 价格提醒系统启动
│ └── grid_volatility_scanner/
│ └── run_scanner.py # 网格波动率扫描器启动
├── 🏛️ core/ - 核心业务层
│ ├── data_aggregator.py # 数据聚合器
│ ├── __init__.py
│ ├── adapters/ - 交易所适配层
│ │ └── exchanges/
│ │ ├── adapter.py # 适配器基类
│ │ ├── factory.py # 适配器工厂
│ │ ├── interface.py # 统一接口定义
│ │ ├── manager.py # 适配器管理器
│ │ ├── models.py # 数据模型
│ │ ├── subscription_manager.py # 订阅管理器
│ │ ├── websocket_manager.py # WebSocket 管理器
│ │ ├── adapters/ # 各交易所适配器实现
│ │ │ ├── hyperliquid*.py # Hyperliquid 适配器
│ │ │ ├── backpack*.py # Backpack 适配器
│ │ │ ├── lighter*.py # Lighter 适配器（WS批量、补单）
│ │ │ ├── binance*.py # Binance 适配器
│ │ │ ├── okx*.py # OKX 适配器
│ │ │ ├── edgex*.py # EdgeX 适配器
│ │ │ ├── paradex*.py # Paradex 适配器（Starknet）
│ │ │ ├── grvt*.py # GRVT 适配器（去中心化）
│ │ │ └── variational*.py # Variational 适配器（仅BBO）
│ │ └── utils/ # 工具类
│ │ ├── log_formatter.py # 日志格式化
│ │ └── setup_logging.py # 日志设置
│ ├── services/ - 业务服务层
│ │ ├── grid/ - 网格交易服务
│ │ │ ├── coordinator/ # 协调器模块
│ │ │ │ ├── grid_coordinator.py # 网格协调器（核心）
│ │ │ │ ├── balance_monitor.py # 余额监控
│ │ │ │ ├── position_monitor.py # 持仓监控
│ │ │ │ ├── order_operations.py # 订单操作
│ │ │ │ ├── scalping_operations.py # 剥头皮操作
│ │ │ │ ├── grid_reset_manager.py # 网格重置管理
│ │ │ │ └── verification_utils.py # 验证工具
│ │ │ ├── implementations/ # 实现模块
│ │ │ │ ├── grid_engine_impl.py # 执行引擎
│ │ │ │ ├── grid_strategy_impl.py # 策略实现
│ │ │ │ ├── position_tracker_impl.py # 持仓跟踪
│ │ │ │ ├── order_health_checker.py # 健康检查
│ │ │ │ └── order_monitor.py # 订单监控
│ │ │ ├── interfaces/ # 接口定义
│ │ │ │ ├── grid_engine.py
│ │ │ │ ├── grid_strategy.py
│ │ │ │ └── position_tracker.py
│ │ │ ├── models/ # 数据模型
│ │ │ │ ├── grid_config.py # 网格配置
│ │ │ │ ├── grid_state.py # 网格状态
│ │ │ │ ├── grid_order.py # 网格订单
│ │ │ │ └── grid_metrics.py # 网格指标
│ │ │ ├── scalping/ # 剥头皮模块
│ │ │ │ ├── scalping_manager.py # 剥头皮管理器
│ │ │ │ └── smart_scalping_tracker.py # 智能剥头皮追踪
│ │ │ ├── capital_protection/ # 本金保护模块
│ │ │ │ └── capital_protection_manager.py
│ │ │ ├── take_profit/ # 止盈模块
│ │ │ │ └── take_profit_manager.py
│ │ │ ├── price_lock/ # 价格锁定模块
│ │ │ │ └── price_lock_manager.py
│ │ │ ├── reserve/ # 现货预留模块
│ │ │ │ ├── spot_reserve_manager.py
│ │ │ │ ├── reserve_monitor.py
│ │ │ │ └── reserve_checker.py
│ │ │ └── terminal_ui.py # 网格系统终端 UI
│ │ ├── volume_maker/ - 刷量交易服务
│ │ │ ├── implementations/
│ │ │ │ ├── volume_maker_service_impl.py # 挂单模式实现
│ │ │ │ └── lighter_market_volume_maker_service.py # 市价模式实现
│ │ │ ├── interfaces/
│ │ │ │ └── volume_maker_service.py
│ │ │ ├── models/
│ │ │ │ ├── volume_maker_config.py
│ │ │ │ └── volume_maker_statistics.py
│ │ │ ├── hourly_statistics.py # 小时统计
│ │ │ └── terminal_ui.py # 刷量系统终端 UI
│ │ ├── arbitrage_monitor/ - 套利监控与执行服务（基础版）
│ │ │ ├── implementations/
│ │ │ │ └── arbitrage_monitor_impl.py # 监控与执行服务实现
│ │ │ ├── interfaces/
│ │ │ │ └── arbitrage_monitor_service.py # 套利服务接口
│ │ │ ├── models/
│ │ │ │ └── arbitrage_models.py # 套利数据模型
│ │ │ └── utils/
│ │ │ └── symbol_converter.py # 交易对转换器
│ │ ├── arbitrage_monitor_v2/ - 套利监控与执行服务 V2（分段版）
│ │ │ ├── models.py # V2 数据模型
│ │ │ ├── analysis/ # 分析模块
│ │ │ │ ├── exchange_locker.py # 交易所锁定
│ │ │ │ ├── opportunity_finder.py # 机会发现
│ │ │ │ └── spread_calculator.py # 价差计算
│ │ │ ├── config/ # 配置模块
│ │ │ │ ├── arbitrage_config.py # 套利配置
│ │ │ │ ├── monitor_config.py # 监控配置
│ │ │ │ ├── unified_config_manager.py # 统一配置管理
│ │ │ │ ├── symbol_config.py # 交易对配置
│ │ │ │ ├── debug_config.py # 调试配置
│ │ │ │ ├── multi_exchange_config.py # 多交易所配置
│ │ │ │ └── multi_leg_pairs_config.py # 多腿配置
│ │ │ ├── core/ # 核心模块
│ │ │ │ ├── unified_orchestrator.py # 统一编排器（监控+决策+执行）
│ │ │ │ ├── arbitrage_orchestrator_v3.py # V3 编排器（多交易对支持）
│ │ │ │ ├── orchestrator.py # 基础编排器
│ │ │ │ ├── orchestrator_simple.py # 简单编排器（轻量级）
│ │ │ │ ├── orchestrator_bootstrap.py # 启动引导器
│ │ │ │ ├── orchestrator_ui_controller.py # UI 控制器
│ │ │ │ ├── spread_pipeline.py # 价差数据流水线
│ │ │ │ ├── reduce_only_probe_service.py # Reduce-Only 探测服务
│ │ │ │ ├── health_monitor.py # 系统健康监控
│ │ │ │ └── debug_state_printer.py # 调试状态打印
│ │ │ ├── data/ # 数据模块
│ │ │ │ ├── data_processor.py # 数据处理器
│ │ │ │ └── data_receiver.py # 数据接收器
│ │ │ ├── decision/ # 决策模块
│ │ │ │ ├── arbitrage_decision.py # 基础模式决策引擎（历史数据分析）
│ │ │ │ └── unified_decision_engine.py # 统一决策引擎（总量驱动算法）
│ │ │ ├── display/ # 显示模块
│ │ │ │ ├── ui_manager.py # UI 管理器
│ │ │ │ ├── realtime_scroller.py # 实时滚动器
│ │ │ │ ├── simple_printer.py # 简单打印器
│ │ │ │ └── ui_components.py # UI 组件
│ │ │ ├── execution/ # 执行模块
│ │ │ │ ├── arbitrage_executor.py # 套利执行器（核心）
│ │ │ │ ├── lighter_batch_executor.py # Lighter批量执行（WS批量+补单）
│ │ │ │ ├── order_strategy_executor.py # 订单策略执行
│ │ │ │ ├── order_monitor.py # 订单监控
│ │ │ │ └── reduce_only_handler.py # Reduce-Only 处理器
│ │ │ ├── guards/ # 守卫模块
│ │ │ │ └── reduce_only_guard.py # Reduce Only 守卫
│ │ │ ├── history/ # 历史数据模块
│ │ │ │ ├── history_calculator.py # 历史数据计算器（天然价差/资金费率差）
│ │ │ │ ├── spread_history_recorder.py # 价差历史记录器（持续采样）
│ │ │ │ ├── spread_history_reader.py # 价差历史读取器（查询接口）
│ │ │ │ └── chart_generator.py # 图表生成器
│ │ │ ├── risk_control/ # 风控模块
│ │ │ │ ├── global_risk_controller.py # 全局风控
│ │ │ │ ├── error_backoff_controller.py # 错误避让控制器
│ │ │ │ └── network_state.py # 网络状态
│ │ │ ├── state/ # 状态模块
│ │ │ │ └── symbol_state_manager.py # 交易对状态管理
│ │ │ └── utils/ # 工具模块
│ │ │ ├── orchestrator_utils.py # 编排器工具
│ │ │ └── risk_control_utils.py # 风控工具（流动性、价格稳定性）
│ │ ├── price_alert/ - 价格提醒服务
│ │ │ ├── implementations/
│ │ │ │ └── price_alert_service_impl.py # 提醒服务实现
│ │ │ ├── interfaces/
│ │ │ │ └── price_alert_service.py # 提醒服务接口
│ │ │ └── models/
│ │ │ ├── alert_config.py # 提醒配置模型
│ │ │ └── alert_statistics.py # 提醒统计模型
│ │ ├── symbol_manager/ - 交易对管理服务
│ │ │ ├── implementations/
│ │ │ │ ├── symbol_conversion_service.py
│ │ │ │ └── symbol_cache_service.py
│ │ │ ├── interfaces/
│ │ │ │ ├── symbol_conversion_service.py
│ │ │ │ └── symbol_cache.py
│ │ │ └── models/
│ │ │ ├── symbol_normalization.py
│ │ │ └── symbol_cache_models.py
│ │ ├── events/ - 事件系统
│ │ │ ├── event.py
│ │ │ ├── event_handler.py
│ │ │ └── __init__.py
│ │ ├── implementations/ - 通用服务实现
│ │ │ └── config_service.py
│ │ └── interfaces/ - 通用服务接口
│ │ ├── base.py
│ │ └── config_service.py
│ ├── domain/ - 领域模型层
│ │ ├── __init__.py
│ │ └── （领域实体和值对象）
│ ├── infrastructure/ - 基础设施层
│ │ ├── __init__.py
│ │ └── （缓存、数据库、消息队列等）
│ ├── di/ - 依赖注入容器
│ │ ├── container.py # DI 容器
│ │ ├── modules.py # 模块注册
│ │ └── （其他 DI 相关文件）
│ └── logging/ - 日志系统
│ ├── __init__.py
│ └── （日志配置和工具）
├── 🌐 api/ - API 层
│ ├── gateway.py # FastAPI 网关
│ ├── middleware/ # 中间件
│ │ ├── logging.py
│ │ └── __init__.py
│ ├── websocket/ # WebSocket 服务
│ │ └── __init__.py
│ └── graphql/ # GraphQL 服务
│ └── __init__.py
├── 🔧 config/ - 配置文件
│ ├── exchanges/ # 交易所配置
│ │ ├── hyperliquid_config.yaml
│ │ ├── backpack_config.yaml
│ │ ├── lighter_config.yaml
│ │ ├── binance_config.yaml
│ │ ├── okx_config.yaml
│ │ ├── edgex_config.yaml
│ │ ├── paradex_config.yaml
│ │ └── grvt_config.yaml
│ ├── grid/ # 网格配置
│ │ ├── lighter_btc_perp_long.yaml
│ │ ├── lighter_btc_perp_short.yaml
│ │ ├── hyperliquid_btc_perp_long.yaml
│ │ ├── hyperliquid_btc_perp_short.yaml
│ │ ├── hyperliquid_btc_spot_long.yaml
│ │ └── backpack_capital_protection_*.yaml （多个）
│ ├── volume_maker/ # 刷量配置
│ │ ├── backpack_btc_volume_maker.yaml
│ │ └── lighter_volume_maker.yaml
│ ├── arbitrage/ # 套利系统配置
│ │ ├── monitor.yaml # 基础模式配置
│ │ ├── monitor_v2.yaml # V2 模式配置
│ │ ├── monitor_lighter_gold.yaml # Lighter 黄金监控配置
│ │ ├── monitor_lighter_multi_btc.yaml # Lighter 多交易对配置
│ │ ├── arbitrage_segmented.yaml # 分段套利执行配置
│ │ └── （其他套利配置）
│ ├── price_alert/ # 价格提醒配置
│ │ └── binance_alert.yaml
│ ├── symbol_conversion.yaml # 交易对转换配置
│ └── logging.yaml # 日志配置
├── 🛠️ tools/ - 工具脚本
│ ├── martin_grid_calculator.py # 马丁网格计算器
│ ├── convert_account_index.py # 账户索引转换
│ ├── query_account_simple.py # 简单账户查询
│ ├── query_account_with_apikey.py # API Key 账户查询
│ ├── test_apikey_direct.py # API Key 直接测试
│ └── README.md # 工具说明文档
├── 📜 scripts/ - 运维脚本
│ ├── start_all_grids.sh # 批量启动网格（tmux）
│ ├── stop_all_grids.sh # 批量停止网格
│ ├── start_volume_maker.sh # 启动挂单刷量
│ ├── start_lighter_volume_maker.sh # 启动市价刷量
│ ├── start_arbitrage_monitor.sh # 启动套利监控
│ ├── start_price_alert.sh # 启动价格提醒
│ ├── check_arbitrage_executor_legs.sh # 套利执行日志检查（单腿成交/零成交检测）
│ ├── check_lighter_ws_batch.sh # Lighter WS批量订单监控
│ ├── check_ports.sh # 端口检查
│ ├── apply_log_optimization.sh # 日志优化
│ ├── release.sh # 发布脚本
│ ├── deployment/ # 部署脚本
│ │ ├── start_system.sh
│ │ └── stop_system.sh
│ ├── migration/ # 迁移脚本
│ │ └── （数据迁移脚本）
│ └── README.md # 脚本说明文档
├── 🧪 tests/ - 测试代码
│ ├── adapters/ # 适配器测试
│ │ ├── hyperliquid/ # Hyperliquid 测试
│ │ ├── backpack/ # Backpack 测试
│ │ ├── lighter/ # Lighter 测试
│ │ ├── binance/ # Binance 测试
│ │ └── okx/ # OKX 测试
│ ├── strategies/ # 策略测试
│ │ ├── grid/ # 网格策略测试
│ │ └── volume_maker/ # 刷量策略测试
│ ├── arbitrage/ # 套利系统测试
│ │ └── reports/ # 测试报告
│ ├── integration/ # 集成测试
│ ├── unit/ # 单元测试
│ ├── performance/ # 性能测试
│ ├── debug/ # 调试测试
│ └── README.md # 测试说明文档
├── 🧪 test/ - 快速测试脚本
│ ├── test_lighter_*.py # Lighter 快速测试
│ ├── test_hyperliquid_*.py # Hyperliquid 快速测试
│ ├── verify_liquidation_price.py # 清算价格验证
│ ├── compare_liquidation_methods.py # 清算方法对比
│ ├── test_log_optimization.py # 日志优化测试
│ └── （其他快速测试脚本）
├── 📝 examples/ - 示例代码
│ ├── basic_demo.py # 基础演示
│ ├── exchange_adapter_demo.py # 适配器演示
│ ├── edgex_adapter_demo.py # EdgeX 演示
│ ├── subscription_mode_demo.py # 订阅模式演示
│ └── （其他示例脚本）
├── 🔍 grid_volatility_scanner/ - 网格波动率扫描器
│ ├── __init__.py # 模块初始化
│ ├── scanner.py # 主扫描器逻辑
│ ├── run_scanner.py # 启动脚本
│ ├── README.md # 扫描器文档
│ ├── config/
│ │ └── market_config.yaml # 市场配置文件
│ ├── models/
│ │ ├── virtual_grid.py # 虚拟网格模型
│ │ └── simulation_result.py # 模拟结果模型
│ ├── core/
│ │ ├── price_monitor.py # 价格监控器
│ │ ├── cycle_detector.py # 循环检测器
│ │ └── apr_calculator.py # APR计算器
│ └── ui/
│ └── scanner_ui.py # Rich终端UI
├── 📚 docs/ - 文档
│ ├── README.md # 文档总入口
│ ├── INDEX.md # 文档索引
│ ├── lighter_sdk_upgrade_guide.md # Lighter SDK 升级指南
│ ├── dependency_conflicts.md # 依赖冲突详解
│ ├── grid-trading/ # 网格交易文档
│ │ └── （70+ 篇详细文档）
│ ├── grid_volatility_scanner/ # 网格波动率扫描器文档
│ │ └── （7 篇详细文档）
│ ├── volume-maker/ # 刷量系统文档
│ │ └── （42 篇详细文档）
│ ├── arbitrage_monitor/ # 套利监控系统文档
│ │ └── （10 篇详细文档）
│ ├── price-alert/ # 价格提醒系统文档
│ │ └── （1 篇文档）
│ ├── lighter/ # Lighter 交易所文档
│ │ └── （47 篇详细文档）
│ ├── hyperliquid/ # Hyperliquid 交易所文档
│ │ └── （23 篇详细文档）
│ ├── architecture/ # 架构设计文档
│ │ └── （36 篇架构文档）
│ ├── adapters/ # 适配器文档
│ │ └── （10 篇适配器文档）
│ ├── features/ # 功能特性文档
│ │ └── （7 篇功能文档）
│ ├── fixes/ # 问题修复文档
│ │ └── （107 篇修复记录）
│ ├── troubleshooting/ # 故障排查文档
│ │ └── （22 篇排查指南）
│ ├── tools/ # 工具文档
│ │ └── （1 篇工具文档）
│ ├── websocket/ # WebSocket 文档
│ │ └── （2 篇 WebSocket 文档）
│ ├── legacy/ # 遗留文档
│ │ └── （3 篇文档）
│ ├── 终端UI稳定显示设计指南.md # 终端UI设计指南
│ ├── Python终端UI库对比指南.md # Python UI库对比
│ └── （其他专题文档）
├── 🗂️ deprecated/ - 废弃代码
│ └── old_monitoring_system/ # 旧版监控系统
├── 📦 web-console/ - Web 前端（可选）
│ ├── src/ # 源代码
│ │ ├── components/ # 通用组件
│ │ ├── pages/ # 页面组件
│ │ ├── services/ # 前端服务
│ │ └── types/ # 类型定义
│ ├── package.json # 前端依赖
│ └── vite.config.ts # 构建配置
├── 📋 logs/ - 日志目录
│ ├── system.log # 系统日志
│ ├── ExchangeAdapter.log # 适配器日志
│ ├── core.services.grid.*.log # 网格系统日志
│ └── （其他日志文件）
├── 🐳 docker/ - Docker 配置
│ └── README.md
├── 📄 requirements.txt # Python 依赖（主环境）
├── 📄 requirements-py312.txt # Python 3.12 依赖
├── 📄 requirements-lighter-spot.txt # Lighter 现货专用依赖
├── 📜 setup_lighter_spot_env.sh # Lighter 现货环境自动安装脚本
├── 📜 activate_lighter_spot.sh # Lighter 现货环境快捷激活脚本
├── 📖 README.md # 项目说明文档（本文件）
├── 📖 LIGHTER_SPOT_SETUP.md # Lighter 现货快速设置指南
├── 📋 PROJECT_STRUCTURE.md # 项目结构说明
├── 📋 REST_API使用总结.md # REST API 使用总结
├── 📋 CHANGELOG.md # 变更日志
└── 📋 VERSION # 版本号
| 脚本 | 命令 | 说明 |
|---|---|---|
| 单个网格启动 | python3 run_grid_trading.py <配置文件> |
启动单个网格交易 |
| DEBUG 模式 | python3 run_grid_trading.py <配置文件> --debug |
详细日志模式 |
| 批量启动 | ./scripts/start_all_grids.sh |
tmux 批量启动多个网格 |
| 批量停止 | ./scripts/stop_all_grids.sh |
停止所有网格 |
| 脚本 | 命令 | 说明 |
|---|---|---|
| 挂单模式 | python3 run_volume_maker.py <配置文件> |
Backpack 挂单刷量 |
| 挂单快速启动 | ./scripts/start_volume_maker.sh |
快速启动 Backpack 刷量 |
| 市价模式 | python3 run_lighter_volume_maker.py <配置文件> |
Lighter 市价刷量 |
| 市价快速启动 | ./scripts/start_lighter_volume_maker.sh |
快速启动 Lighter 刷量 |
| 脚本 | 命令 | 说明 |
|---|---|---|
| 基础套利系统 | python3 run_arbitrage_monitor.py |
基础模式（历史数据决策+执行） |
| 套利系统 V2 | python3 run_arbitrage_monitor_v2.py |
V2 版本（增强监控+执行） |
| 分段套利系统 | python3 main_unified.py --config <配置> --monitor-config <监控> |
网格模式套利执行系统 |
| 套利快速启动 | ./scripts/start_arbitrage_monitor.sh |
快速启动套利系统 |
| 价格提醒 | python3 run_price_alert.py <配置文件> |
启动价格提醒系统 |
| 价格提醒快速启动 | ./scripts/start_price_alert.sh |
快速启动价格提醒 |
| 脚本 | 命令 | 说明 |
|---|---|---|
| 网格波动率扫描器 | python3 grid_volatility_scanner/run_scanner.py |
扫描并推荐最佳网格标的 |
| 自定义扫描时长 | python3 grid_volatility_scanner/run_scanner.py --duration <秒> |
指定扫描时长（秒） |
| 指定交易所 | python3 grid_volatility_scanner/run_scanner.py --exchange <交易所> |
指定交易所扫描 |
# 计算马丁网格所需资金和风险分布
python3 tools/martin_grid_calculator.py# 简单账户查询
python3 tools/query_account_simple.py
# 使用 API Key 查询账户
python3 tools/query_account_with_apikey.py# 转换 Lighter 账户索引
python3 tools/convert_account_index.py# Lighter 测试
python3 test/test_lighter_price_subscription.py
python3 test/test_lighter_get_open_orders.py
python3 test/test_lighter_position_query.py
# Hyperliquid 测试
python3 test/test_hyperliquid_orderbook_simple.py
python3 test/test_hyperliquid_orderbook_ws.py# 验证清算价格计算
python3 test/verify_liquidation_price.py
# 对比不同清算方法
python3 test/compare_liquidation_methods.pyAPI 层 (api/)
↓
服务层 (core/services/)
↓
领域层 (core/domain/)
↓
适配器层 (core/adapters/)
↓
基础设施层 (core/infrastructure/)
- 依赖倒置原则：高层模块不依赖低层模块，都依赖抽象
- 接口分离原则：服务接口定义与实现分离
- 单一职责原则：每个模块只负责一个明确的业务功能
- 开闭原则：通过接口扩展功能，不修改现有实现
- ❌ API 层直接调用适配器层
- ❌ 服务层硬编码具体依赖
- ❌ 跨层级的直接调用
- ❌ 循环依赖关系
- 核心语言：Python 3.8+
- 异步框架：asyncio, aiohttp
- API 框架：FastAPI
- 数据验证：Pydantic
- WebSocket：websockets, aiohttp
- 配置管理：PyYAML
- 日志系统：structlog, logging
- 终端 UI：Rich（现代化终端界面库）
- 测试框架：pytest, pytest-asyncio
- 进程管理：tmux（多进程管理）
- 容器化：Docker（可选）
- 版本控制：Git
详细开发规范请参考 .cursor/rules/ 目录下的规则文件：
- architecture.mdc - 分层架构设计原则
- dependency_injection.mdc - 依赖注入模式规范
- code_style.mdc - Python 代码风格规范
- imports.mdc - 导入路径规范
- api_layer.mdc - API 层设计规范
- services.mdc - 服务层开发规范
- testing.mdc - 测试规范
- 文档总入口 - 完整文档导航
- 文档索引 - 所有文档索引
- 网格交易系统完整指南 - 70+ 篇网格交易详细文档
- 网格波动率扫描器文档 - 扫描器使用指南
- 刷量系统文档 - 42 篇刷量系统文档
- 套利系统文档 - 10 篇套利系统文档（监控+执行）
- 架构设计文档 - 36 篇架构设计文档
- Lighter 现货设置指南 - Lighter 现货快速开始
- Lighter SDK 升级指南 - SDK 升级详细文档
- 依赖冲突详解 - 依赖冲突和解决方案
- Lighter 交易所文档 - 47 篇 Lighter 专题文档
- Hyperliquid 交易所文档 - 23 篇 Hyperliquid 专题文档
- 多交易所接入快速参考 - 快速接入指南
在 config/exchanges/ 目录下找到对应交易所的配置文件，填入 API 密钥：
# config/exchanges/lighter_config.yaml 示例
api_config:
auth:
api_key_private_key: "你的API密钥私钥"
account_index: 0
api_key_index: 0复制现有的配置文件（如 config/grid/lighter_btc_perp_long.yaml），修改 symbol 字段和相关参数即可。
- 普通网格（固定价格区间）
- 马丁网格（递增订单量）
- 价格移动网格（动态跟随价格）
- 剥头皮模式（快速止损）
- 智能剥头皮（多次深跌检测）
- 本金保护模式（自动止损）
- 止盈模式（达到目标自动平仓）
- 挂单模式（Backpack）：使用限价单，成交率较低但手续费有返佣
- 市价模式（Lighter）：使用市价单，立即成交但手续费较高
- 单个脚本：按
Ctrl+C或在终端 UI 中按Q键 - tmux 批量启动的网格：运行
./scripts/stop_all_grids.sh
所有日志文件位于 logs/ 目录下，按模块分类：
system.log- 系统总日志ExchangeAdapter.log- 交易所适配器日志core.services.grid.*.log- 网格系统各模块日志
使用 --debug 参数启动脚本：
python3 run_grid_trading.py config/grid/lighter_btc_perp_long.yaml --debug网格波动率扫描器可以帮助您快速识别最适合做网格的代币：
# 扫描1小时（默认）
python3 grid_volatility_scanner/run_scanner.py
# 扫描30分钟
python3 grid_volatility_scanner/run_scanner.py --duration 1800
# 使用Hyperliquid交易所
python3 grid_volatility_scanner/run_scanner.py --exchange hyperliquid扫描器会实时显示代币的APR排名，S级（≥500% APR）代币强烈推荐用于网格交易。
系统使用多个虚拟环境隔离不同的依赖：
# 主环境（套利、永续合约网格、刷量）
source .venv-py312/bin/activate
# Lighter 现货专用环境
source activate_lighter_spot.sh
# 或
source .venv-lighter-spot/bin/activate
# 退出当前环境
deactivate为什么需要多个环境？ 因为不同 SDK 的依赖版本存在冲突，详见 依赖冲突详解。
Lighter 现货交易需要特殊配置：
# config/grid/lighter-long-spot-eth.yaml
grid_system:
exchange: "lighter"
symbol: "ETH/USDC"
market_type: "spot" # 必须设置为 spot
spot_reserve: # 现货预留配置
enabled: true
reserve_amount: 0.02
# ... 其他配置详细设置请参考 LIGHTER_SPOT_SETUP.md。
如果遇到依赖冲突（如 eth-account 版本不兼容），请：
- 使用对应的虚拟环境
- 参考 依赖冲突详解
- 检查当前环境：
pip show eth-account - 验证环境：
python -c "import lighter; print(lighter.__version__)"
- API 密钥安全：请妥善保管 API 密钥，不要上传到公共仓库
- 资金安全：建议先用小额资金测试系统
- 网络稳定：确保网络连接稳定，WebSocket 断线会自动重连
- 交易限制：注意交易所的订单数量限制（如 Lighter 每个市场的最大活跃订单数）
- 现货做空：现货市场不支持做空，仅支持做多网格
- 手续费：不同交易所手续费不同，请在配置文件中正确设置
fee_rate - 精度问题：不同交易对的数量精度不同，请在配置中正确设置
quantity_precision - 环境隔离：Lighter 现货需使用独立虚拟环境（
.venv-lighter-spot），不要在主环境中运行 - 依赖冲突：不同脚本需要不同环境，运行前请确认已激活正确的虚拟环境
- SDK 版本：Lighter 永续合约使用旧版 SDK，现货使用新版 SDK 1.0.1，不可混用
如有问题或建议，请参考 docs/ 目录下的详细文档，或查看 docs/troubleshooting/ 中的故障排查指南。
多交易所策略自动化系统 v2.0.0 - 企业级加密货币自动化交易平台