Guide de l’utilisateur — Configuration et gestion globales de l’effet de levier

Vue d'ensemble

Ce guide explique comment utiliser les options de configuration de l'effet de levier dans tradesettings.yaml sous Paramètres généraux afin de gérer l'effet de levier pour tous les symboles de trading sur votre plateforme d'échange.

1. SetLeverageStartup

SetLeverageStartup: false

Objectif : Appliquer l’effet de levier défini à tous les symboles de trading au démarrage du bot.

Quand activer (true)

• ✅ Configuration initiale : lorsque vous devez définir l’effet de levier pour tous les symboles
• ✅ Après modification des paramètres d’effet de levier : lorsque vous avez changé la valeur souhaitée
• ✅ Après l’ajout de nouveaux symboles : lorsque de nouvelles paires sont ajoutées à la plateforme

Quand désactiver (false)

• ✅ Après mise à jour réussie : pour éviter les appels API inutiles
• ✅ Fonctionnement normal : pour ne pas réinitialiser l’effet de levier à chaque redémarrage
• ✅ Lorsque l’effet de levier est déjà configuré : si tous les symboles ont la valeur correcte

⚠️ Notes importantes

• Toujours définir sur false après mise à jour réussie de l’effet de levier afin d’éviter :
  • Des appels API répétitifs à chaque initialisation
  • Un risque de limitation de taux sur l’échange
  • Des temps de démarrage plus longs

# Étape 1 : Activer pour mettre à jour l’effet de levier
SetLeverageStartup: true

# Étape 2 : Démarrer le bot (effet de levier appliqué)
# Étape 3 : Arrêter le bot

# Étape 4 : Désactiver avant le prochain démarrage
SetLeverageStartup: false

Exemple de flux de travail

1. Définir l’effet de levier souhaité dans la config (ex. 10x)
2. Activer SetLeverageStartup: true
3. Démarrer le bot → Effet de levier appliqué à tous les symboles
4. Arrêter le bot
5. Désactiver SetLeverageStartup: false
6. Redémarrer pour un trading normal

2. SetMaxLeverage

SetMaxLeverage: false

Objectif : Utiliser automatiquement le levier maximal autorisé par l’échange pour chaque symbole au lieu de la valeur configurée.

Comment cela fonctionne

Quand false (par défaut) :

• Utilise votre valeur de levier configurée pour tous les symboles
• En cas d’incompatibilité, l’appel API peut échouer

Quand true :

• Récupère le levier maximal pris en charge pour chaque symbole
• Utilise la valeur la plus basse entre la configuration et le maximum de l’échange

Exemples de scénarios

# Scénario 1 : Le symbole prend en charge votre levier
Votre config : 20x
Max du symbole : 50x
Résultat : 20x

# Scénario 2 : Le symbole a un levier max plus bas
Votre config : 20x
Max du symbole : 5x
Résultat : 5x
Sortie du bot : "ℹ️ XYZUSDT levier max 5x, utilisation de 5x au lieu de 20x"

# Scénario 3 : Le symbole a un levier max plus élevé
Votre config : 10x
Max du symbole : 125x
Résultat : 10x

Quand activer (true)

• ✅ Approche sûre pour éviter les erreurs liées au levier
• ✅ Symboles mixtes avec limites de levier variables
• ✅ Trading conservateur s’ajustant automatiquement aux limites
• ✅ Bots multi-échanges avec règles différentes

Quand désactiver (false)

• ✅ Levier uniforme sur tous les symboles
• ✅ Stratégie nécessitant des valeurs exactes
• ✅ Optimisation des performances (moins d’appels API)

Intégration avec symbols.json

Flux de mise à jour du levier

1. Le bot lit le levier depuis tradesettings.yaml
2. Si SetMaxLeverage : true → Récupère le levier max
3. Calcule le levier final (min entre configuré et max)
4. Applique via l’API de l’échange
5. ✅ Met à jour symbols.json avec le levier appliqué
6. Le bot utilise symbols.json pour le trading

Pourquoi la mise à jour de symbols.json est importante

• Garantit la cohérence avec la plateforme
• Persiste après les redémarrages
• Permet de suivre le levier réellement appliqué

⚠️ Important : synchronisation

# ❌ INCORRECT
SetLeverageStartup: true
SetMaxLeverage: true

# ✅ CORRECT (mise à jour unique)
SetLeverageStartup: true
SetMaxLeverage: true
# Après succès :
SetLeverageStartup: false
SetMaxLeverage: false

Flux de configuration recommandés

Configuration initiale (nouveau bot)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true

1. Configurer les paramètres ci-dessus
2. Démarrer le bot → Levier appliqué et symbols.json mis à jour
3. Arrêter le bot
4. Désactiver les deux paramètres
5. Redémarrer pour le fonctionnement normal

Changer la valeur du levier

# tradesettings.yaml
Leverage: 15
SetLeverageStartup: true
SetMaxLeverage: true

1. Mettre à jour la valeur de levier
2. Activer SetLeverageStartup
3. Démarrer le bot → Nouveau levier appliqué
4. Arrêter le bot
5. Désactiver avant le prochain démarrage

Fonctionnement normal (recommandé)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: false
SetMaxLeverage: false

Le bot lit le levier depuis symbols.json (déjà configuré et mis à jour).

Ajout de nouveaux symboles

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true

1. Ajouter de nouveaux symboles sur la plateforme
2. Activer SetLeverageStartup
3. Démarrer le bot → Levier appliqué à tous les symboles
4. Arrêter le bot
5. Désactiver avant le trading normal

Résolution des problèmes

• Problème : Le bot réinitialise continuellement le levier
  Cause : SetLeverageStartup: true laissé activé
  Solution : Mettre sur false après la configuration initiale
• Problème : L’effet de levier n’est pas appliqué
  Cause : SetLeverageStartup: false pendant la mise à jour
  Solution : Activer temporairement et redémarrer
• Problème : Erreurs API liées aux limites de levier
  Cause : Le levier configuré dépasse le maximum de l’échange
  Solution : Activer SetMaxLeverage: true
• Problème : Désynchronisation de symbols.json
  Cause : Modification manuelle ou désynchronisation
  Solution : Activer SetLeverageStartup: true une fois pour resynchroniser

Bonnes pratiques

✅ À FAIRE

• Mettre SetLeverageStartup: false après mise à jour réussie
• Utiliser SetMaxLeverage: true lors de la première configuration
• Vérifier les valeurs dans symbols.json
• Conserver des sauvegardes avant modifications
• Tester sur un symbole avant tous

❌ À NE PAS FAIRE

• Laisser SetLeverageStartup: true en fonctionnement normal
• Changer le levier sans activer SetLeverageStartup
• Modifier symbols.json manuellement
• Activer les deux à répétition (surcharge API)

Tableau de référence rapide

Support

1. Vérifiez les journaux du bot pour les erreurs
2. Confirmez que les autorisations API permettent la modification du levier
3. Assurez-vous que tous les symboles existent sur la plateforme
4. Vérifiez symbols.json pour les valeurs correctes
5. Consultez les limites de levier spécifiques à l’échange