Qu'est-ce que application.yaml dans MagicTradeBot ?

Qu'est-ce que application.yaml ?

application.yaml est le fichier de configuration principal qui contrôle la façon dont MagicTradeBot démarre, se connecte aux exchanges, s'identifie et fonctionne au niveau système.

Considérez-le comme la configuration de démarrage de MagicTradeBot — avant que toute stratégie, veille de marché ou logique de moteur de décision ne s'exécute, le bot lit ce fichier pour comprendre :

À quel exchange se connecter
Comment s'authentifier de manière sécurisée
S'il doit fonctionner en mode démo ou en mode réel
Quelle licence utiliser
Le comportement d'exécution de base (débogage, nommage, environnement)

Sans un application.yaml valide, MagicTradeBot ne peut pas s'initialiser ou fonctionner correctement.

Que contrôle application.yaml ?

Le fichier application.yaml est responsable des paramètres globaux, non liés à la stratégie, y compris :

Sélection de l'exchange et règles de compatibilité
Authentification API (ou mappage de variables d'environnement)
Validation de la licence
Identité du bot et indicateurs d'exécution
Comportement de sécurité et de déploiement

Il ne définit PAS :

Les stratégies de trading
Les règles de stop-loss / take-profit
La logique de veille de marché
Les règles de décision DCA ou Brain

Celles-ci sont gérées dans des fichiers de configuration séparés et spécifiques aux fonctionnalités, ce qui permet de garder des responsabilités propres et modulaires.

Explication des sections clés

1. Configuration de l'exchange

Cette section indique à MagicTradeBot à quel exchange se connecter et comment.

Responsabilités clés :

Sélectionne l'exchange (binance, bybit, okx, bitget, hyperliquid)
Applique la compatibilité du mode de position spécifique à l'exchange
Charge en toute sécurité les identifiants API

MagicTradeBot effectue une validation stricte ici pour éviter :

Des modes de position incorrects (par exemple, Hedge vs One-Way)
L'échec de l'exécution des ordres
Des calculs de PnL incorrects
Des inadéquations de gestion des risques

Si un exchange non pris en charge est configuré, le bot refusera de fonctionner.

2. Identifiants API et sécurité

application.yaml prend en charge deux méthodes sécurisées pour les identifiants :

Option A : YAML direct (recommandé uniquement pour la démo/les tests)

APIKEY: ""
APISECRET: ""
Passphrase: ""

Option B : Variables d'environnement (recommandé pour la production)

Les variables d'environnement remplacent automatiquement les valeurs YAML.

Cette conception :

Empêche l'exposition accidentelle des clés
Fonctionne de manière transparente avec Docker, VPS et les déploiements cloud
S'aligne sur les meilleures pratiques de sécurité des entreprises

MagicTradeBot ne nécessite jamais d'autorisations de retrait et met explicitement en garde contre celles-ci.

3. Compatibilité du mode de position (Critique)

Différents exchanges prennent en charge différents modes de position, et MagicTradeBot les applique au démarrage.

Exemples :

Bybit → Mode One-Way uniquement
Binance / OKX / Bitget → Mode Hedge requis

Si votre compte exchange est mal configuré :

Les ordres peuvent être rejetés
Le TP/SL peut échouer
Les positions peuvent se fermer incorrectement

Cette validation existe pour protéger le capital et garantir un comportement déterministe.

4. Configuration de la licence

La section Licence active votre installation MagicTradeBot.

License:
  Key: ""

La licence :

Débloque les fonctionnalités en fonction de votre plan
Contrôle l'autorisation de l'instance
Est validée au démarrage

Sans une clé de licence valide, le bot n'entrera pas en mode opérationnel.

5. Paramètres généraux de l'application

Cette section contrôle la façon dont le bot se comporte à l'exécution — pas comment il trade.

Options clés :

BotName – Aide à identifier cette instance dans les journaux, tableaux de bord et alertes
DemoMode – Active le trading simulé sans fonds réels
DebugMode – Active la journalisation détaillée pour les diagnostics

Ces paramètres sont particulièrement utiles lors de l'exécution :

De plusieurs instances de bot
D'environnements de préproduction vs production
D'investigations de débogage ou de support

Mode démo vs mode réel

L'un des indicateurs les plus importants dans application.yaml est :

DemoMode: true

DemoMode = true → Aucun ordre réel n'est passé
DemoMode = false → Le trading en direct est activé

Cela permet aux utilisateurs de :

Tester les configurations en toute sécurité
Valider les stratégies avant de risquer du capital
Exécuter le bot en simulation sur des données de marché réelles

Pourquoi MagicTradeBot utilise application.yaml

MagicTradeBot utilise application.yaml car il fournit :

Une structure lisible par l'homme
Une forte séparation des préoccupations
Des valeurs par défaut sûres pour les nouveaux utilisateurs
Une automatisation facile via des variables d'environnement
Une compatibilité avec Docker, le cloud et les déploiements sur site

Plus important encore, il garantit un comportement de démarrage prévisible, ce qui est essentiel pour un système de trading automatisé.

Bonnes pratiques

✔ Utilisez des variables d'environnement pour les clés API en production
✔ Laissez DemoMode activé pendant les tests
✔ Vérifiez le mode de position de l'exchange avant de passer en direct
✔ N'activez jamais les autorisations de retrait sur les clés API
✔ Traitez application.yaml comme une configuration d'infrastructure, pas une configuration de stratégie

Résumé

application.yaml est le fondement de l'environnement d'exécution de MagicTradeBot.

Il définit :

Où le bot se connecte
Comment il s'authentifie
S'il trade en direct ou en démo
Quelle licence est active
À quel point il fonctionne en sécurité

Toute l'intelligence avancée — comme le SL/TP intelligent, la veille de marché, le DCA et le cerveau de MagicTradeBot — est construite au-dessus de ce fichier, ce qui en fait l'un des composants les plus importants de l'ensemble du système.

Qu'est-ce que application.yaml dans MagicTradeBot ?