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:

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#

bash

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

Monitor Grid Status#

bash

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

Start Grid Trading#

bash

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

Cancel All Orders#

bash

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

🎯 Grid Trading System#

Configuration#

Edit /Users/zongzi/.openclaw/workspace/bitget_data/grid_settings.json:

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#

ParameterDescriptionExamplesymbolTrading pairBTCUSDTgridNumNumber of grid levels50priceMinMinimum price63000priceMaxMaximum price70000amountUSDT per order20maxPositionMax total position400sellOrdersMax sell orders10buyOrdersMax buy orders10

📈 Available Scripts#

Core Trading#

ScriptPurposemonitor-grid.jsMonitor all grid strategiesstart-simple.jsStart all gridscancel-all.jsCancel all orderscheck-balance.jsCheck account balance

Analysis & Optimization#

ScriptPurposegrid-optimizer.jsOptimize grid parameterskline-analyzer.jsAnalyze K-line datatrade-analyzer.jsAnalyze trade historyquick-report.jsGenerate quick report

Dynamic Adjustment#

ScriptPurposedynamic-adjust.jsDynamic grid adjustmentdynamic-rebalance.jsPortfolio rebalancingapply-scheme-a.jsApply optimization scheme A

Single Coin Operations#

ScriptPurposestart-eth.jsStart ETH griddeploy-bnb-grid.jsDeploy BNB gridbuy-eth-market.jsBuy ETH at market price

🔧 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#

bash

# 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#

text

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#

EndpointMethodPurpose/api/v2/spot/accountGETGet account info/api/v2/spot/ordersGETGet open orders/api/v2/spot/place-orderPOSTPlace order/api/v2/spot/cancel-orderPOSTCancel order/api/v2/spot/market-tickersGETGet market prices

Signature Generation#

javascript

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#

bash

# 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