Quels paramètres doivent être configurés avant de lancer MagicTradeBot pour la première fois ?

Guide de configuration initiale

Avant de lancer MagicTradeBot pour la première fois, un petit ensemble de paramètres obligatoires et recommandés doit être configuré pour garantir que le bot démarre correctement, se connecte de manière sécurisée à votre exchange et fonctionne sans erreur.

MagicTradeBot est conçu avec des paramètres par défaut sûrs, vous n'avez donc pas besoin de configurer tous les fichiers au préalable. Les étapes ci-dessous couvrent la configuration minimale requise et recommandée pour un premier démarrage réussi.

1. Configurer l'exchange dans application.yaml

Vous devez spécifier à quel exchange MagicTradeBot se connectera.

Exchange:
  Name: "bybit"

Exchanges pris en charge :

Binance
Bybit
OKX
Bitget
Hyperliquid

⚠️ Important : Chaque exchange a des exigences strictes en matière de mode de position (One-Way vs Hedge). Assurez-vous que votre compte exchange est configuré en conséquence avant d'exécuter le bot.

2. Définir les identifiants API de l'échange (obligatoire)

MagicTradeBot a besoin d'un accès API pour placer et gérer les transactions.

Méthode recommandée : Variables d'environnement (bonne pratique)

L'utilisation de variables d'environnement est fortement recommandée, en particulier pour la production, car :

Les clés API ne sont pas stockées dans des fichiers
Les clés sont plus sûres et plus faciles à renouveler
Les variables d'environnement remplacent automatiquement les valeurs YAML

Configuration des variables d'environnement par système d'exploitation

✅ Windows (PowerShell)

setx BINANCE_API_KEY "votre_clé_api_ici"
setx BINANCE_API_SECRET "votre_secret_api_ici"

Redémarrez le terminal (ou le système) après avoir défini les variables.

✅ Linux / macOS (Terminal)

export BINANCE_API_KEY="votre_clé_api_ici"
export BINANCE_API_SECRET="votre_secret_api_ici"

Pour les rendre permanentes, ajoutez les lignes à :

~/.bashrc
~/.zshrc
Votre fichier de profil shell

✅ Docker / Docker Compose

environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

Noms de variables d'environnement pris en charge

Exemples :

BINANCE_API_KEY, BINANCE_API_SECRET
BYBIT_API_KEY, BYBIT_API_SECRET
OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE
BITGET_API_KEY, BITGET_API_SECRET, BITGET_PASSPHRASE
HYPERLIQUID_PRIVATE_KEY

🔐 N'activez jamais les permissions de retrait sur les clés API.

3. Fournir votre clé de licence

Dans application.yaml :

License:
  Key: "votre_clé_de_licence_ici"

Comment obtenir votre clé de licence

Connectez-vous à https://magictradebot.com
Allez dans Téléchargements
Copiez votre clé de licence

Remarques importantes

Le bot peut fonctionner sans licence
Cependant, les fonctionnalités seront limitées
La validation de la licence a lieu au démarrage

4. Examiner les paramètres de trading de base (trading.yaml)

Pour les nouveaux utilisateurs, ce fichier ne nécessite pas de modifications obligatoires.

Vous pouvez éventuellement examiner ou ajuster :

Le montant de trading initial
L'effet de levier par défaut
Les limites de risque

En cas de doute, laissez les valeurs par défaut — elles sont sûres pour les premiers lancements et le mode démo.

5. Configuration initiale des symboles et de l'effet de levier (très important)

Étape 1 : Activer la synchronisation des symboles (premier lancement uniquement)

Dans trading.yaml (ou le fichier de configuration des symboles) :

SyncSymbolsOnStartup: true

Cela va :

Récupérer tous les symboles pris en charge depuis l'exchange
Créer ou mettre à jour symbols.json
Supprimer les symboles retirés de la cote
Ajouter les symboles nouvellement listés

➡️ Lancez le bot et attendez la fin de la synchronisation des symboles
➡️ Surveillez le fichier symbols.json
➡️ Arrêtez le bot une fois la synchronisation terminée

Étape 2 : Désactiver la synchronisation des symboles (optionnel)

Après la première synchronisation, vous pouvez définir :

SyncSymbolsOnStartup: false

Si vous souhaitez des mises à jour automatiques des symboles, gardez-le sur true en permanence.

Étape 3 : Configuration unique de l'effet de levier (optionnelle mais recommandée)

Si vous voulez que MagicTradeBot configure l'effet de levier automatiquement :

SetLeverageStartup: true
SetMaxLeverage: false

Cela applique votre effet de levier configuré (par exemple, 10x) à tous les symboles pris en charge
Lancez le bot une fois
Attendez quelques minutes pour les mises à jour de l'effet de levier
Puis remettez les deux options sur false

⚠️ Ne laissez PAS ces options activées en permanence, sinon l'effet de levier sera réinitialisé à chaque redémarrage.

Effet de levier maximum (cas d'utilisation du scalping)

Si vous voulez l'effet de levier maximum autorisé par l'échange :

SetMaxLeverage: true

Utilisez cette option une seule fois, puis désactivez-la à nouveau.

6. Choisir les symboles à trader (optionnel)

Vous pouvez :

Trader tous les symboles synchronisés (500+)
Ou limiter le trading à certains symboles uniquement

Exemple :

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

Si vous tradez tous les symboles, gardez :

SyncSymbolsOnStartup: true

7. Configurer les notifications (fortement recommandé)

Configurez au moins un canal de notification dans notification.yaml :

Telegram
Discord

Cela vous permet de recevoir :

Les exécutions de transactions
Les erreurs et échecs
Les alertes Market Watch
Les événements d'urgence

Il est possible de fonctionner sans notifications, mais ce n'est pas recommandé.

Liste de contrôle finale (premier lancement)

Avant de démarrer MagicTradeBot, assurez-vous :

✅ Exchange sélectionné dans application.yaml
✅ Identifiants API définis (de préférence via des variables d'environnement)
✅ Clé de licence ajoutée (optionnelle mais recommandée)
✅ Synchronisation des symboles activée pour le premier lancement
✅ Configuration optionnelle de l'effet de levier effectuée une fois
✅ Canal de notification configuré

Voilà.
Aucune autre configuration n'est requise pour commencer à trader en toute sécurité et correctement.