README.md

Tools 工具目录

本目录包含独立运行的工具脚本和客户端程序。

---

工具列表

1. martin_grid_calculator.py

马丁网格计算器 ⭐️ 推荐

计算马丁网格策略的资金需求和分布情况。

功能:

• 计算总投入金额
• 计算倍数关系（Grid 200 / Grid 1）
• 显示资金消耗进度（50%、75%、90%）
• 显示后期网格资金占比
• 帮助评估风险和资金压力

运行方式:

# 交互式模式（推荐）
python tools/martin_grid_calculator.py

# 命令行模式
python tools/martin_grid_calculator.py <第一格金额> <递增金额>
# 示例：
python tools/martin_grid_calculator.py 0.01 0.0005

使用场景:

• 配置网格策略前，评估资金需求
• 对比不同参数配置的风险分布
• 找到合适的 order_amount 和 martingale_increment

输出示例:

【核心数据】
💰 总投入金额:        $      12,000.50
📊 平均每格金额:      $         60.002
🎯 Grid 1 金额:       $          0.010
🎯 Grid 200 金额:     $          0.110
📈 倍数关系:                     11.00x

【资金消耗进度】
💵 用完 50% 资金:     Grid 138 (还剩 62 个网格)
💵 用完 75% 资金:     Grid 173 (还剩 27 个网格)
💵 用完 90% 资金:     Grid 189 (还剩 11 个网格)

---

2. terminal_monitor.py

终端监控客户端

• 功能: 连接到SocketIO服务器，实时显示价格数据和套利机会
• 运行方式: python tools/terminal_monitor.py
• 依赖: 需要系统运行在监控模式或混合模式
• 用途:
  • 实时监控多交易所价格数据
  • 显示套利机会
  • 性能监控和调试

---

使用指南

启动终端监控客户端

1. 确保系统在运行（监控模式或混合模式）:

   # 启动监控模式
   python run_monitor.py
   
   # 或启动混合模式
   python run_hybrid.py

2. 在另一个终端启动监控客户端:

   python tools/terminal_monitor.py

3. 客户端将显示实时价格数据和统计信息。

注意事项

• 这些工具是独立运行的，不是主系统的一部分
• 工具可能有额外的依赖要求，请查看具体脚本的说明
• 确保在使用前系统核心服务已正常运行