# 🤖 Guide de Trading Live V10

## 📋 Table des Matières

1. [Vue d'ensemble](#vue-densemble)
2. [Modes de trading](#modes-de-trading)
3. [Configuration et démarrage](#configuration-et-démarrage)
4. [Utilisation](#utilisation)
5. [Monitoring](#monitoring)
6. [Gestion des positions](#gestion-des-positions)
7. [Sécurité et best practices](#sécurité-et-best-practices)
8. [Troubleshooting](#troubleshooting)

---

## 🎯 Vue d'Ensemble

Le **Live Trader V10** est le moteur d'exécution en temps réel de la stratégie inverse V10. Il:

- ✅ Génère des signaux toutes les 10 secondes
- ✅ Ouvre automatiquement des positions sur les meilleurs signaux
- ✅ Gère le pyramiding (ajout sur positions gagnantes)
- ✅ Place et gère stop-loss et take-profit automatiquement
- ✅ Supporte jusqu'à 5 positions simultanées
- ✅ Track performance en temps réel
- ✅ Sauvegarde l'état toutes les minutes

**Performance backtestée:**
- Return: +51.79%
- Win rate: 100% (13/13 trades)
- Leverage: 200x-250x dynamique
- SL: 0.5% | TP: 1.75% (ratio 3.5:1)

---

## 🎮 Modes de Trading

### 1. PAPER MODE (Recommandé pour débuter)

**C'est quoi?**
- Simule le trading sans placer d'ordres réels
- Utilise les prix réels et génère les signaux normalement
- Aucun risque financier
- Parfait pour tester et se familiariser

**Quand l'utiliser?**
- ✅ Première utilisation du bot
- ✅ Test après modifications de config
- ✅ Validation sur conditions de marché actuelles
- ✅ Formation et apprentissage

**Démarrage:**
```bash
python3 live_trader_v10.py
# Choisir: PAPER
```

### 2. LIVE MODE (Trading réel)

**C'est quoi?**
- Trading avec argent réel
- Place de vrais ordres sur ApolloX
- Risque financier réel
- Leverage jusqu'à 250x

**Quand l'utiliser?**
- ✅ Après avoir testé en PAPER avec succès
- ✅ API keys configurées et testées
- ✅ Balance suffisante (min $100)
- ✅ Compréhension complète des risques

**Démarrage:**
```bash
python3 live_trader_v10.py
# Choisir: LIVE
# Confirmer avec 'yes'
```

---

## ⚙️ Configuration et Démarrage

### Étape 1: Configurer les API Keys

**Si pas encore fait:**
```bash
python3 setup_api_keys.py
```

Suivre le guide: `SETUP_API.md`

### Étape 2: Vérifier la Configuration

Ouvrir `config.py` et vérifier:

```python
# Marchés à trader
MAJOR_MARKETS = {
    'BTC': 'BTCUSDT',
    'ETH': 'ETHUSDT',
    'SOL': 'SOLUSDT',
    'BNB': 'BNBUSDT'
}

# V10 Leverage dynamique (optimal)
V10_LEVERAGE_MAP = {
    'PERFECT': 250,    # Signaux parfaits
    'EXCELLENT': 225,  # Excellents signaux
    'VERY_GOOD': 200,  # Très bons signaux
    'GOOD': 200        # Bons signaux
}

# 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
```

### Étape 3: Lancer le Bot

**Mode PAPER (sans risque):**
```bash
cd apollo_degen_bot
python3 live_trader_v10.py
```

Répondre `PAPER` au prompt.

**Mode LIVE (avec risque):**
```bash
python3 live_trader_v10.py
```

Répondre `LIVE` puis confirmer avec `yes`.

---

## 📊 Utilisation

### Cycle de Trading

Le bot fonctionne en boucle continue:

```
1. Mettre à jour positions existantes (calcul PnL)
   ↓
2. Chercher nouveaux signaux sur BTC/ETH/SOL/BNB
   ↓
3. Ouvrir positions si signal ≥ 85% confiance
   ↓
4. Gérer pyramiding (ajouter à +0.5% et +1.0%)
   ↓
5. Vérifier stop-loss et take-profit
   ↓
6. Afficher résumé et sauvegarder état
   ↓
7. Sleep 10 secondes
   ↓
8. Répéter
```

### Ouverture de Position

Le bot ouvre automatiquement une position quand:

1. **Signal détecté** avec confiance ≥ 85%
2. **Régime RANGE** confirmé (pas de trading en TREND)
3. **Moins de 5 positions** actives
4. **Balance suffisante** (min $100)

**Exemple de log:**
```
🎯 SIGNAL: SHORT BTCUSDT (conf: 90%, lev: 225x)
💰 Position: $50.00 risk → 0.022 BTCUSDT @ $95000.00
✅ Position ouverte: SHORT 0.022 BTCUSDT @ $95000.00
   SL: $95475.00 | TP: $93337.50 | Leverage: 225x
```

### Pyramiding

Le bot ajoute automatiquement à une position gagnante:

- **Niveau 1**: À +0.5% profit → Ajoute +50% de la position initiale
- **Niveau 2**: À +1.0% profit → Ajoute +25% de la position initiale

**Exemple:**
```
Position initiale: 0.020 BTC
À +0.5%: Ajoute 0.010 BTC (total: 0.030 BTC)
À +1.0%: Ajoute 0.005 BTC (total: 0.035 BTC)
```

### Fermeture de Position

Fermeture automatique quand:

1. **Stop-loss hit**: Prix atteint -0.5% (pour 250x)
2. **Take-profit hit**: Prix atteint +1.75% (ratio 3.5:1)
3. **Signal inverse fort**: Retournement de marché détecté

---

## 📈 Monitoring

### Dashboard Temps Réel

Ouvrir un second terminal:

```bash
python3 monitor_live_trading.py
```

Le dashboard affiche:
- Mode de trading (PAPER/LIVE)
- Statistiques globales (trades, win rate, PnL)
- Positions actives avec PnL en temps réel
- Historique des 10 derniers trades
- Rafraîchissement automatique toutes les 5s

**Exemple de dashboard:**
```
🤖 APOLLO DEGEN BOT V10 - LIVE TRADING DASHBOARD
================================================================================
📝 Mode: PAPER | Dernière mise à jour: 15s ago

📊 STATISTIQUES GLOBALES
================================================================================
Total trades:  8
Wins:          7
Losses:        1
Win rate:      87.5%
Total PnL:     🟢 $+245.50

💼 POSITIONS ACTIVES (2)
================================================================================
Symbol       Side   Lev   Entry      Quantity    PnL %      PnL $        SL         TP
BTCUSDT      📉SHORT 225x  $95000.00  0.0220     🟢+0.85%  $+181.50    $95475.00  $93337.50
ETHUSDT      📈LONG  200x  $2500.00   0.4000     🟢+0.35%  $+70.00     $2487.50   $2543.75
--------------------------------------------------------------------------------
TOTAL ACTIF                                      +0.60% avg | $+251.50 total
```

### Logs du Bot

Le bot affiche des logs détaillés en continu:

```bash
# Logs dans le terminal principal
🔄 Cycle #42 - 14:23:15
📊 Mise à jour 2 positions...
   BTCUSDT: SHORT @ $95000.00 → $94850.00 | PnL: +0.16% ($+36.00)
   ETHUSDT: LONG @ $2500.00 → $2508.75 | PnL: +0.35% ($+70.00)

🔍 Recherche nouveaux signaux...
🎯 SIGNAL: LONG SOLUSDT (conf: 88%, lev: 225x)
💰 Position: $45.00 risk → 2.25 SOLUSDT @ $20.00
✅ Position ouverte: LONG 2.25 SOLUSDT @ $20.00

📊 RÉSUMÉ
==========================================================================
Positions actives: 3/5
Total trades: 9
Win rate: 88.9% (8W / 1L)
Total PnL: $+276.50
```

### Fichiers de Données

Le bot sauvegarde l'état dans `live_trading_data/`:

```bash
# État actuel (mis à jour toutes les minutes)
cat live_trading_data/current_state.json

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

---

## 🎮 Gestion des Positions

### Fermer Toutes les Positions

**Dans le code (mode interactif):**

```python
from live_trader_v10 import LiveTraderV10

trader = LiveTraderV10(mode='LIVE')
trader.close_all_positions(reason='MANUAL')
```

**Ou arrêter le bot:**
- Ctrl+C arrête proprement le bot
- Les positions restent ouvertes sur ApolloX
- Fermer manuellement sur l'interface ApolloX si besoin

### Arrêt d'Urgence

1. **Arrêter le bot**: Ctrl+C
2. **Aller sur ApolloX**: https://www.apollox.finance
3. **Fermer positions manuellement** si nécessaire
4. **Annuler ordres pendants** (SL/TP)

### Modifier les Limites

Éditer `live_trader_v10.py`:

```python
class LiveTraderV10:
    def __init__(self, ...):
        # Modifier ces paramètres
        self.max_positions = 5    # Max positions simultanées
        self.min_balance = 100    # Balance minimum pour trader
        self.check_interval = 10  # Secondes entre chaque check
```

---

## 🔒 Sécurité et Best Practices

### ⚠️ 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 ne garantissent pas les futures
- ❌ Les conditions de marché changent constamment

### ✅ RÈGLES DE SÉCURITÉ

1. **Toujours tester en PAPER d'abord**
   - Minimum 24h de paper trading
   - Vérifier win rate ≥ 70% avant LIVE

2. **Commencer petit en LIVE**
   - Balance initiale max $200-500
   - Pas plus que ce que vous pouvez perdre
   - Augmenter progressivement si profitable

3. **Configurer des limites**
   ```python
   self.max_positions = 3  # Commencer avec 3 max au lieu de 5
   self.min_balance = 150  # Arrêter si balance < $150
   ```

4. **Monitorer en permanence**
   - Toujours avoir le dashboard ouvert
   - Vérifier les positions régulièrement
   - Ne pas laisser tourner sans surveillance prolongée

5. **Avoir un plan d'arrêt**
   - Stop si perte > -10% du capital
   - Stop si 3 losses consécutives
   - Stop si comportement anormal du bot

6. **Sauvegarder les credentials**
   - Ne jamais commit les API keys
   - Utiliser `.env` ou variables d'environnement
   - Révoquer les keys si exposées

### 🎯 Configuration Conservatrice

Pour trading plus safe, modifier `config.py`:

```python
# Leverage plus conservateur
V10_LEVERAGE_MAP = {
    'PERFECT': 150,    # Au lieu de 250
    'EXCELLENT': 125,  # Au lieu de 225
    'VERY_GOOD': 100,  # Au lieu de 200
    'GOOD': 100
}

# SL plus large
STOP_LOSS_PCT = {
    150: 0.008,  # 0.8% au lieu de 0.5%
}

# Confiance minimale plus haute
MIN_SIGNAL_SCORE_AGGRESSIVE = 0.90  # 90% au lieu de 85%
```

---

## 🔧 Troubleshooting

### Problème: Bot ne démarre pas

**Erreur: "API keys non configurées"**
```bash
# Solution:
python3 setup_api_keys.py
```

**Erreur: "Balance insuffisante"**
- Vérifier balance sur ApolloX
- Balance minimum: $100
- Déposer plus de fonds si nécessaire

**Erreur: "ModuleNotFoundError: apollox"**
```bash
# Solution:
pip install apollox-connector-python
```

### Problème: Pas de signaux générés

**Raisons possibles:**
1. **Marché en TREND** (pas RANGE)
   - Solution: Attendre retour en RANGE
   - Le bot ne trade QUE en régime RANGE

2. **Confiance < 85%**
   - Solution: Baisser le seuil dans config.py
   - Ou attendre meilleurs setups

3. **Max positions atteint**
   - Solution: Attendre fermeture d'une position
   - Ou augmenter max_positions

### Problème: Ordres rejetés

**Erreur: "Insufficient balance"**
- Balance trop faible pour le leverage
- Réduire leverage ou position size

**Erreur: "Invalid leverage"**
- Vérifier max leverage du symbole
- BTC/ETH: 250x max sur V2 Classic
- Autres: peut-être 100x max

**Erreur: "Price exceeded limit"**
- Slippage trop important
- Utiliser ordres LIMIT au lieu de MARKET

### Problème: Stop-loss ne se déclenche pas

**Raisons:**
1. Ordres SL pas placés (erreur)
   - Vérifier logs d'erreur
   - Placer manuellement sur ApolloX

2. Prix a gap over le SL
   - Le SL STOP_MARKET s'exécute au prix du marché
   - Peut y avoir slippage

### Problème: Performance différente du backtest

**Normal et attendu:**
- Slippage réel vs simulation
- Fees plus importants avec pyramiding
- Conditions de marché différentes
- Latence d'exécution

**Actions:**
1. Comparer sur même période que backtest
2. Vérifier que les signaux sont identiques
3. Analyser les trades fermés (win rate, avg PnL)
4. Ajuster si win rate < 70%

---

## 📚 Références

**Fichiers:**
- `live_trader_v10.py` - Moteur de trading live
- `monitor_live_trading.py` - Dashboard de monitoring
- `config.py` - Configuration
- `strategies/inverse_strategy_v10.py` - Stratégie V10
- `apollo_client.py` - Client ApolloX

**Documentation:**
- `README_V10.md` - Stratégie V10 détaillée
- `SERVICES_README.md` - Services d'optimisation
- `SETUP_API.md` - Configuration API
- `ROADMAP_LIVE.md` - Roadmap vers live trading

**Support:**
- Issues: Créer issue sur GitHub
- Logs: Consulter `live_trading_data/` et logs console

---

## ⚡ Quick Start

```bash
# 1. Configuration API (si pas fait)
python3 setup_api_keys.py

# 2. Test en PAPER mode
python3 live_trader_v10.py
# Choisir: PAPER

# 3. Monitoring (autre terminal)
python3 monitor_live_trading.py

# 4. Après 24h de paper trading réussi → LIVE
python3 live_trader_v10.py
# Choisir: LIVE
# Confirmer: yes
```

**⚠️ N'oubliez jamais: Trading avec leverage = RISQUE EXTRÊME**

---

*Guide créé pour Apollo Degen Bot V10*
*Dernière mise à jour: 2025-10-16*