A production-quality Python grid-trading bot that adapts grid range and spacing based on ATR, applies a trend-regime filter (ADX + EMA), and supports both arithmetic and geometric spacing. Runs on spot markets via ccxt with optional WebSocket price streaming, paper and live modes, a built-in backtester, and an optional Streamlit dashboard.

Features:
- ATR-based dynamic range & spacing — grid bounds scale with volatility (center ± ATR × range_mult). - Arithmetic & geometric grid modes — equal absolute steps or equal percentage steps. - ADX/EMA trend-regime filter — the grid only deploys when ADX < threshold (ranging market); optionally requires price to be near a long EMA. - Automatic grid recentering — when price drifts beyond a configurable threshold or exits the range, the grid is rebuilt around the new price. - Stop-loss & risk manager — hard stop below lower − ATR × stop_mult, max loss, daily loss limit, max drawdown, position caps. - Paper & live modes — simulated order book for paper trading; real ccxt orders for live. - WebSocket support — real-time ticker streaming (Binance, Bybit, OKX) with automatic reconnection. - SQLite persistence — all orders and trades logged for auditability. - Backtester — bar-by-bar historical replay using the same grid/risk/regime logic as live. - Streamlit dashboard — live grid visualization, equity curve, PnL, and trade log.

---
*Trading software carries risk of financial loss. Always run in paper/testnet mode first. Source code as-is.*