Welche Einstellungen müssen vor dem ersten Start von MagicTradeBot konfiguriert werden?

  • Home
  • Documentation
  • Welche Einstellungen müssen vor dem ersten Start von MagicTradeBot konfiguriert werden?

Ersteinrichtungsanleitung

Bevor Sie MagicTradeBot zum ersten Mal starten, müssen einige wenige obligatorische und empfohlene Einstellungen konfiguriert werden, um sicherzustellen, dass der Bot korrekt startet, sich sicher mit Ihrer Börse verbindet und fehlerfrei arbeitet.

MagicTradeBot ist mit sicheren Standardeinstellungen konzipiert, daher müssen Sie nicht jede Datei im Voraus konfigurieren. Die folgenden Schritte decken die minimal erforderliche und empfohlene Einrichtung für einen reibungslosen ersten Lauf ab.

1. Börse in application.yaml konfigurieren

Sie müssen angeben, mit welcher Börse MagicTradeBot eine Verbindung herstellen soll.

Exchange:
  Name: "bybit"

Unterstützte Börsen:

  • Binance
  • Bybit
  • OKX
  • Bitget
  • Hyperliquid

⚠️ Wichtig: Jede Börse hat strenge Anforderungen an den Positionsmodus (One-Way vs. Hedge). Stellen Sie sicher, dass Ihr Börsenkonto entsprechend konfiguriert ist, bevor Sie den Bot ausführen.

2. Exchange-API-Zugangsdaten festlegen (Erforderlich)

MagicTradeBot benötigt API-Zugriff, um Trades zu platzieren und zu verwalten.

Empfohlene Methode: Umgebungsvariablen (Best Practice)

Die Verwendung von Umgebungsvariablen wird dringend empfohlen, insbesondere für die Produktion, weil:

  • API-Schlüssel nicht in Dateien gespeichert werden
  • Schlüssel sicherer und leichter zu wechseln sind
  • Umgebungsvariablen YAML-Werte automatisch überschreiben

Einrichtung von Umgebungsvariablen nach Betriebssystem

✅ Windows (PowerShell)
setx BINANCE_API_KEY "ihr_api_schluessel_hier"
setx BINANCE_API_SECRET "ihr_api_geheimnis_hier"

Starten Sie das Terminal (oder das System) neu, nachdem Sie die Variablen gesetzt haben.

✅ Linux / macOS (Terminal)
export BINANCE_API_KEY="ihr_api_schluessel_hier"
export BINANCE_API_SECRET="ihr_api_geheimnis_hier"

Um sie dauerhaft zu machen, fügen Sie die Zeilen hinzu zu:

  • ~/.bashrc
  • ~/.zshrc
  • Ihrer Shell-Profil-Datei
✅ Docker / Docker Compose
environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

Unterstützte Namen für Umgebungsvariablen

Beispiele:

  • 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

🔐 Aktivieren Sie niemals Abhebeberechtigungen für API-Schlüssel.

3. Ihren Lizenzschlüssel angeben

In application.yaml:

License:
  Key: "ihr_lizenzschluessel_hier"

So erhalten Sie Ihren Lizenzschlüssel

  1. Melden Sie sich bei https://magictradebot.com an
  2. Gehen Sie zu Downloads
  3. Kopieren Sie Ihren Lizenzschlüssel

Wichtige Hinweise

  • Der Bot kann auch ohne Lizenz laufen
  • Allerdings sind die Funktionen eingeschränkt
  • Die Lizenzprüfung erfolgt beim Start

4. Grundlegende Trading-Einstellungen überprüfen (trading.yaml)

Für Erstbenutzer sind in dieser Datei keine zwingenden Änderungen erforderlich.

Sie können optional überprüfen oder anpassen:

  • Anfänglicher Handelsbetrag
  • Standard-Hebel
  • Risikogrenzen

Lassen Sie im Zweifelsfall die Standardeinstellungen – sie sind für erste Läufe und den Demo-Modus sicher.

5. Erstmalige Symbol- und Hebel-Einrichtung (Sehr wichtig)

Schritt 1: Symbol-Synchronisierung aktivieren (Nur für den ersten Lauf)

In trading.yaml (oder der Symbol-Konfigurationsdatei):

SyncSymbolsOnStartup: true

Dies wird:

  • Alle unterstützten Symbole von der Börse abrufen
  • symbols.json erstellen oder aktualisieren
  • Delistete Symbole entfernen
  • Neu gelistete Symbole hinzufügen

➡️ Starten Sie den Bot und warten Sie, bis die Symbol-Synchronisierung abgeschlossen ist
➡️ Überwachen Sie die Datei symbols.json
➡️ Stoppen Sie den Bot, sobald die Synchronisierung abgeschlossen ist

Schritt 2: Symbol-Synchronisierung deaktivieren (Optional)

Nach der ersten Synchronisierung können Sie setzen:

SyncSymbolsOnStartup: false

Wenn Sie automatische Symbol-Updates wünschen, lassen Sie es dauerhaft auf true.

Schritt 3: Einmalige Hebel-Einrichtung (Optional, aber empfohlen)

Wenn Sie möchten, dass MagicTradeBot den Hebel automatisch konfiguriert:

SetLeverageStartup: true
SetMaxLeverage: false
  • Dies wendet Ihren konfigurierten Hebel (z. B. 10x) auf alle unterstützten Symbole an
  • Starten Sie den Bot einmal
  • Warten Sie einige Minuten auf die Hebel-Updates
  • Setzen Sie dann beide Optionen wieder auf false

⚠️ Lassen Sie diese Optionen NICHT dauerhaft aktiviert, sonst wird der Hebel bei jedem Neustart zurückgesetzt.

Maximaler Hebel (Scalping-Anwendungsfall)

Wenn Sie den maximal von der Börse erlaubten Hebel wünschen:

SetMaxLeverage: true

Verwenden Sie dies nur einmal und deaktivieren Sie es dann wieder.

6. Symbole zum Handeln auswählen (Optional)

Sie können:

  • Alle synchronisierten Symbole handeln (500+)
  • Oder den Handel nur auf ausgewählte Symbole beschränken

Beispiel:

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

Wenn Sie alle Symbole handeln, behalten Sie bei:

SyncSymbolsOnStartup: true

7. Benachrichtigungen konfigurieren (Sehr empfohlen)

Richten Sie mindestens einen Benachrichtigungskanal in notification.yaml ein:

  • Telegram
  • Discord

So können Sie empfangen:

  • Handelsausführungen
  • Fehler und Misserfolge
  • Market Watch-Warnungen
  • Notfälle

Ein Betrieb ohne Benachrichtigungen ist möglich, aber nicht empfohlen.

Abschließende Checkliste (Erster Lauf)

Stellen Sie vor dem Start von MagicTradeBot Folgendes sicher:

  • ✅ Börse in application.yaml ausgewählt
  • ✅ API-Zugangsdaten festgelegt (vorzugsweise über Umgebungsvariablen)
  • ✅ Lizenzschlüssel hinzugefügt (optional, aber empfohlen)
  • ✅ Symbol-Synchronisierung für den ersten Lauf aktiviert
  • ✅ Optionale Hebel-Einrichtung einmal durchgeführt
  • ✅ Benachrichtigungskanal konfiguriert

Das ist alles.
Es ist keine weitere Konfiguration erforderlich, um sicher und korrekt mit dem Trading zu beginnen.

📎 Related Topics