cBot-Vorgänge¶

Dieser Artikel behandelt den Lebenszyklus eines cBots in cTrader CLI. Sie erfahren, wie Sie einen cBot im Terminal starten, laufende Instanzen auflisten und stoppen, einen cBot auf einem VPS oder Cloud-Server mit Docker hosten und ihn anhand historischer Daten einem Backtest unterziehen.

Voraussetzungen ¶

• cTrader CLI ist installiert.
• Ihre cTrader ID, eine Datei mit Anmeldedaten und Ihre Kontonummer liegen bereit.
• Der cBot wurde als .algo-Datei exportiert und für .NET 8 erstellt.

cBot-Metadaten abrufen ¶

Listen Sie vor dem Start eines cBots mit metadata seine verfügbaren Parameter auf. Die Ausgabe enthält den Namen und Typ jeder cBot-Eigenschaft.

ctrader-cli metadata <path-to-algo-file>

Verwenden Sie beim Übergeben von Parametern über die Befehlszeile oder eine .cbotset-Datei die Parameternamen aus der Metadatenausgabe.

Einen cBot starten ¶

Starten Sie einen cBot mit run. Der Pfad zur .algo-Datei ist das erste Argument. --account, --symbol und --period sind erforderlich.

ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>

Drei Möglichkeiten, Parameter zu übergeben.

Zwei optionale Flags sind für unbeaufsichtigte Ausführungen wichtig.

Einen cBot auf einem VPS oder Cloud-Server ausführen ¶

Ein reines Kommandozeilentool läuft auch auf einer kleinen Linux-Instanz problemlos. So kann ein cBot dauerhaft und kostengünstiger als auf einem Desktop-Computer betrieben werden. Das Docker-Image von cTrader CLI ist die portabelste Lösung dafür.

Laden Sie das neueste Image herunter:

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

Führen Sie einen cBot in einem Container aus. Die Option --mount bindet einen Ordner des Hostsystems in den Container ein; mit den -e-Optionen übergeben Sie die Konfiguration als Umgebungsvariablen:

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

Über die cTrader-Desktop-Anwendung starten ¶

Sie müssen die Befehlszeile nicht beherrschen, um cTrader CLI zu nutzen.

1. Bereiten Sie in der cTrader-Desktop-Anwendung einen cBot mit Ihren bevorzugten Parametern vor.
2. Klicken Sie mit der rechten Maustaste auf eine lokale cBot-Instanz und wählen Sie In externem Prozess starten. cTrader CLI startet automatisch und führt die Instanz unabhängig aus.
3. Schließen Sie die Desktop-Anwendung, um CPU-Leistung und Arbeitsspeicher zu sparen. Der cBot läuft im cTrader CLI-Prozess weiter.

cBots auflisten und stoppen ¶

Listen Sie die aktuell auf dem Konto laufenden cBot-Instanzen auf:

ctrader-cli cbots --ctid=letstrade --password=secret --account=1234567 -q

Stoppen Sie eine laufende Instanz anhand ihrer Kennung, die run in der Ausgabe anzeigt:

ctrader-cli stop --ctid=letstrade --password=secret --account=1234567 -q --instance=<instance-id>

Um alle laufenden cBots gleichzeitig zu stoppen, öffnen Sie die interaktive Shell und führen Sie stop all yes aus. Der cTrader CLI-Prozess wird beendet, sobald die letzte Instanz stoppt.

Einen cBot einem Backtest unterziehen ¶

Testen Sie einen cBot anhand historischer Daten mit backtest. Der Pfad zur .algo-Datei ist das erste Argument; optional kann eine .cbotset-Datei folgen. Für den Test sind außerdem ein Symbol, ein Zeitrahmen und ein Datumsbereich erforderlich:

ctrader-cli backtest <path-to-algo-file> [<path-to-cbotset-file>] --account=<account-id> --symbol=<symbol> --period=<period> --start=<start-date> --end=<end-date> --data-mode=<data-mode>

Optionen für die Testumgebung ¶

Die Flags für die Testumgebung finden Sie beim Eintrag backtest in der CLI-Referenz. Nur --start, --end und --data-mode sind erforderlich. Weitere optionale Flags betreffen Startguthaben, Kommissionen, Spread, Datenquellen und Berichtsausgaben.

Datenmodi ¶

Praxisbeispiel ¶

Führen Sie einen Backtest mit einem Beispiel-cBot und einer einzelnen .cbotset-Parameterdatei aus:

ctrader-cli backtest "C:/test/sample martingale.algo" C:/test/special-parameters.cbotset \
  --ctid=letstrade --pwd-file=C:/test/password.pwd --account=1234567 --symbol=EURUSD --period=h1 \
  --start="01/01/2025 12:34" --end="31/01/2025 20:56" \
  --balance=10000 --commission=30 --commission-type=UsdPerMillionUsdVolume --spread=1 --data-mode=m1

Backtest-Ausgabe ¶

cTrader CLI zeigt den Fortschritt laufend im Terminal an und gibt nach Abschluss eine Zusammenfassung aus. Das vollständige Ergebnis befindet sich im Ordner Backtesting neben der .algo-Datei, mit einem eigenen Unterordner pro Ausführung:

…/data/{cBotName}/{BacktestingInstanceID}/Backtesting

--report und --report-json speichern Berichte zusätzlich zum oben genannten Ordner unter einem angegebenen Pfad.

Verhalten der Algo API in cTrader CLI ¶

Einige Mitglieder der cTrader Algo API verhalten sich bei der Ausführung eines cBots in cTrader CLI anders, da keine grafische Benutzeroberfläche vorhanden ist.