Bitget Trader 🟦

面向专业用户的 Bitget 自动化网格交易与组合管理集成方案。

🚀 快速上手

配置凭据

保存至 /Users/zongzi/.openclaw/workspace/bitget_data/config.json：

{
  "apiKey": "bg_your_api_key",
  "secretKey": "your_secret_key",
  "passphrase": "your_passphrase",
  "isSimulation": false
}

API Key 权限要求

• 权限范围：现货读取（Spot Read）+ 现货交易（Spot Trade）
• IP 白名单：推荐启用，但非强制
• 密语（Passphrase）：必需（创建 API Key 时设置）

📊 基础命令

查询账户余额

node /Users/zongzi/.openclaw/workspace/bitget_data/check-balance.js

监控网格状态

node /Users/zongzi/.openclaw/workspace/bitget_data/monitor-grid.js

启动网格交易

node /Users/zongzi/.openclaw/workspace/bitget_data/start-simple.js

撤销全部订单

node /Users/zongzi/.openclaw/workspace/bitget_data/cancel-all.js

🎯 网格交易系统

配置文件

编辑 /Users/zongzi/.openclaw/workspace/bitget_data/grid_settings.json：

{
  "btc": {
    "symbol": "BTCUSDT",
    "gridNum": 50,
    "priceMin": 63000,
    "priceMax": 70000,
    "amount": 20,
    "maxPosition": 400,
    "sellOrders": 10,
    "buyOrders": 10
  },
  "eth": {
    "symbol": "ETHUSDT",
    "gridNum": 30,
    "priceMin": 1800,
    "priceMax": 2700,
    "amount": 4,
    "maxPosition": 150
  }
}

参数说明

📈 可用脚本列表

核心交易脚本

分析与优化脚本

动态调整脚本

单币种操作脚本

🔧 高级功能

1. 多币种网格支持

支持多币种并发网格交易：

• BTCUSDT（比特币）
• ETHUSDT（以太坊）
• SOLUSDT（Solana）
• BNBUSDT（币安币）

2. 动态网格调整

根据以下指标自动调整网格参数：

• 市场波动率
• 价格趋势
• 订单成交率
• 可用余额

3. 风控机制

• 持仓限额：可为每种币种单独配置 maxPosition
• 下单节流：防止触发 API 调用频率限制
• 余额校验：部署前自动验证 USDT 是否充足

4. 全面日志记录

所有操作均记录至以下文件：

• grid_monitor.log — 网格状态更新日志
• monitor.log — 通用监控日志
• trade-analysis.log — 交易分析结果日志

📊 报告生成

生成报告

# 网格状态报告
node /Users/zongzi/.openclaw/workspace/bitget_data/monitor-grid.js

# 交易分析报告
node /Users/zongzi/.openclaw/workspace/bitget_data/trade-analyzer.js

# 快速报告
node /Users/zongzi/.openclaw/workspace/bitget_data/quick-report.js

报告文件

• GRID_STATUS_REPORT.md — 当前网格状态
• GRID_OPTIMIZATION_REPORT.md — 网格优化建议
• DYNAMIC_STRATEGY_REPORT.md — 动态策略分析报告

⚠️ 风险提示

• 加密货币交易存在重大风险
• 请先使用小额资金测试
• 切勿投入超出您承受能力的资金
• API Key 不得开启提币权限

🔐 安全最佳实践

1. API Key 权限：仅启用 Spot Read + Spot Trade
2. IP 白名单：将 API 访问限制为您的固定 IP 地址
3. 禁用提币：绝对不可启用提币权限
4. 安全存储：妥善保管 config.json（建议执行 chmod 600）

📝 文件结构

bitget_data/
├── config.json                 # API 凭据
├── grid_settings.json          # 网格配置
├── monitor-grid.js             # 主监控脚本
├── start-simple.js             # 启动全部网格
├── cancel-all.js               # 撤销全部订单
├── check-balance.js            # 查询余额
├── grid-optimizer.js           # 网格参数优化
├── trade-analyzer.js           # 交易分析
├── dynamic-adjust.js           # 动态调整
├── grid_monitor.log            # 监控日志
└── SKILL.md                    # 本文档

🆘 故障排查

常见问题

1. 签名不匹配（Signature Mismatch）

• 检查 API Key 格式（必须以 bg_ 开头）
• 确认 secretKey 正确无误
• 确保系统时间已同步（NTP）

2. 代理连接失败（Proxy Connection Failed）

• 确认代理服务正在端口 7897 运行
• 检查 ClashX / Shadowrocket 连接状态
• 可尝试测试：curl -x http://127.0.0.1:7897 https://api.bitget.com

3. 余额不足（Insufficient Balance）

• 检查 USDT 余额：node check-balance.js
• 降低 grid_settings.json 中的 amount 或 gridNum
• 必要时从备份中恢复原始配置

4. 订单无法成交（Orders Not Filling）

• 确认网格价格区间覆盖当前市场价格
• 验证下单数量满足交易所最小单位要求
• 检查网格间距是否过窄或过宽

📚 API 参考文档

Bitget API v2 接口列表

签名生成逻辑

const timestamp = new Date().toISOString().split('.')[0] + '.000Z';
const method = 'GET';
const path = '/api/v2/spot/account';
const body = '';
const signStr = timestamp + method + path + body;
const signature = crypto.createHmac('sha256', secretKey).update(signStr).digest('base64');

🎯 快速命令参考

# 监控全部网格
node monitor-grid.js

# 启动交易
node start-simple.js

# 停止交易（撤销全部订单）
node cancel-all.js

# 查询余额
node check-balance.js

# 优化网格参数
node grid-optimizer.js

# 分析交易记录
node trade-analyzer.js

# 生成报告
node quick-report.js

版本: 1.0.0
交易所: Bitget
类型: 现货网格交易
最后更新: 2026-03-10