diff --git a/README.md b/README.md index 345ad4e..57a88dc 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,123 @@ -# BrainDock Trading Bot V5 +# Trading Bot V0.2 — Adaptive Strategy Learning -Multi-crypto ML-powered trading bot with auto-exit strategies. +**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 -- - ML bot engine with signal detection -- - Binance API wrapper & order execution -- - Real-time monitoring dashboard -- - ML model definitions -- - Telegram alerts -## Live Trading -- Capital: $135+ USDT -- Symbols: BTC, ETH, SOL, BNB, XRP -- Exit Strategy: +1% TP, -3% SL, trail stops, auto-SWAP <$15 +### Files +- `src/main_ml.py`: Core trading bot (512 lines) +- `src/web_dashboard.py`: FastAPI dashboard (650+ lines) +- `README.md`: This file -## Status -✅ Production live 2026-07-04 +### 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.