# 🔑 Configuration des Clés API ApolloX

## 📋 Prérequis

1. **Compte ApolloX**
   - Créer un compte sur https://www.apollox.finance
   - Compléter KYC si nécessaire
   - Activer 2FA (recommandé)

2. **Dépôt Initial**
   - Minimum recommandé: **$50-$100** pour débuter
   - Pour 250x leverage avec notre stratégie

---

## 🔐 Obtenir les Clés API

### Étape 1: Se connecter à ApolloX

1. Aller sur https://www.apollox.finance
2. Se connecter à votre compte
3. Aller dans **Account → API Management**

### Étape 2: Créer une API Key

1. Cliquer sur **Create API**
2. Nommer la clé (ex: "Apollo_Degen_Bot")
3. **⚠️ IMPORTANT - Permissions à activer:**
   ```
   ✅ Enable Reading          (Lecture des données)
   ✅ Enable Spot & Margin Trading  (Trading futures)
   ❌ Enable Withdrawals      (PAS DE RETRAIT - sécurité)
   ```

4. Configurer **IP Whitelist** (Recommandé):
   ```bash
   # Trouver votre IP
   curl ifconfig.me

   # Ajouter cette IP dans la whitelist ApolloX
   ```

5. **Sauvegarder les clés:**
   ```
   API Key:    xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   Secret Key: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
   ```

   ⚠️ **Le Secret Key n'est affiché qu'UNE FOIS!** Sauvegardez-le immédiatement.

---

## ⚙️ Configuration dans le Bot

### Méthode 1: Via config.py (Rapide)

Ouvrir `/var/www/html/HyperOracle/crypto_trader/apollo_degen_bot/config.py`:

```python
# ============ API CONFIGURATION ============
APOLLOX_API_BASE = "https://fapi.apollox.finance"
APOLLOX_WS_BASE = "wss://fstream.apollox.finance"

# ⚠️ NE JAMAIS COMMITER CES CLÉS DANS GIT!
APOLLOX_API_KEY = "votre_api_key_ici"
APOLLOX_API_SECRET = "votre_secret_key_ici"
```

**Sauvegarder et tester:**
```bash
python3 check_leverage_limits.py
```

### Méthode 2: Variables d'Environnement (Sécurisé)

**Créer un fichier .env:**
```bash
cat > .env << EOF
APOLLOX_API_KEY=votre_api_key_ici
APOLLOX_API_SECRET=votre_secret_key_ici
EOF

# Sécuriser le fichier
chmod 600 .env

# Ajouter au .gitignore
echo ".env" >> .gitignore
```

**Modifier apollo_client.py pour charger .env:**
```python
from dotenv import load_dotenv
import os

load_dotenv()

api_key = os.getenv('APOLLOX_API_KEY')
api_secret = os.getenv('APOLLOX_API_SECRET')
```

### Méthode 3: Setup Interactif (Recommandé)

```bash
python3 setup_api_keys.py
```

Ce script vous guidera pas à pas pour configurer vos clés de manière sécurisée.

---

## ✅ Vérification de la Configuration

### Test 1: Connexion API
```bash
python3 test_api_connection.py
```

Devrait afficher:
```
✅ Connexion API réussie
✅ Balance récupérée: $XX.XX USDT
✅ Positions ouvertes: 0
```

### Test 2: Vérification Leverage
```bash
python3 check_leverage_limits.py
```

Devrait afficher les leverages max pour chaque paire.

### Test 3: Test Order (Paper Trading)
```bash
# TODO: Créer ce script
python3 test_paper_order.py
```

---

## 🔒 Sécurité - TRÈS IMPORTANT

### ✅ À FAIRE

1. **IP Whitelist**: Autoriser uniquement votre IP serveur
2. **Permissions limitées**: Pas de withdrawals
3. **2FA activé**: Sur compte ApolloX
4. **Keys en .env**: Jamais hardcodées
5. **Backup keys**: Sauvegarder dans password manager
6. **Rotation régulière**: Changer clés tous les 3 mois

### ❌ À NE JAMAIS FAIRE

1. ❌ Commiter les clés dans Git
2. ❌ Partager les clés par email/chat
3. ❌ Activer withdrawals sur API
4. ❌ Utiliser sur WiFi public
5. ❌ Laisser clés en clair dans code

---

## 🚨 En Cas de Compromission

Si vous pensez que vos clés sont compromises:

1. **Immédiatement:**
   - Aller sur ApolloX → API Management
   - **Delete** la clé compromise
   - Créer une nouvelle clé

2. **Vérifier:**
   - Historique des trades récents
   - Positions ouvertes inattendues
   - Balance du compte

3. **Sécuriser:**
   - Changer mot de passe ApolloX
   - Réactiver 2FA si désactivé
   - Vérifier email de connexion

---

## 📊 Limites API ApolloX

### Rate Limits
```
Requêtes publiques:  2400/min
Requêtes privées:    1200/min
WebSocket:           10 connexions max
```

### Position Limits
```
V2 Classic (250x):
- Max positions: 200 par paire
- Max notional: Selon collateral

V2 Degen (1001x):
- Max positions: 50 par paire
- Max notional: Réduit
```

---

## 🎯 Prochaines Étapes

Après configuration des clés:

1. ✅ Tester connexion API
2. ✅ Vérifier leverages disponibles
3. ✅ Faire un petit test order (0.01 USDT)
4. ✅ Lancer paper trading pendant 24h
5. ✅ Passer en live avec $50-$100

---

## 💡 Conseils

### Capital de Départ

**Minimum:** $50
- 5-10 trades possibles
- Test de la stratégie
- Risk limité

**Recommandé:** $100-$500
- 10-50 trades
- Vrai test de performance
- Diversification possible

**Optimal:** $1000+
- 50+ trades
- Performance stable
- Peut tenir drawdowns

### Stratégie de Déploiement

```
Phase 1: $50    → 1 semaine  → Validation fonctionnement
Phase 2: $100   → 1 semaine  → Test performance
Phase 3: $500   → 2 semaines → Validation robustesse
Phase 4: $1000+ → Long terme → Production
```

---

## 📞 Support

**ApolloX Support:**
- Telegram: https://t.me/apollox_official
- Discord: https://discord.gg/apollox
- Email: support@apollox.finance

**Bot Issues:**
- GitHub Issues (si repo public)
- Logs dans `/var/log/apollo_degen_bot/`

---

*Dernière mise à jour: 2025-10-15*
*Version: V10 Production*