Benutzerhandbuch — Globale Hebelkonfiguration und -verwaltung

Übersicht

Diese Anleitung erklärt, wie die Hebelkonfigurationsoptionen in tradesettings.yaml unter Allgemeine Einstellungen verwendet werden, um den Hebel für alle Handelssymbole an Ihrer Börse zu verwalten.

1. SetLeverageStartup

SetLeverageStartup: false

Ziel: Den definierten Hebel beim Start des Bots auf alle Handelssymbole anwenden.

Wann aktivieren (true)

  • ✅ Erstmalige Einrichtung: Wenn Sie den Hebel für alle Symbole initial festlegen müssen
  • ✅ Nach Änderung der Hebeleinstellungen: Wenn Sie Ihren gewünschten Hebel geändert haben
  • ✅ Nach Hinzufügen neuer Symbole: Wenn neue Handelspaare an der Börse hinzugefügt wurden

Wann deaktivieren (false)

  • ✅ Nach erfolgreicher Hebelaktualisierung: Um unnötige API-Aufrufe zu vermeiden
  • ✅ Normaler Betrieb: Um das Zurücksetzen des Hebels bei jedem Neustart zu verhindern
  • ✅ Wenn der Hebel bereits konfiguriert ist: Wenn alle Symbole den korrekten Hebel haben

⚠️ Wichtige Hinweise

  • Stellen Sie nach erfolgreicher Aktualisierung des Hebels immer auf false um, um Folgendes zu vermeiden:
    • Unnötige API-Aufrufe bei jeder Initialisierung
    • Mögliche Ratenbegrenzung durch die Börse
    • Längere Startzeiten
# Schritt 1: Aktivieren, um den Hebel zu aktualisieren
SetLeverageStartup: true

# Schritt 2: Bot starten (Hebel wird angewendet)
# Schritt 3: Bot stoppen

# Schritt 4: Vor dem nächsten Start deaktivieren
SetLeverageStartup: false

Beispiel-Workflow

1. Gewünschten Hebel in der Konfiguration festlegen (z. B. 10x)
2. SetLeverageStartup: true aktivieren
3. Bot starten → Hebel wird auf alle Symbole angewendet
4. Bot stoppen
5. SetLeverageStartup: false deaktivieren
6. Bot für normalen Handel neu starten

2. SetMaxLeverage

SetMaxLeverage: false

Ziel: Automatisch den maximal zulässigen Hebel der Börse für jedes Symbol verwenden, anstatt des konfigurierten Hebelwerts.

So funktioniert es

Wenn false (Standard):

  • Verwendet den von Ihnen konfigurierten Hebelwert für alle Symbole
  • Bei Nichtunterstützung kann der API-Aufruf fehlschlagen

Wenn true:

  • Holt den maximal unterstützten Hebel für jedes Symbol
  • Verwendet den niedrigeren Wert zwischen konfiguriertem und maximalem Börsenhebel

Beispiel-Szenarien

# Szenario 1: Symbol unterstützt Ihren Hebel
Ihre Konfiguration: 20x
Symbol-Max:         50x
Ergebnis:           20x

# Szenario 2: Symbol hat niedrigeren maximalen Hebel
Ihre Konfiguration: 20x
Symbol-Max:         5x
Ergebnis:           5x
Bot-Ausgabe:        "ℹ️ XYZUSDT maximaler Hebel ist 5x, verwende 5x statt 20x"

# Szenario 3: Symbol hat höheren maximalen Hebel
Ihre Konfiguration: 10x
Symbol-Max:         125x
Ergebnis:           10x

Wann aktivieren (true)

  • ✅ Sicherer Ansatz, um hebelbezogene Fehler zu vermeiden
  • ✅ Gemischte Symboltypen mit unterschiedlichen Hebelgrenzen
  • ✅ Konservativer Handel, um sich automatisch an Grenzen anzupassen
  • ✅ Multi-Börsen-Bots mit unterschiedlichen Regeln

Wann deaktivieren (false)

  • ✅ Einheitlicher Hebel für alle Symbole unterstützt
  • ✅ Strategie erfordert exakte Hebelwerte
  • ✅ Leistungsoptimierung (weniger API-Aufrufe)

Integration mit symbols.json

Ablauf der Hebelaktualisierung

1. Bot liest den Hebel aus tradesettings.yaml
2. Wenn SetMaxLeverage: true → Holt maximalen Hebel
3. Berechnet den endgültigen Hebel (Minimum von konfiguriertem vs. maximalem)
4. Wendet den Hebel über die Börsen-API an
5. ✅ Aktualisiert symbols.json mit dem tatsächlich angewendeten Hebel
6. Bot verwendet den Hebel aus symbols.json für den Handel

Warum die Aktualisierung von symbols.json wichtig ist

  • Sichert Konsistenz mit der Börse
  • Bleibt über Neustarts hinweg erhalten
  • Sichtbares Nachverfolgen des tatsächlich verwendeten Hebels

⚠️ Wichtig: Synchronisierungszeitpunkt

# ❌ FALSCH
SetLeverageStartup: true
SetMaxLeverage: true

# ✅ KORREKT (Einmalige Aktualisierung)
SetLeverageStartup: true
SetMaxLeverage: true
# Nach Erfolg:
SetLeverageStartup: false
SetMaxLeverage: false

Empfohlene Konfigurations-Workflows

Erstmalige Einrichtung (Neuer Bot)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true
  1. Obige Einstellungen konfigurieren
  2. Bot starten → Hebel angewendet und symbols.json aktualisiert
  3. Bot stoppen
  4. Beide Einstellungen deaktivieren
  5. Für normalen Betrieb neu starten

Änderung des Hebelwerts

# tradesettings.yaml
Leverage: 15
SetLeverageStartup: true
SetMaxLeverage: true
  1. Hebelwert aktualisieren
  2. SetLeverageStartup aktivieren
  3. Bot starten → Neuer Hebel angewendet
  4. Bot stoppen
  5. Vor dem nächsten Start wieder deaktivieren

Normaler Betrieb (Empfohlen)

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

Bot liest den Hebel aus symbols.json (bereits konfiguriert und aktualisiert).

Hinzufügen neuer Symbole

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true
  1. Neue Symbole zur Börse hinzufügen
  2. SetLeverageStartup aktivieren
  3. Bot starten → Hebel auf alle Symbole angewendet
  4. Bot stoppen
  5. Vor normalem Handel deaktivieren

Fehlerbehebung

  • Problem: Bot setzt Hebel ständig zurück
    Ursache: SetLeverageStartup: true bleibt aktiviert
    Lösung: Nach der Ersteinrichtung auf false setzen
  • Problem: Hebel wird nicht angewendet
    Ursache: SetLeverageStartup: false während der Aktualisierung
    Lösung: Vorübergehend aktivieren und neu starten
  • Problem: API-Fehler bezüglich Hebelgrenzen
    Ursache: Konfigurierter Hebel überschreitet das Maximum der Börse
    Lösung: SetMaxLeverage: true aktivieren
  • Problem: Diskrepanz bei symbols.json
    Ursache: Manuelle Änderung oder Desynchronisation
    Lösung: Einmalig SetLeverageStartup: true aktivieren, um zu resynchronisieren

Beste Praktiken

✅ TUN

  • SetLeverageStartup: false nach erfolgreichen Aktualisierungen setzen
  • SetMaxLeverage: true für die Ersteinrichtung verwenden
  • Hebelwerte in symbols.json überprüfen
  • Vor Änderungen Backups erstellen
  • An einem Symbol testen, bevor alle geändert werden

❌ NICHT TUN

  • SetLeverageStartup: true im normalen Betrieb lassen
  • Hebel ändern, ohne SetLeverageStartup zu aktivieren
  • symbols.json manuell bearbeiten
  • Beide Einstellungen wiederholt aktivieren (verursacht API-Overhead)

Schnellreferenztabelle

Szenario SetLeverageStartup SetMaxLeverage Wann verwenden
Erstmalige Einrichtung true true Erstes Starten des Bots
Normaler Handel false false Täglicher Betrieb
Hebel ändern true true Nach Änderung des Hebelwerts
Neue Symbole hinzufügen true true Neue Paare zur Börse hinzugefügt
Konservativer Modus false true Automatische Anpassung an Börsengrenzen
Leistungsmodus false false Minimierung von API-Aufrufen

Support

  1. Bot-Protokolle auf Fehler überprüfen
  2. Sicherstellen, dass die Börsen-API-Berechtigungen die Hebeländerung umfassen
  3. Sicherstellen, dass alle Symbole an der Börse existieren
  4. symbols.json auf korrekten Hebel überprüfen
  5. Börsenspezifische Hebelgrenzen überprüfen

📎 Related Topics