Skip to content

Grid Trading Bot

License: MIT CI codecov PyPI version

An open-source cryptocurrency grid trading bot implemented in Python. Backtest strategies on historical data, paper trade with sandbox APIs, or go live on real markets — all from a single, highly customizable configuration.

Key Features

  • Backtesting — Simulate grid strategies on historical OHLCV data (CSV or fetched via CCXT)
  • Paper Trading — Test against real market data using exchange sandbox APIs
  • Live Trading — Execute real trades with robust retry logic and circuit breakers
  • Multiple Strategies — Simple grid and hedged grid with arithmetic or geometric spacing
  • Risk Management — Configurable take-profit, stop-loss, and slippage controls
  • Performance Metrics — ROI, max drawdown, Sharpe ratio, and interactive Plotly charts
  • Real-time Monitoring — Grafana dashboards with Loki log aggregation
  • Multi-Exchange Support — Any exchange supported by CCXT

  • Quick Start — Install and run your first backtest in under 2 minutes

  • Configuration — Full reference for config.json parameters

  • Concepts — Understand grid trading strategies

  • Monitoring — Set up Grafana dashboards for live bots

  • Architecture — Explore the codebase design and patterns

  • Contributing — Help improve the project