Reynov Christian 78737b6835 Refactor and update bot management and routing
- Update `.gitignore` to include `lab/` for backtesting and raw data.
- Refactor `app.py` to improve error handling and logging.
- Remove deprecated files: `core/bot_logic.py`, `core/bots/base_bot.py`, `core/bots/manager.py`, `core/db/database.py`, `core/routes/api_analysis.py`, `core/routes/api_bots_analysis.py`, `core/strategies/logic_ma.py`, `core/strategies/logic_rsi.py`.
- Modify multiple files to enhance bot management, routing, and strategy handling.
- Update JavaScript and HTML templates for better UI and functionality.
2025-07-31 21:33:44 +08:00

📄 README.md for QuantumBotX

# 🤖 QuantumBotX — AI-Powered Modular Trading Bot for MT5

Welcome to **QuantumBotX**, your personal, modular, and smart trading assistant built with 💖 using Python and MetaTrader5 (MT5).  
Designed to be elegant, powerful, and flexible — whether you're a scalper, swing trader, or a strategy researcher.

---

## 🚀 Features

- ✅ Modular Strategy System (`MA_CROSSOVER`, `RSI_POP`, and more)
- ✅ Real-Time Price & RSI Analysis (with beautiful Chart.js dashboard)
- ✅ Auto Position Handling (entry, exit, stop loss, take profit)
- ✅ Logging to SQLite (`trade_history`, `notifications`)
- ✅ Dashboard UI built with Flask + TailwindCSS
- ✅ Multiple Timeframes supported
- ✅ Ready for Live or Demo accounts

---

## 📦 Tech Stack

- `Python 3.10+`
- `Flask`
- `MetaTrader5 (MetaQuotes)`
- `pandas + pandas_ta`
- `Chart.js`
- `SQLite`
- *(Optional APIs: Alpha Vantage, CMC, Finnhub  deprecated soon)*

---

## 🧠 Strategy Examples

| Strategy        | Description                             |
|------------------|-----------------------------------------|
| `MA_CROSSOVER`   | Classic Golden/Death Cross with filter  |
| `RSI_POP`        | RSI Breakout based momentum scalping    |
| `MACD_STOCH_FILTER` | Advanced filtered entry (coming soon)  |

---

## 🔐 Environment Variables (`.env`)

Rename `.env.example``.env`, and fill in the following:

```env
MT5_LOGIN="your_mt5_login"
MT5_PASSWORD="your_password"
MT5_SERVER=MetaQuotes-Demo
SECRET_KEY="any_flask_secret_key"
DB_NAME=bots.db

You can ignore:

ALPHA_VANTAGE_KEY=
CMC_API_KEY=
FINNHUB_KEY=

These APIs will be removed in future versions.


🧪 Local Setup (Dev Mode)

git clone https://github.com/rebarakaz/quantumbotx.git
cd quantumbotx
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python app.py

You must have MetaTrader 5 installed and configured locally.


📈 Screenshot

QuantumBotX Dashboard Preview


🧠 Author

Developed with 💖 by Chrisnov IT Solutions Concept, Logic & Execution: @reynov aka BabyDev


Support This Project

If you like this project, give it a on GitHub, or buy me a coffee to support future versions:

BTC Wallet: bc1qxxxxxxxxxxxxxx
USDT TRC20: TRxxxxxxxxxxxx

📝 License

MIT — feel free to fork, build on top, or deploy your own!

Languages
Python 65.8%
HTML 17.1%
JavaScript 16.6%
NSIS 0.4%