Analyser les résultats de trading du mois dernier¶

Un bilan mensuel répond à trois questions : combien de trades ont été clôturés, quels résultats ont-ils générés et à quels risques restez-vous exposé ? Ce guide rassemble les transactions, l’historique des ordres terminés et l’exposition actuelle dans un dossier daté, puis les regroupe dans un script que vous pouvez relancer à la fin de chaque mois.

export CTID=letstrade
export ACC=7654321
export PWD_FILE=$HOME/.ctrader/pwd

1. Récupérer les trades clôturés du mois ¶

deals renvoie uniquement les trades clôturés : un enregistrement par transaction de clôture, avec son P&L réalisé. Ce sont les mêmes données que celles de l’onglet Historique de cTrader. --from et --to filtrent les trades selon leur heure de clôture ; --count renvoie les trades clôturés les plus récents. Les exécutions d’ouverture sont exclues : une position n’apparaît dans deals qu’après une clôture totale ou partielle.

ctrader-cli deals --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q \
    --from=01/06/2025 --to=30/06/2025

Chaque trade clôturé comporte notamment le symbole, le sens, le volume, le prix d’exécution et le profit réalisé.

2. Récupérer l’historique des ordres terminés ¶

orders-history répertorie les ordres terminés sur la même période, avec leur statut final (filled, expired, cancelled ou error). Les ordres en cours sont exclus.

ctrader-cli orders-history --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q \
    --from=01/06/2025 --to=30/06/2025

Associez la liste des transactions à l’historique des ordres pour déterminer quelles entrées ont déclenché quelles sorties.

deals et orders-history appliquent les limites d’historique suivantes :

• La CLI charge toute la période définie par --from et --to, sans limitation de durée.
• Un seul appel renvoie au maximum les 200 dernières transactions (deals) ou les 500 derniers ordres (orders-history) de la période.
• Sans --from ni --to, les deux commandes ne renvoient que les 30 derniers jours.

Pour un mois très actif, divisez la période en plusieurs intervalles et exécutez chaque commande une fois par intervalle.

3. Consulter l’exposition actuelle ¶

exposure récapitule l’exposition des positions ouvertes sur le compte, regroupées par symbole. Il s’agit d’un instantané des risques encore présents au lendemain du bilan.

ctrader-cli exposure --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q

4. Enregistrer chaque résultat dans un fichier daté ¶

Chaque commande produit du JSON : il suffit donc de rediriger sa sortie pour conserver les résultats du bilan.

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

Vous obtenez trois fichiers datés, un par question, faciles à comparer à ceux du mois suivant.

5. Regrouper les étapes dans un script de bilan mensuel ¶

Enregistrez la séquence complète sous le nom monthly-review.sh. Le script calcule automatiquement le premier et le dernier jour du mois précédent : vous pouvez donc l’exécuter à tout moment.

#!/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"

Exécutez-le une fois par mois pour créer un dossier horodaté par période. Sous Linux, date -d accepte directement les expressions last month et last day of last month. Sous macOS, utilisez l’équivalent gdate fourni par coreutils ou définissez des valeurs fixes pour --from et --to.

6. Repérer les tendances dans les données ¶

Les fichiers JSON sont structurés pour être analysés dans un notebook ou avec une chaîne de commandes shell. Voici quelques contrôles courants :

• Taux de réussite : comparez le nombre de transactions dont le profit est positif à celui des transactions dont le profit est négatif.
• Répartition par symbole : regroupez les transactions par symbole et additionnez les profits de chaque groupe.
• Perte individuelle la plus importante : triez les transactions selon leur profit et relevez la valeur la plus faible.
• Risque sur les positions ouvertes : consultez le fichier d’exposition pour repérer les symboles sur lesquels des positions restent ouvertes.

Complétez ces vérifications avec l’instantané account-stats du même jour pour mieux comprendre l’évolution du compte au cours du mois.

La documentation de référence de cTrader CLI présente toutes les options disponibles pour les commandes utilisées dans cette procédure.