Bitget Trader 🟦

Professional Bitget integration for automated grid trading and portfolio management.

🚀 Quick Start

Setup Credentials

Save to /Users/zongzi/.openclaw/workspace/bitget_data/config.json:

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

API Key Requirements

• Permissions: Spot Read + Spot Trade
• IP Whitelist: Recommended but optional
• Passphrase: Required (set when creating API key)

📊 Basic Commands

Check Balance

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

Monitor Grid Status

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

Start Grid Trading

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

Cancel All Orders

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

🎯 Grid Trading System

Configuration

Edit /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
  }
}

Parameters

📈 Available Scripts

Core Trading

Analysis & Optimization

Dynamic Adjustment

Single Coin Operations

🔧 Advanced Features

1. Multi-Coin Grid Support

Supports concurrent grid trading for multiple coins:

• BTCUSDT (Bitcoin)
• ETHUSDT (Ethereum)
• SOLUSDT (Solana)
• BNBUSDT (Binance Coin)

2. Dynamic Grid Adjustment

Automatically adjusts grid parameters based on:

• Market volatility
• Price trends
• Order fill rates
• Balance availability

3. Risk Management

• Position Limits: Configurable maxPosition per coin
• Order Throttling: Prevents API rate limiting
• Balance Check: Validates sufficient USDT before deployment

4. Comprehensive Logging

All operations logged to:

• grid_monitor.log - Grid status updates
• monitor.log - General monitoring logs
• trade-analysis.log - Trade analysis results

📊 Reporting

Generate Reports

# Grid status report
node /Users/zongzi/.openclaw/workspace/bitget_data/monitor-grid.js

# Trade analysis
node /Users/zongzi/.openclaw/workspace/bitget_data/trade-analyzer.js

# Quick report
node /Users/zongzi/.openclaw/workspace/bitget_data/quick-report.js

Report Files

• GRID_STATUS_REPORT.md - Current grid status
• GRID_OPTIMIZATION_REPORT.md - Optimization suggestions
• DYNAMIC_STRATEGY_REPORT.md - Dynamic strategy analysis

⚠️ Risk Warning

• Cryptocurrency trading involves significant risk
• Test with small amounts first
• Never invest more than you can afford to lose
• API keys should have NO withdrawal permissions

🔐 Security Best Practices

1. API Key Permissions: Only enable Spot Read + Spot Trade
2. IP Whitelist: Restrict API access to your IP
3. No Withdrawal: Never enable withdrawal permissions
4. Secure Storage: Keep config.json secure (chmod 600)

📝 File Structure

bitget_data/
├── config.json                 # API credentials
├── grid_settings.json          # Grid configurations
├── monitor-grid.js             # Main monitoring script
├── start-simple.js             # Start all grids
├── cancel-all.js               # Cancel all orders
├── check-balance.js            # Check balance
├── grid-optimizer.js           # Grid optimization
├── trade-analyzer.js           # Trade analysis
├── dynamic-adjust.js           # Dynamic adjustments
├── grid_monitor.log            # Monitoring logs
└── SKILL.md                    # This file

🆘 Troubleshooting

Common Issues

1. Signature Mismatch

• Check API key format (should start with bg_)
• Verify secret key is correct
• Ensure system time is synchronized

2. Proxy Connection Failed

• Ensure proxy is running on port 7897
• Check ClashX/Shadowrocket status
• Try: curl -x http://127.0.0.1:7897 https://api.bitget.com

3. Insufficient Balance

• Check USDT balance: node check-balance.js
• Reduce amount or gridNum in grid_settings.json
• Consider restoring original config from backup

4. Orders Not Filling

• Check grid price range covers current market price
• Verify order quantity meets exchange minimum
• Review grid spacing (may be too tight/wide)

📚 API Reference

Bitget API v2 Endpoints

Signature Generation

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');

🎯 Quick Commands Reference

# Monitor all grids
node monitor-grid.js

# Start trading
node start-simple.js

# Stop trading (cancel all)
node cancel-all.js

# Check balance
node check-balance.js

# Optimize grids
node grid-optimizer.js

# Analyze trades
node trade-analyzer.js

# Generate report
node quick-report.js

Version: 1.0.0
Exchange: Bitget
Type: Spot Grid Trading
Last Updated: 2026-03-10