# 📚 Exemples - Trading AI Secure

## 🎯 Vue d'ensemble

Ce dossier contient des exemples pratiques pour démarrer rapidement avec Trading AI Secure.

---

## 📁 Exemples Disponibles

### 1. simple_backtest.py

**Premier backtest simple**

Montre comment :
- Configurer le système
- Charger une stratégie
- Lancer un backtest
- Analyser les résultats

**Usage** :
```bash
python examples/simple_backtest.py
```

**Résultat attendu** :
```
============================================================
RÉSULTATS DU BACKTEST
============================================================

📈 PERFORMANCE
Return Total:           12.50%
Sharpe Ratio:            1.85
Max Drawdown:            8.20%

💼 TRADING
Total Trades:             125
Win Rate:               57.60%
Profit Factor:           1.45

============================================================
✅ STRATÉGIE VALIDE pour paper trading!
```

---

## 🚀 Exemples à Créer

### 2. multi_strategy_backtest.py (À créer)

Backtest avec plusieurs stratégies simultanées.

### 3. parameter_optimization.py (À créer)

Optimisation des paramètres avec Optuna.

### 4. walk_forward_analysis.py (À créer)

Walk-forward analysis pour éviter overfitting.

### 5. paper_trading_example.py (À créer)

Exemple de paper trading temps réel.

### 6. custom_strategy.py (À créer)

Comment créer une stratégie personnalisée.

---

## 📖 Guide d'Utilisation

### Prérequis

```bash
# Installer dépendances
pip install -r requirements.txt

# Configurer
cp config/*.example.yaml config/
# Éditer config/*.yaml
```

### Lancer un Exemple

```bash
# Exemple simple
python examples/simple_backtest.py

# Avec logs détaillés
python examples/simple_backtest.py --log-level DEBUG
```

---

## 🎓 Apprendre par l'Exemple

### Workflow Recommandé

1. **Commencer par simple_backtest.py**
   - Comprendre le flow de base
   - Voir les résultats

2. **Modifier les paramètres**
   - Changer la stratégie
   - Ajuster le capital
   - Tester différentes périodes

3. **Créer votre propre exemple**
   - Copier un exemple existant
   - Adapter à vos besoins

---

## 💡 Conseils

### Pour Débutants

✅ Commencer avec `simple_backtest.py`  
✅ Lire les commentaires dans le code  
✅ Expérimenter avec différents paramètres  
✅ Consulter la documentation complète  

### Pour Avancés

✅ Créer stratégies personnalisées  
✅ Optimiser paramètres  
✅ Combiner plusieurs stratégies  
✅ Implémenter walk-forward analysis  

---

## 🐛 Debugging

### Problèmes Courants

**Erreur : ModuleNotFoundError**
```bash
# Solution
pip install -r requirements.txt
```

**Erreur : Configuration manquante**
```bash
# Solution
cp config/*.example.yaml config/
```

**Backtest ne génère pas de trades**
```bash
# Vérifier :
1. Données suffisantes (> 100 barres)
2. Paramètres stratégie corrects
3. Logs pour voir les signaux
```

---

## 📚 Ressources

- [Documentation Complète](../docs/)
- [Guide Stratégies](../docs/STRATEGY_GUIDE.md)
- [Guide Backtesting](../docs/BACKTESTING_GUIDE.md)
- [API Reference](../docs/API_REFERENCE.md)

---

**Bon apprentissage ! 🚀**