A production-grade, TypeScript-based automated grid trading bot for Gate.io Spot markets. It deploys a grid of limit buy and sell orders within a defined price range, automatically rebalances as orders fill, and uses an AI signal engine to optimize grid bounds, strategy selection, and market timing.

• AI-Powered Optimization — Multi-indicator ensemble (RSI, MACD, EMA, Bollinger Bands, SMA) for range and strategy recommendations
• Dual Grid Strategies — Arithmetic (equal price steps) and Geometric (equal percentage steps), plus auto mode where AI picks the best fit
• AI Auto-Range — Optional dynamic grid bounds based on live volatility and trend analysis
• Paper Trading Mode — Full simulation engine for risk-free testing
• Live Trading — Direct integration with Gate.io Spot API v4 (HMAC-SHA512 auth)
• State Persistence — Automatic save/resume across restarts
• Graceful Shutdown — Cancels open orders and persists state on SIGINT/SIGTERM
• Retry Logic — Exponential backoff for API resilience
• Structured Logging — Pino-based logging with configurable levels
• Type-Safe Config — Zod schema validation for all environment variables

Grid trading places buy orders below the current price and sell orders above it. When a buy fills, a sell is placed one grid level higher. When that sell fills, a new buy is placed one level lower. Each completed buy→sell cycle captures the spread between grid levels as profit.

Price
  ▲
  │  ── SELL ── SELL ── SELL ── SELL     ← Upper bound
  │       │       │       │
  │  ── BUY  ── BUY  ── BUY  ── BUY      ← Lower bound
  └──────────────────────────────────▶ Time

Arithmetic Grid — Fixed price steps. Best for stable, range-bound assets.

Geometric Grid — Fixed percentage steps. Best for volatile assets.

AI Auto — Analyzes volatility and trend to recommend arithmetic vs geometric and optional price bounds.

gateio-ai-grid-trading-bot/
├── src/
│   ├── ai/               # Signal engine, indicators, grid advisor
│   ├── cli/              # CLI entry (start, preview, analyze, validate)
│   ├── config/           # Zod schema and env loader
│   ├── core/             # Grid engine — order lifecycle
│   ├── exchange/         # Gate.io API client + paper simulator
│   ├── services/         # Bot orchestration and state persistence
│   ├── strategies/       # Arithmetic and geometric grid strategies
│   ├── types/            # Shared TypeScript interfaces
│   └── utils/            # Logger, retry, formatting helpers
├── tests/                # Unit tests (Vitest)
├── .env.example          # Environment variable template
├── package.json
└── tsconfig.json

• Node.js 18 or higher
• npm 9 or higher
• Gate.io account with API key (for live trading only)

cd gateio-ai-grid-trading-bot
npm install
cp .env.example .env

Edit .env with your configuration:

GATE_API_KEY=your_api_key_here
GATE_API_SECRET=your_api_secret_here
SYMBOL=BTC_USDT
GRID_STRATEGY=auto
UPPER_PRICE=70000
LOWER_PRICE=60000
GRID_COUNT=20
INVESTMENT=1000
PAPER_TRADING=true
AI_ENABLED=true

npm run dev -- validate

npm run dev -- preview

npm run dev -- analyze

npm run dev -- start

Set PAPER_TRADING=false in .env, then:

npm run build
npm start -- start

npm test
npm run typecheck
npm run lint
npm run dev -- start

Enable AI_AUTO_RANGE=true to let the bot tune bounds from live Gate.io candle data.

Cryptocurrency trading involves substantial risk of loss. This bot is provided as-is with no guarantees of profitability. Always test thoroughly in paper trading mode before deploying real funds. Never invest more than you can afford to lose. The authors are not responsible for any financial losses incurred through use of this software.

MIT