Zum Inhalt

cTrader CLI einrichten

Dieser Artikel beschreibt die Installation von cTrader CLI, das Erstellen einer Anmeldedatendatei und das Überprüfen der Verbindung unter Windows, macOS oder Linux – über ein Terminal oder einen Docker-Container.

Voraussetzungen

  • Eine cTrader ID mit mindestens einem Handelskonto.
  • Ein unterstützter Paketmanager: WinGet unter Windows sowie Homebrew unter macOS und Linux.
  • Für cBots ist .NET 8 erforderlich. Kompilieren Sie ältere cBots in der aktuellen cTrader-Desktop-Anwendung neu, bevor Sie sie mit cTrader CLI ausführen.
  • Zur Nutzung von Skills benötigen Sie Node.js ab Version 22.20.0.

Installation mit einem Paketmanager

Die Installation über einen Paketmanager wird empfohlen. Dabei wird die passende Version für Ihr Betriebssystem heruntergeladen und der Befehl ctrader-cli zu Ihrem PATH hinzugefügt, sodass Sie ihn aus jedem Ordner ausführen können.

Öffnen Sie Windows PowerShell als Administrator und führen Sie Folgendes aus:

winget install Spotware.cTrader.CLI

Öffnen Sie ein Terminal und führen Sie Folgendes aus:

brew tap spotware/tap https://github.com/spotware/homebrew-tap
brew install spotware/tap/ctrader-cli

Falls Homebrew noch nicht installiert ist, folgen Sie zunächst den Anweisungen auf der Homebrew-Website.

Öffnen Sie ein Terminal und führen Sie Folgendes aus:

brew tap spotware/tap https://github.com/spotware/homebrew-tap
brew install spotware/tap/ctrader-cli

Falls Homebrew noch nicht installiert ist, folgen Sie zunächst den Anweisungen auf der Homebrew-Website.

Warnung

Installieren Sie cTrader CLI ausschließlich über die oben angegebenen offiziellen Spotware-Paketkennungen. Bei Installationen aus nicht verifizierten Quellen können Ihre Anmeldedaten und Ihr Guthaben gefährdet werden.

Installation mit dem Docker-Image

cTrader CLI wird als Linux-Docker-Image bereitgestellt. Damit können Sie cBots auf einem Linux-VPS, einem Hochleistungsserver oder einer Cloud-Plattform hosten. Das Image läuft auch unter Windows über Docker Desktop mit WSL.

docker pull ghcr.io/spotware/ctrader-console:latest

Die Anleitung zum Ausführen eines cBots zeigt, wie Sie Hostordner einbinden und Einstellungen über Umgebungsvariablen übergeben.

Tipp

cTrader CLI ist bereits in der cTrader-Desktop-Anwendung enthalten. Sie können daher einen cBot starten und in einem externen Prozess ausführen, ohne cTrader CLI separat zu installieren.

Manuelle Installation unter Windows

Wenn Sie unter Windows keinen Paketmanager verwenden möchten, können Sie die ausführbare Datei ctrader-cli aus der cTrader-Desktop-Anwendung nutzen. Sie befindet sich normalerweise unter folgendem Pfad:

C:\Users\{username}\AppData\Local\Spotware\cTrader\{installationId}

Um cTrader CLI aus jedem Ordner ausführen zu können, fügen Sie dieses Verzeichnis Ihrem PATH hinzu:

  1. Kopieren Sie den Pfad zu dem Ordner, der ctrader-cli enthält.
  2. Suchen Sie im Windows-Startmenü nach Umgebungsvariablen und wählen Sie Systemumgebungsvariablen bearbeiten.
  3. Wählen Sie im Fenster Systemeigenschaften die Option Umgebungsvariablen.
  4. Doppelklicken Sie unter Benutzervariablen auf Path.
  5. Wählen Sie Neu, fügen Sie den kopierten Pfad ein und bestätigen Sie zum Speichern in jedem Dialogfeld mit OK.

Hinweis

Nach dem Hinzufügen des Ordners zum PATH können Sie ctrader-cli gefolgt von einem beliebigen Befehl von jedem Speicherort ausführen.

Installation überprüfen

Prüfen Sie nach der Installation, ob cTrader CLI verfügbar ist. Für keinen der beiden Befehle ist eine Anmeldung erforderlich.

ctrader-cli --version
ctrader-cli --help

Falls das Terminal meldet, dass der Befehl nicht gefunden wurde, schließen und öffnen Sie es erneut, damit der aktualisierte PATH übernommen wird. Versuchen Sie es anschließend noch einmal.

Anmeldedatendatei erstellen

Die meisten Befehle beziehen sich auf ein Konto. Dafür werden drei Werte benötigt: cTrader ID, Passwort und Kontonummer.

Angabe Option Beschreibung
cTrader ID --ctid oder -c cTID-Benutzername oder E-Mail-Adresse
Passwort --pwd-file Pfad zu einer Datei mit dem cTID-Passwort
Konto --account oder -a Handelskontonummer

Geben Sie Ihr cTrader ID-Passwort aus Sicherheitsgründen nicht direkt in einen Befehl ein. Speichern Sie es in einer Datei und verweisen Sie mit --pwd-file auf diese Datei.

  1. Öffnen Sie einen einfachen Texteditor, beispielsweise Editor.
  2. Geben Sie Ihr cTrader ID-Passwort in einer einzigen Zeile ohne führende oder abschließende Leerzeichen ein.
  3. Speichern Sie die Datei mit der Erweiterung .pwd oder .txt, beispielsweise als password.pwd.
  4. Verweisen Sie im Befehl auf die Datei: --pwd-file=C:/test/password.pwd.

Wenn die Anmeldedatendatei bereit ist, übergeben Sie sie den Befehlen nach einer der beiden Authentifizierungsmethoden.

Warnung

In einer Passwortdatei wird Ihr Passwort im Klartext gespeichert. Bewahren Sie die Datei außerhalb freigegebener oder versionsverwalteter Ordner auf, beschränken Sie die Leseberechtigungen und löschen Sie die Datei, sobald sie nicht mehr benötigt wird.

Docker-Ausführungsbeispiel

In einem Container werden Hostpfade über --mount eingebunden und Konfigurationswerte über -e übergeben. Ein kurzes Beispiel zum Starten eines cBots in einem Container:

docker run -d -it \
  --name ctrader.console.run.mybot \
  --mount type=bind,src=/cAlgo/Robots,dst=/mnt/Robots \
  -e CTID='mycid' \
  -e PWD-FILE='/mnt/Robots/ctrader-cli.pwd' \
  -e ACCOUNT='9102302' \
  -e SYMBOL='EURUSD' \
  -e PERIOD='H1' \
  ghcr.io/spotware/ctrader-console:latest run "/mnt/Robots/My bot.algo" --environment-variables

Eine vollständige Docker-Anleitung einschließlich der Erklärung aller Optionen finden Sie unter cBots ausführen und verwalten.