124 lines
3.2 KiB
Markdown
124 lines
3.2 KiB
Markdown
# Trading Bot V0.2 — Adaptive Strategy Learning
|
||
|
||
**Production-ready Crypto Trading Bot with Live P&L Dashboard**
|
||
|
||
## Features
|
||
|
||
### ✅ Core Trading
|
||
- **Adaptive Signal Generation**: Win-rate based strategy adjustment (5 levels)
|
||
- **Risk Management**: Stop Loss (-1.8%), Take Profit (+2.8%), Daily Loss Limit (-5%)
|
||
- **Smart Position Sizing**: Dynamic investment (50-55%) based on signal confidence
|
||
- **Trailing Stop**: +1.5% entry, 0.6% trail distance
|
||
- **Cooldown Protection**: 30min pause after 3 consecutive losses
|
||
|
||
### ✅ Adaptive Learning (Option 2)
|
||
- **Hourly Strategy Evaluation**: Automatically adjusts based on win rate
|
||
- **5 Strategy Levels**:
|
||
- 🚨 Emergency (<45% WR): Strict signals, minimal trades
|
||
- ⚠️ Conservative (45-50%): Reduced risk
|
||
- ✅ Standard (50-60%): Default settings
|
||
- 🟢 Aggressive (60-70%): Increased signal frequency
|
||
- 🔥 Full Throttle (>70%): Maximum trading
|
||
|
||
### ✅ Monitoring & Reporting
|
||
- **Live P&L Dashboard**: Real-time portfolio value, profit/loss, holdings
|
||
- **Performance Reports**: 3-hour summaries via Telegram
|
||
- **Telegram Alerts**: Strategy changes, trade notifications
|
||
|
||
## Architecture
|
||
|
||
### Files
|
||
- `src/main_ml.py`: Core trading bot (512 lines)
|
||
- `src/web_dashboard.py`: FastAPI dashboard (650+ lines)
|
||
- `README.md`: This file
|
||
|
||
### Endpoints
|
||
- **Bot**: Runs async trading cycle (5s loop)
|
||
- **Dashboard**: http://localhost:7000 (HTML) + `/api/state` (JSON)
|
||
- **Telegram**: Real-time alerts
|
||
|
||
## Configuration
|
||
|
||
### Strategy Parameters (Adaptive)
|
||
```python
|
||
SIGNAL_THRESHOLD: 5-10%
|
||
INVESTMENT_PERCENT: 50-55%
|
||
TAKE_PROFIT_PERCENT: 1.5-3.5%
|
||
STOP_LOSS_PERCENT: 1.0-2.2%
|
||
MAX_TRADES_PER_DAY: 5-25
|
||
MAX_OPEN_POSITIONS: 1-2
|
||
```
|
||
|
||
### Risk Controls
|
||
- Daily Loss Limit: -5%
|
||
- Max 3 consecutive losses → 30min cooldown
|
||
- Min notional: $5.00 per order
|
||
- Slippage buffer: PRICE_FILTER rounding
|
||
|
||
## Usage
|
||
|
||
### Start Bot
|
||
```bash
|
||
cd src
|
||
python3 main_ml.py
|
||
```
|
||
|
||
### Start Dashboard
|
||
```bash
|
||
cd src
|
||
uvicorn web_dashboard:app --host 0.0.0.0 --port 7000
|
||
```
|
||
|
||
### View Dashboard
|
||
```
|
||
http://bot.bizmark.cloud
|
||
```
|
||
|
||
## Performance
|
||
|
||
### Current State (2026-07-07)
|
||
- **Portfolio**: $135.99 USD
|
||
- **P&L**: -$1.83 (-1.3%)
|
||
- **Open Positions**: 1 (XRP 6.7 @ $1.15)
|
||
- **Status**: 🟢 LIVE
|
||
|
||
### Historical
|
||
- Total Trades: 10+
|
||
- Win Rate: 45-55% (adaptive mode active)
|
||
- Largest Win: +2.8% (TP hit)
|
||
- Largest Loss: -1.8% (SL hit)
|
||
|
||
## Version History
|
||
|
||
### V0.2 (Current) — 2026-07-07
|
||
- ✅ Adaptive strategy learning (Option 2)
|
||
- ✅ Live P&L dashboard integration
|
||
- ✅ 10s refresh rate (optimized)
|
||
- ✅ Hourly strategy evaluation
|
||
- ✅ Code cleanup (removed V5/V10 labels)
|
||
|
||
### V0.1 (Previous)
|
||
- Static strategy (7.5% signal, 50% investment)
|
||
- Basic P&L cart add reporting
|
||
|
||
## Troubleshooting
|
||
|
||
### Dashboard shows stale P&L?
|
||
- Check `/api/state` endpoint returns new data
|
||
- Verify bot is running (`systemctl status trading-bot`)
|
||
- Refresh page (clears 10s cache)
|
||
|
||
### Bot not trading?
|
||
- Check daily loss limit (-5% limit may be hit)
|
||
- Verify Binance API key has trading permission
|
||
- Check MIN_NOTIONAL ($5.00 minimum per order)
|
||
|
||
### Strategy not adapting?
|
||
- Need minimum 5 trades to trigger adaptation
|
||
- Strategy updates every hour (check logs)
|
||
- Win rate must be >5% points away to trigger new mode
|
||
|
||
## License
|
||
|
||
All trades at your own risk. Crypto is volatile.
|