Dnevend

README_grid_config_generator.md

README_grid_config_generator.md

网格配置生成器 - Grid Configuration Generator

📖 简介

网格配置生成器是一个自动化工具,用于根据U本位设置方案自动计算网格参数并生成/更新配置文件。

🎯 解决的问题

传统的网格配置需要手动计算以下参数:

  • grid_interval (网格间隔)
  • order_amount (每格数量)
  • martingale_increment (马丁递增)
  • quantity_precision (数量精度)
  • price_decimals (价格精度)

这些计算非常繁琐且容易出错。网格配置生成器让你只需设置:

  • 每格投入金额(如 $12 USDC)
  • 网格区间百分比(如 50%)
  • 总网格数(如 500)

工具会自动计算所有参数并更新配置文件!


🚀 快速开始

1. 基本使用

# 只需输入代币名称(大小写都行)
python3 tools/grid_config_generator.py btc
python3 tools/grid_config_generator.py ETH
python3 tools/grid_config_generator.py Bnb

2. 工作流程

输入代币名称
    ↓
自动获取价格
    ↓
自动计算参数
    ↓
生成/更新配置文件
    ↓
【可选】自动同步到其他目录
    ↓
完成!

⚙️ 配置说明

工具配置文件

编辑 tools/grid_config_generator.yaml 来设置默认参数:

# 网格参数(U本位方案)
grid_value_per_order: 12          # 每格投入金额(USDC)
grid_range_percentage: 50         # 网格区间百分比(%)
follow_grid_count: 500            # 总网格数

# 马丁格尔配置
enable_martingale: false          # 是否启用U本位马丁递增
martingale_increment_usd: 1       # U本位递增金额(USDC/格)

# 交易所配置
exchange: "lighter"               # 交易所名称
direction: "long"                 # 方向:long(做多) | short(做空)
market_type: "perp"               # 市场类型:perp(永续合约) | spot(现货)

# 自动同步配置
auto_sync: true                   # 是否自动同步到其他目录

📊 计算示例

输入参数

代币: BTC
当前价格: $100,000
每格价值: $12 USDC
网格区间: 50%
总网格数: 500
方向: 做多 (long)

计算过程(做多)

  1. 价格区间

    • 做多:从当前价格向下扩展
    • 上限 = $100,000
    • 下限 = $100,000 × (1 - 50%) = $50,000
    • 区间 = [$50,000, $100,000]
  2. 网格间隔

    grid_interval = ($100,000 - $50,000) / 500
                  = $100 / 格
  3. 首格价格

    first_grid_price = $50,000 + $100
                     = $50,100
  4. 每格基础数量

    order_amount = $12 / $50,100
                 = 0.0002395 BTC
  5. 马丁递增(如果启用U本位马丁)

    avg_price = ($50,000 + $100,000) / 2
              = $75,000
    
    martingale_increment = $1 / $75,000
                         = 0.00001333 BTC/格

输出结果

follow_grid_count: 500
grid_interval: 100
order_amount: 0.0002395
quantity_precision: 5
price_decimals: 1
martingale_increment: 0.00001333  # 如果启用

🎨 文件命名规则

配置文件命名格式

{exchange}-{direction}-{market_type}-{symbol}.yaml

示例

文件名 说明
lighter-long-perp-btc.yaml Lighter, 做多, 永续合约, BTC
lighter-short-perp-eth.yaml Lighter, 做空, 永续合约, ETH
lighter-long-spot-bnb.yaml Lighter, 做多, 现货, BNB

代币符号规则

  • 文件名:使用小写(如 btc, eth, bnb)
  • 配置中的 symbol 字段:使用大写(如 BTC, ETH, BNB)

工具会自动处理大小写转换!


🔄 自动同步功能

启用自动同步

在 tools/grid_config_generator.yaml 中:

auto_sync: true                   # 启用自动同步
sync_script: "./sync_configs.sh"  # 同步脚本路径

工作流程

生成/更新配置文件
    ↓
自动调用 ./sync_configs.sh
    ↓
同步到所有账户目录
    ↓
完成!

同步示例

# 生成BTC配置并自动同步
python3 tools/grid_config_generator.py btc

# 输出:
# ✅ 配置文件已保存: lighter-long-perp-btc.yaml
# 🔄 正在同步配置到其他目录...
# ✅ 同步完成!5个账户已更新

📝 完整使用示例

场景1:生成BTC配置

# 1. 修改默认参数(可选)
vim tools/grid_config_generator.yaml

# 2. 运行生成器
python3 tools/grid_config_generator.py btc

输出示例:

==================================================
  🚀 网格配置生成器 - Grid Configuration Generator
==================================================

✅ 工具配置加载成功

📡 正在获取 BTC 价格...
✅ 获取价格成功: BTC = $99,845.50

🧮 正在计算网格参数...
✅ 计算完成

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  📊 计算结果摘要 - BTC
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔍 价格信息:
  • 当前价格: $99,845.50
  • 价格区间: [$49,922.75, $99,845.50]
  • 首格价格: $50,022.59
  • 平均价格: $74,884.13

⚙️  网格参数:
  • 总网格数: 500
  • 网格间隔: 99.845400
  • 每格数量: 0.00023989
  • 数量精度: 5
  • 价格精度: 1

💰 投入估算:
  • 每格价值: $12 USDC
  • 总投入: $6,000.00 USDC (如果全部成交)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📄 加载现有配置: lighter-long-perp-btc.yaml
✅ 配置文件已保存: lighter-long-perp-btc.yaml

🔄 正在同步配置到其他目录...
✅ 同步完成!

✅ 全部完成!

场景2:生成新代币配置(从模板)

# 生成HYPE配置(假设文件不存在)
python3 tools/grid_config_generator.py hype

# 工具会:
# 1. 从模板文件创建新配置
# 2. 获取HYPE价格
# 3. 计算参数
# 4. 保存为 lighter-long-perp-hype.yaml
# 5. 同步到其他目录(如果启用)

场景3:启用U本位马丁递增

# 1. 编辑工具配置
vim tools/grid_config_generator.yaml

# 修改:
enable_martingale: true
martingale_increment_usd: 1  # 每格递增 $1 USDC

# 2. 运行生成器
python3 tools/grid_config_generator.py eth

# 配置文件会包含:
# martingale_increment: 0.00027  # 根据ETH价格计算

🛠️ 高级功能

1. 做空配置

# tools/grid_config_generator.yaml
direction: "short"  # 改为做空

做空时:

  • 价格区间:从当前价格向上扩展
  • 下限 = 当前价格
  • 上限 = 当前价格 × (1 + 区间百分比)

2. 现货配置

# tools/grid_config_generator.yaml
market_type: "spot"  # 改为现货

3. 禁用自动同步

# tools/grid_config_generator.yaml
auto_sync: false  # 禁用自动同步

4. 自定义API地址

# tools/grid_config_generator.yaml
lighter_api_url: "https://custom-api.lighter.xyz"
price_fetch_timeout: 20  # 超时时间(秒)

🔍 故障排查

问题1:无法获取价格

错误信息:

❌ 无法获取价格,请检查网络连接或API配置

解决方案:

  1. 检查网络连接
  2. 检查 Lighter API 是否可访问
  3. 手动在配置文件中设置参数

问题2:模板文件不存在

错误信息:

❌ 模板文件不存在: lighter-long-perp-模版.yaml

解决方案:

  1. 确保模板文件存在:config/grid/lighter-long-perp-模版.yaml
  2. 或者修改工具配置:
    template_file: "lighter-long-perp-btc.yaml"  # 使用已有文件作为模板

问题3:同步脚本不存在

警告信息:

⚠️  同步脚本不存在: ./sync_configs.sh

解决方案:

  1. 确保同步脚本存在:tools/sync_configs.sh
  2. 或者禁用自动同步:
    auto_sync: false

📋 参数对照表

U本位方案 vs 传统方案

U本位方案参数 传统方案参数 说明
grid_value_per_order order_amount 每格投入金额 → 自动计算数量
grid_range_percentage lower_price, upper_price 百分比 → 自动计算价格区间
martingale_increment_usd martingale_increment U本位递增 → 自动计算数量递增

计算公式

# 做多 (long)
lower_price = current_price × (1 - range_percentage)
upper_price = current_price
grid_interval = (upper_price - lower_price) / grid_count
first_grid_price = lower_price + grid_interval
order_amount = grid_value_per_order / first_grid_price

# 做空 (short)
lower_price = current_price
upper_price = current_price × (1 + range_percentage)
grid_interval = (upper_price - lower_price) / grid_count
first_grid_price = upper_price - grid_interval
order_amount = grid_value_per_order / first_grid_price

# 马丁递增(U本位)
avg_price = (lower_price + upper_price) / 2
martingale_increment = martingale_increment_usd / avg_price

🎓 最佳实践

1. 参数选择建议

参数 低波动币(BTC/ETH) 高波动币(山寨币)
grid_value_per_order $10-15 $5-10
grid_range_percentage 30-50% 50-80%
follow_grid_count 300-500 500-1000

2. 工作流程建议

# 1. 批量生成多个代币配置
python3 tools/grid_config_generator.py btc
python3 tools/grid_config_generator.py eth
python3 tools/grid_config_generator.py mega

# 2. 检查生成的配置文件
ls -l config/grid/lighter-long-perp-*.yaml

# 3. 如需调整,修改工具配置后重新生成
vim tools/grid_config_generator.yaml
python3 tools/grid_config_generator.py btc  # 重新生成

3. 安全建议

  • ✅ 启用自动同步前,先在单个目录测试
  • ✅ 定期备份配置文件
  • ✅ 新代币首次运行前,手动检查生成的配置
  • ✅ 使用小资金测试新参数

📚 相关文档


🤝 贡献

发现问题或有改进建议?欢迎提交 Issue 或 Pull Request!


📄 许可证

MIT License


祝你交易顺利!📈