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)
计算过程(做多)
-
价格区间
- 做多:从当前价格向下扩展
- 上限 = $100,000
- 下限 = $100,000 × (1 - 50%) = $50,000
- 区间 = [$50,000, $100,000]
-
网格间隔
grid_interval = ($100,000 - $50,000) / 500 = $100 / 格 -
首格价格
first_grid_price = $50,000 + $100 = $50,100 -
每格基础数量
order_amount = $12 / $50,100 = 0.0002395 BTC -
马丁递增(如果启用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配置
解决方案:
- 检查网络连接
- 检查 Lighter API 是否可访问
- 手动在配置文件中设置参数
问题2:模板文件不存在
错误信息:
❌ 模板文件不存在: lighter-long-perp-模版.yaml
解决方案:
- 确保模板文件存在:
config/grid/lighter-long-perp-模版.yaml - 或者修改工具配置:
template_file: "lighter-long-perp-btc.yaml" # 使用已有文件作为模板
问题3:同步脚本不存在
警告信息:
⚠️ 同步脚本不存在: ./sync_configs.sh
解决方案:
- 确保同步脚本存在:
tools/sync_configs.sh - 或者禁用自动同步:
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
祝你交易顺利!📈