◉ClassyGitdnevend

QUICKSTART_grid_config_generator.md

QUICKSTART_grid_config_generator.md

网格配置生成器 - 快速参考

⚡ 一分钟上手

基本使用

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

工作流程

输入代币 → 获取价格 → 计算参数 → 更新配置 → [自动同步] → 完成!

⚙️ 快速配置

编辑 tools/grid_config_generator.yaml:

grid_value_per_order: 12          # 每格投入:$12 USDC
grid_range_percentage: 50         # 网格区间:50%
follow_grid_count: 500            # 总网格数:500
auto_sync: true                   # 自动同步:开启

📊 计算逻辑

做多 (Long)

当前价格: $100,000
区间百分比: 50%
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
价格区间: [$50,000, $100,000]
网格间隔: $50,000 / 500 = $100
首格价格: $50,100
每格数量: $12 / $50,100 = 0.0002395 BTC

做空 (Short)

当前价格: $100,000
区间百分比: 50%
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
价格区间: [$100,000, $150,000]
网格间隔: $50,000 / 500 = $100
首格价格: $149,900
每格数量: $12 / $149,900 = 0.0000800 BTC

🎯 实战示例

示例1:生成BTC配置

$ python3 tools/grid_config_generator.py btc

==================================================
  🚀 网格配置生成器
==================================================

✅ 工具配置加载成功
📡 正在获取 BTC 价格...
✅ 获取价格成功: BTC = $99,845.50
🧮 正在计算网格参数...
✅ 计算完成

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

🔍 价格信息:
  • 当前价格: $99,845.50
  • 价格区间: [$49,922.75, $99,845.50]
  • 网格间隔: 99.85

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

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

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

✅ 配置文件已保存: lighter-long-perp-btc.yaml
🔄 正在同步配置到其他目录...
✅ 同步完成!

✅ 全部完成!

示例2:批量生成

# 生成多个代币配置
for token in btc eth bnb mega zk; do
  python3 tools/grid_config_generator.py $token
done

🔧 常用调整

1. 修改投入金额

# tools/grid_config_generator.yaml
grid_value_per_order: 15  # 改为 $15 USDC/格

2. 修改网格区间

# tools/grid_config_generator.yaml
grid_range_percentage: 70  # 改为 70%

3. 启用马丁递增

# tools/grid_config_generator.yaml
enable_martingale: true
martingale_increment_usd: 1  # 每格递增 $1 USDC

4. 切换做空模式

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

5. 禁用自动同步

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

📁 文件命名

输入 生成的文件名 symbol字段
btc lighter-long-perp-btc.yaml BTC
ETH lighter-long-perp-eth.yaml ETH
Bnb lighter-long-perp-bnb.yaml BNB

自动处理大小写!


❓ 常见问题

Q: 无法获取价格?

A: 检查网络连接,或手动在配置文件中设置参数。

Q: 想用已有配置作为模板?

A: 编辑工具配置:

template_file: "lighter-long-perp-btc.yaml"

Q: 如何验证计算是否正确?

A: 工具会显示详细的计算摘要,检查:

  • 价格区间是否合理
  • 网格间隔是否合适
  • 每格数量是否符合预期

Q: 生成后想微调某些参数?

A: 直接编辑生成的配置文件,或修改工具配置后重新生成。


📚 完整文档


💡 最佳实践

  1. 先测试单个代币 → 检查结果 → 批量生成
  2. 定期备份配置 → 避免误操作
  3. 小资金测试 → 验证参数正确性
  4. 监控首次运行 → 确保网格正常工作

祝你使用愉快!🎉