Den vergangenen Handelsmonat auswerten¶
Eine monatliche Auswertung beantwortet drei Fragen: Wie viele Transaktionen wurden geschlossen, welches Ergebnis haben sie erzielt und wo bestehen weiterhin Risiken? Diese Anleitung speichert Transaktionen, die Historie abgeschlossener Orders und die aktuelle Exposition in einem datierten Ordner. Anschließend werden die Schritte in einem Skript zusammengefasst, das Sie am Ende jedes Monats erneut ausführen können.
Tipp
Legen Sie Ihre Zugangsdaten einmalig in Shell-Variablen fest. Alle folgenden interaktiven Befehle verwenden diese Variablen. Dadurch bleiben die Schritte kurz und das Skript lässt sich in verschiedenen Umgebungen nutzen.
export CTID=letstrade
export ACC=7654321
export PWD_FILE=$HOME/.ctrader/pwd
1. Die im Monat geschlossenen Transaktionen abrufen ¶
deals gibt nur geschlossene Transaktionen zurück: einen Datensatz pro Schließungstransaktion mit realisiertem Gewinn bzw. Verlust (GuV). Dies sind dieselben Daten wie auf der Registerkarte Verlauf in cTrader. --from und --to filtern die Transaktionen nach dem Schließungszeitpunkt; --count gibt die zuletzt geschlossenen Transaktionen zurück. Ausführungen zur Positionseröffnung sind nicht enthalten. Eine Position erscheint daher erst nach ihrer vollständigen oder teilweisen Schließung in deals.
ctrader-cli deals --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q \
--from=01/06/2025 --to=30/06/2025
Für jede geschlossene Transaktion enthält die Ausgabe Symbol, Handelsrichtung, Volumen, Ausführungskurs und realisierten Gewinn.
2. Die Historie abgeschlossener Orders abrufen ¶
orders-history listet die im selben Zeitraum abgeschlossenen Orders mit ihrem endgültigen Status (filled, expired, cancelled oder error) auf. Ausstehende Orders sind nicht enthalten.
ctrader-cli orders-history --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q \
--from=01/06/2025 --to=30/06/2025
Vergleichen Sie die Transaktionsliste mit der Order-Historie, um zu erkennen, welche Einstiege zu welchen Ausstiegen geführt haben.
Für deals und orders-history gelten folgende Beschränkungen beim Abruf historischer Daten:
- Die CLI lädt den vollständigen mit
--fromund--tofestgelegten Zeitraum ohne zeitliche Begrenzung. - Ein einzelner Aufruf gibt aus diesem Zeitraum nur die letzten 200 Transaktionen (
deals) beziehungsweise die letzten 500 Orders (orders-history) zurück. - Ohne
--fromund--togeben beide Befehle nur Daten der letzten 30 Tage zurück.
Wenn in einem Monat besonders viel gehandelt wurde, teilen Sie den Zeitraum in mehrere Abschnitte und führen Sie jeden Befehl für jeden Abschnitt einzeln aus.
3. Die aktuelle Exposition prüfen ¶
exposure fasst die Exposition offener Positionen auf dem Konto zusammen, gruppiert nach Symbol. So erhalten Sie eine Momentaufnahme der Risiken, die auch am Tag nach der Auswertung noch bestehen.
ctrader-cli exposure --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q
4. Jedes Ergebnis in einer datierten Datei speichern ¶
Jeder Befehl gibt JSON aus. Die Umleitung der Ausgabe genügt also, um die Ergebnisse der Auswertung festzuhalten.
MONTH=2025-06
ctrader-cli deals --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --from=01/06/2025 --to=30/06/2025 > ${MONTH}_deals.json
ctrader-cli orders-history --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --from=01/06/2025 --to=30/06/2025 > ${MONTH}_orders.json
ctrader-cli exposure --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q > ${MONTH}_exposure.json
Sie erhalten drei datierte Dateien – eine pro Fragestellung –, die sich leicht mit der Auswertung des Folgemonats vergleichen lassen.
5. Die Schritte zu einem monatlichen Auswertungsskript zusammenfassen ¶
Speichern Sie die gesamte Befehlsfolge als monthly-review.sh. Das Skript berechnet automatisch den ersten und letzten Tag des Vormonats und funktioniert daher unabhängig davon, wann Sie es ausführen.
#!/usr/bin/env bash
set -euo pipefail
CTID=letstrade
ACC=7654321
PWD_FILE=$HOME/.ctrader/pwd
MONTH=$(date -d "last month" +%Y-%m)
FROM=$(date -d "last month" +01/%m/%Y)
TO=$(date -d "last month" +$(date -d "last day of last month" +%d)/%m/%Y)
mkdir -p ${MONTH}
cd ${MONTH}
ctrader-cli deals --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --from=$FROM --to=$TO > ${MONTH}_deals.json
ctrader-cli orders-history --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --from=$FROM --to=$TO > ${MONTH}_orders.json
ctrader-cli exposure --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q > ${MONTH}_exposure.json
echo "Review for ${MONTH} saved to $(pwd)/${MONTH}_*.json"
Führen Sie es einmal im Monat aus, um für jeden Zeitraum einen Ordner mit Zeitstempel zu erstellen. Unter Linux akzeptiert date -d die Ausdrücke last month und last day of last month direkt. Unter macOS verwenden Sie stattdessen das entsprechende gdate aus coreutils oder feste Werte für --from und --to.
6. Muster in den Daten erkennen ¶
Die JSON-Dateien sind so strukturiert, dass sie in einem Notebook oder mit einer einfachen Shell-Pipeline ausgewertet werden können. Zu den üblichen Prüfungen gehören:
- Gewinnquote: Vergleichen Sie die Anzahl der Transaktionen mit positivem Ergebnis mit der Anzahl der Verlusttransaktionen.
- Aufschlüsselung nach Symbol: Gruppieren Sie die Transaktionen nach Symbol und summieren Sie die Gewinne je Gruppe.
- Größter Einzelverlust: Sortieren Sie die Transaktionen nach Gewinn und ermitteln Sie den niedrigsten Wert.
- Risiko offener Positionen: Prüfen Sie anhand der Expositionsdatei, für welche Symbole noch Positionen offen sind.
Ergänzen Sie diese Prüfungen um die Momentaufnahme von account-stats desselben Tages, um die Entwicklung des Kontos im Monatsverlauf vollständig nachzuvollziehen.
Die CLI-Referenz führt alle verfügbaren Optionen der in diesem Ablauf verwendeten Befehle auf.
Warnung
cTrader CLI ist ein Tool für den Handel und die Automatisierung. Es bietet keine Finanz-, Anlage-, Rechts- oder Steuerberatung. Vergangene Ergebnisse sind keine Garantie für zukünftige Ergebnisse. Prüfen Sie jeden Befehl vor der Ausführung, testen Sie ihn zunächst auf einem Demo-Konto und schützen Sie Ihre Anmeldedaten.