Guide d'installation

Prérequis

• Docker Desktop (uniquement requis si vous utilisez Redis)
• Un compte exchange pris en charge avec des clés API
• L’adresse IP publique de votre serveur (pour la liste blanche API)

Table des matières

1. Configuration du bot
2. Configuration des clés API
3. Configuration Redis
4. RedisMarketBridge
5. Exécution du bot
6. Dépannage
7. Intégration TradingView

1. Configuration du bot

Toute la configuration se fait via le configurateur en ligne.

1. Ouvrir : Configurateur
2. Sélectionner MagicTradeBot
3. Configurer :

Export des paramètres :

1. Cliquer sur Export All YAML
2. Décompresser le fichier
3. Remplacer le dossier /settings dans le projet

magictradebot/
├── settings/  ← remplacer
├── MagicTradeBot
├── MagicTradeBot.exe
└── .env

2. Configuration des clés API

🔐 Sécurité : Utilisez toujours des variables d’environnement. Ne stockez jamais les clés API dans des fichiers de configuration.

Liste blanche IP

curl ifconfig.me

Ajoutez cette IP à la liste blanche de votre exchange.

Utilisation de .env

BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret

⚠️ Ajoutez .env à .gitignore

3. Configuration Redis (Optionnel)

Requis uniquement si Redis est activé.

Lancer Redis via Docker

docker run -d \
--name magictradebot-redis \
-p 6379:6379 \
--restart unless-stopped \
redis:latest

Vérification

docker exec -it magictradebot-redis redis-cli ping

Résultat attendu : PONG

4. RedisMarketBridge

Ce composant envoie les données de marché en temps réel vers Redis.

⚠️ Exchange + paires + intervalles DOIVENT correspondre exactement à la configuration du bot

Étapes :

1. Configurer via le configurateur
2. Exporter le YAML
3. Remplacer adapters/redismarketbridge/settings

5. Exécution du bot

Ordre de démarrage

1. Démarrer Redis
2. Démarrer RedisMarketBridge
3. Attendre 2 minutes
4. Démarrer MagicTradeBot

Linux / macOS

chmod +x MagicTradeBot
./MagicTradeBot

Windows

MagicTradeBot.exe

💡 Lancez depuis le terminal pour voir les logs

6. Dépannage

Erreurs API

• Vérifier la liste blanche IP
• Vérifier les permissions
• Vérifier les variables d’environnement

Pas de données de marché

• Attendre 2 minutes après le démarrage de RedisMarketBridge
• Vérifier la cohérence de la configuration

Problèmes Redis

• Vérifier que Docker est en cours d’exécution
• Port 6379 ouvert

7. Intégration des signaux TradingView

MagicTradeBot prend en charge les signaux externes de TradingView via webhooks.

Fonctionnement

• TradingView envoie des alertes → webhook
• MagicTradeBot reçoit les signaux
• Le bot exécute les trades automatiquement

Étape 1 — Activer le webhook dans le bot

Dans la configuration du bot :

• Activer Signals → Webhook
• Copier l’URL du webhook

Exemple :

http://your-server:port/webhook

Étape 2 — Créer une alerte TradingView

1. Ouvrir un graphique TradingView
2. Ajouter un indicateur ou une stratégie
3. Cliquer sur Alert
4. Activer Webhook URL
5. Coller l’URL du webhook du bot

Étape 3 — Définir le message d’alerte

Exemple de payload JSON :

{
  "symbol": "BTCUSDT",
  "action": "buy",
  "price": "{{close}}",
  "time": "{{time}}"
}

Actions supportées

• buy
• sell
• close

Notes importantes

• Assurez-vous que le symbole correspond exactement à la configuration du bot
• Utilisez le bon alignement de timeframe
• Testez d’abord avec de petites positions

⚠️ Format de payload incorrect = signaux ignorés

Test

Vous pouvez simuler un webhook avec :

curl -X POST http://your-server/webhook \
-H "Content-Type: application/json" \
-d '{"symbol":"BTCUSDT","action":"buy"}'

✅ Si correctement configuré, le bot exécutera un trade

💡 Pour plus de détails, consultez la documentation officielle TradingView.