# 🤖 Apollo Degen Bot V10

**Trading bot ultra-agressif pour ApolloX Finance avec leverage extrême (250x)**

## 📊 Performance

**Backtest (1500 candles BTC 1m):**
- Return: **+51.79%**
- Win Rate: **100%** (13/13 trades)
- Leverage: 200x-250x dynamique
- Stop-Loss: 0.5%
- Take-Profit: 1.75% (ratio 3.5:1)
- Pyramiding: +50% à +0.5%, +25% à +1.0%

## 🎯 Concept Clé: Stratégie Inverse

**Le secret de la stratégie V10:**

Au lieu de suivre les indicateurs classiques, on fait **l'INVERSE** dans les marchés en RANGE:
- Signal LONG classique → On SHORT
- Signal SHORT classique → On LONG

**Pourquoi ça marche?**
- En RANGE, le marché fait du mean reversion
- Les indicateurs de momentum donnent de faux signaux
- Inverser les signaux = fade les mauvaises entrées
- Résultat: 100% win rate sur période testée

**Conditions:**
- ✅ Trading **UNIQUEMENT** en régime RANGE
- ❌ **AUCUN** trading en TREND (uptrend/downtrend)
- ✅ Détection automatique du régime en temps réel

## 📁 Architecture

```
apollo_degen_bot/
├── config.py                              # Configuration centrale
├── apollo_client.py                       # Client API ApolloX
│
├── strategies/
│   └── inverse_strategy_v10.py           # Stratégie inverse optimisée
│
├── services/
│   ├── continuous_optimizer.py           # Optimisation paramètres 24/7
│   ├── market_intelligence.py            # Analyse marché temps réel
│   └── strategy_optimizer_service.py     # Service coordinateur
│
├── live_trader_v10.py                    # ⭐ Bot de trading (PAPER + LIVE)
├── monitor_live_trading.py               # Dashboard monitoring
├── emergency_close_all.py                # Script d'urgence
│
├── setup_api_keys.py                     # Configuration API
├── test_api_connection.py                # Test connexion
├── check_leverage_limits.py              # Vérification leverages
│
├── README.md                              # Ce fichier
├── README_V10.md                          # Doc détaillée stratégie
├── LIVE_TRADING_GUIDE.md                 # Guide complet live trading
├── SERVICES_README.md                    # Doc services d'optimisation
├── SETUP_API.md                          # Guide configuration API
└── ROADMAP_LIVE.md                       # Roadmap backtest → live
```

## 🚀 Quick Start

### 1. Installation

```bash
cd /var/www/html/HyperOracle/crypto_trader/apollo_degen_bot

# Installer dépendances
pip install apollox-connector-python pandas numpy ta-lib

# Vérifier installation
python3 -c "from apollox.rest_api import Client; print('✅ apollox OK')"
```

### 2. Configuration API

```bash
# Setup interactif
python3 setup_api_keys.py

# Tester connexion
python3 test_api_connection.py

# Vérifier leverages disponibles
python3 check_leverage_limits.py
```

**Guide complet:** `SETUP_API.md`

### 3. Paper Trading (Sans Risque)

```bash
# Terminal 1: Démarrer bot en mode PAPER
python3 live_trader_v10.py
# Choisir: PAPER

# Terminal 2: Dashboard monitoring
python3 monitor_live_trading.py
```

**Laisser tourner 24-72h pour validation.**

### 4. Live Trading (Argent Réel)

```bash
# ⚠️ ATTENTION: Trading réel!
python3 live_trader_v10.py
# Choisir: LIVE
# Confirmer: yes
```

**⚠️ LISEZ `LIVE_TRADING_GUIDE.md` AVANT!**

## 🎮 Modes de Trading

### PAPER Mode
- Simulation complète sans ordres réels
- Prix en temps réel
- Tracking performance
- **Risque: ZÉRO**

### LIVE Mode
- Trading avec argent réel
- Ordres sur ApolloX
- Leverage jusqu'à 250x
- **Risque: EXTRÊME**

## 🔧 Configuration

### Marchés Tradés

Par défaut: **BTC, ETH, SOL, BNB**

```python
# config.py
MAJOR_MARKETS = {
    'BTC': 'BTCUSDT',
    'ETH': 'ETHUSDT',
    'SOL': 'SOLUSDT',
    'BNB': 'BNBUSDT'
}
```

### Leverage Dynamique

```python
# config.py - V10_LEVERAGE_MAP
'PERFECT': 250,     # Score 1.0 + 4 confluences
'EXCELLENT': 225,   # Score 1.0 OU 4 confluences
'VERY_GOOD': 200,   # Score 0.95+
'GOOD': 200         # Score 0.90+
```

### Risk Management

```python
# Stop-Loss optimisés
STOP_LOSS_PCT = {
    250: 0.005,  # 0.5% pour 250x
}

# Take-Profit optimisé
TAKE_PROFIT_RATIO = 3.5  # 1.75% TP (ratio 3.5:1)

# Pyramiding
V10_PYRAMID_LEVEL_1 = 0.005  # +50% à +0.5%
V10_PYRAMID_LEVEL_2 = 0.010  # +25% à +1.0%
```

## 📊 Services d'Optimisation

### Service d'Optimisation Continue

Teste automatiquement des milliers de combinaisons de paramètres en background:

```bash
python3 services/strategy_optimizer_service.py
```

**Features:**
- Teste 20 combinaisons toutes les 5 minutes
- Optimise SL, TP, leverage, timeframes, indicateurs
- Génère recommandations en JSON
- S'adapte automatiquement aux conditions

**Guide complet:** `SERVICES_README.md`

### Market Intelligence

Analyse le marché en temps réel:

```bash
python3 services/market_intelligence.py
```

**Analyse:**
- Régime (RANGE/TREND)
- Volatilité (LOW/NORMAL/HIGH/EXTREME)
- Position dans le range (BOTTOM/MIDDLE/TOP)
- Momentum (BULLISH/NEUTRAL/BEARISH)
- Signaux actionnables

## 📈 Monitoring

### Dashboard Temps Réel

```bash
python3 monitor_live_trading.py
```

**Affiche:**
- Mode (PAPER/LIVE)
- Statistiques globales (trades, win rate, PnL)
- Positions actives avec PnL en temps réel
- Historique des 10 derniers trades
- Rafraîchissement auto toutes les 5s

### Fichiers de Tracking

```bash
# État actuel
cat live_trading_data/current_state.json

# Historique des trades
cat live_trading_data/trades_history.json
```

## 🚨 Sécurité

### Script d'Urgence

Ferme toutes les positions immédiatement:

```bash
python3 emergency_close_all.py
# Taper 'CLOSE ALL' pour confirmer
```

### Best Practices

1. **Toujours tester en PAPER d'abord** (24-72h minimum)
2. **Commencer avec petit capital** ($50-$100 max)
3. **Ne pas trader plus que vous pouvez perdre**
4. **Monitorer en permanence** (dashboard ouvert)
5. **Avoir un plan d'arrêt** (-10% max loss, 3 losses consécutives)

### Configuration Conservatrice

Pour réduire les risques:

```python
# live_trader_v10.py
self.max_positions = 1  # Au lieu de 5

# config.py
V10_LEVERAGE_MAP = {
    'PERFECT': 100,  # Au lieu de 250
    'EXCELLENT': 75,
    'VERY_GOOD': 50,
    'GOOD': 50
}

STOP_LOSS_PCT = {
    100: 0.008,  # 0.8% au lieu de 0.5%
}
```

## ⚠️ Risques

**Le trading avec leverage extrême (250x) est EXTRÊMEMENT RISQUÉ:**

- ❌ Vous pouvez perdre **TOUT** votre capital
- ❌ Une volatilité de 0.4% = liquidation
- ❌ Slippage et fees peuvent impacter significativement
- ❌ Les performances passées ≠ performances futures
- ❌ Les conditions de marché changent constamment

**N'investissez QUE ce que vous pouvez vous permettre de perdre.**

## 📚 Documentation

### Guides Essentiels
- **`LIVE_TRADING_GUIDE.md`** - Guide complet de trading live (À LIRE!)
- **`README_V10.md`** - Documentation détaillée stratégie V10
- **`SETUP_API.md`** - Configuration des clés API
- **`ROADMAP_LIVE.md`** - Roadmap de backtest à live trading

### Documentation Services
- **`SERVICES_README.md`** - Services d'optimisation et intelligence

### Documentation Technique
- Code source commenté dans tous les fichiers
- Docstrings sur toutes les fonctions
- Logs détaillés en temps réel

## 🎯 Cas d'Usage

### 1. Paper Trading (Simulation)
```bash
# Tester la stratégie sans risque
python3 live_trader_v10.py  # PAPER mode
```

### 2. Micro Live Trading (Apprentissage)
```bash
# Premier trading réel avec $50-100
# Modifier config pour leverage conservateur
python3 live_trader_v10.py  # LIVE mode
```

### 3. Live Trading Standard (Production)
```bash
# Trading avec $500-1000
# Configuration optimale V10
python3 live_trader_v10.py  # LIVE mode
```

### 4. Optimisation Continue (Background)
```bash
# Optimiser paramètres 24/7
python3 services/strategy_optimizer_service.py
```

## 🔍 Troubleshooting

### Bot ne démarre pas
```bash
# Vérifier installation
pip install apollox-connector-python

# Vérifier API keys
python3 test_api_connection.py

# Vérifier balance
python3 -c "from apollo_client import ApolloDegenClient; print(ApolloDegenClient().get_balance())"
```

### Pas de signaux générés
- **Cause 1:** Marché en TREND (pas RANGE) → Normal, attendre retour en RANGE
- **Cause 2:** Confiance < 85% → Baisser seuil ou attendre meilleurs setups
- **Cause 3:** Max positions atteint → Attendre fermeture d'une position

### Ordres rejetés
- **Balance insuffisante:** Réduire leverage ou position size
- **Leverage invalide:** Vérifier max leverage du symbole
- **Slippage:** Utiliser ordres LIMIT au lieu de MARKET

**Troubleshooting complet:** `LIVE_TRADING_GUIDE.md`

## 📊 Statistiques

### Fréquence de Trading
- **~12 trades/jour** en moyenne
- **40 min** durée moyenne par trade
- **48 min** intervalle moyen entre trades

### Performance par Composante
```
Stratégie inverse basique:        +3.52%
+ Position sizing optimisé:        +12.80%
+ SL/TP optimisés:                 +28.80%
+ V10 (leverage + pyramiding):     +51.79%
```

### Amélioration vs Stratégies Classiques
```
Stratégies momentum classiques:    -3.44%
Stratégie inverse V10:             +51.79%
Amélioration totale:               +55.23 points
```

## 🤝 Support

### Questions Techniques
- Consulter la documentation dans ce répertoire
- Vérifier les logs dans `live_trading_data/`
- Lire le code source (bien commenté)

### Issues ApolloX
- Docs: https://apollox-finance.gitbook.io
- Telegram: https://t.me/apollox_official
- Discord: https://discord.gg/apollox

## 🗺️ Roadmap

### ✅ Phase 1: Développement (COMPLET)
- Stratégie inverse V10
- Backtesting et optimisation
- Services d'intelligence

### ✅ Phase 2: Trading Live (COMPLET)
- Bot PAPER et LIVE modes
- Dashboard monitoring
- Risk management

### 🔜 Phase 3: Améliorations
- Alertes Telegram/Email
- Interface web
- Machine Learning

### 🔮 Phase 4: Scaling
- Multi-marchés simultanés
- Portfolio allocation
- Order flow analysis

**Roadmap détaillée:** `ROADMAP_LIVE.md`

## ⚡ TL;DR

```bash
# 1. Setup
python3 setup_api_keys.py

# 2. Test
python3 test_api_connection.py

# 3. Paper Trading
python3 live_trader_v10.py  # Choisir PAPER

# 4. Monitoring
python3 monitor_live_trading.py

# 5. Live (après 24-72h de paper trading réussi)
python3 live_trader_v10.py  # Choisir LIVE
```

**⚠️ Lisez `LIVE_TRADING_GUIDE.md` AVANT de trader en LIVE!**

---

## 📄 License

Usage personnel uniquement. Trading à vos propres risques.

---

*Apollo Degen Bot V10 - Production Ready*
*Dernière mise à jour: 2025-10-16*
*"In range markets, we trust. In trends, we rest."*