Esaminare il trading del mese scorso¶

Un riepilogo mensile risponde a tre domande: quante operazioni sono state chiuse, quali risultati hanno prodotto e dove si concentra ancora il rischio. Questa guida raccoglie le operazioni, la cronologia degli ordini completati e l’esposizione attuale in una cartella datata, poi riunisce i passaggi in uno script da eseguire alla fine di ogni mese.

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

1. Recuperare le operazioni chiuse nel mese ¶

deals restituisce soltanto le operazioni chiuse: un record per ogni operazione di chiusura, con il P&L realizzato. Sono gli stessi dati disponibili nella scheda Cronologia di cTrader. --from e --to filtrano le operazioni per orario di chiusura; --count restituisce quelle chiuse più di recente. Le esecuzioni di apertura non sono incluse, quindi una posizione appare in deals solo dopo una chiusura totale o parziale.

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

Per ogni operazione chiusa, l’output comprende il simbolo, la direzione, il volume, il prezzo di esecuzione e il profitto realizzato.

2. Recuperare la cronologia degli ordini completati ¶

orders-history elenca gli ordini conclusi nello stesso intervallo, con lo stato finale (filled, expired, cancelled oppure error). Gli ordini in sospeso sono esclusi.

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

Confronta l’elenco delle operazioni con la cronologia degli ordini per capire quali ingressi hanno determinato le successive uscite.

I comandi deals e orders-history prevedono i seguenti limiti per la cronologia:

• La CLI carica l’intero intervallo definito da --from e --to, senza limiti di durata.
• Una singola chiamata restituisce al massimo le ultime 200 operazioni (deals) o gli ultimi 500 ordini (orders-history) dell’intervallo.
• Senza --from e --to, entrambi i comandi restituiscono soltanto i dati degli ultimi 30 giorni.

Se durante il mese si sono svolte molte operazioni, suddividi l’intervallo in periodi più brevi ed esegui i comandi per ciascun periodo.

3. Consultare l’esposizione attuale ¶

exposure riepiloga l’esposizione delle posizioni aperte sul conto, raggruppata per simbolo. È un’istantanea del rischio ancora presente il giorno successivo al riepilogo.

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

4. Salvare ciascun risultato in un file con data ¶

Ogni comando produce dati JSON, quindi basta reindirizzare l’output per conservare una registrazione del riepilogo.

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

Tre file con data, uno per ogni domanda, facili da confrontare con il riepilogo del mese successivo.

5. Riunire i passaggi in uno script di riepilogo mensile ¶

Salva l’intera sequenza come monthly-review.sh. Lo script calcola automaticamente il primo e l’ultimo giorno del mese precedente, quindi puoi eseguirlo in qualsiasi momento.

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

Eseguilo una volta al mese per ottenere una cartella con data e ora per ogni periodo. Su Linux, date -d accetta direttamente le espressioni last month e last day of last month. Su macOS, usa l’equivalente gdate di coreutils oppure imposta valori fissi per --from e --to.

6. Individuare gli schemi ricorrenti nei dati ¶

I file JSON sono strutturati in modo da poter essere analizzati in un notebook oppure con una semplice pipeline di comandi shell. Tra le verifiche più comuni:

• Percentuale di operazioni vincenti: confronta il numero di operazioni con profitto positivo con quello delle operazioni in perdita.
• Ripartizione per simbolo: raggruppa le operazioni per simbolo e somma i profitti di ciascun gruppo.
• Maggiore perdita su una singola operazione: ordina le operazioni per profitto e individua il valore più basso.
• Rischio sulle posizioni aperte: consulta il file dell’esposizione per vedere su quali simboli ci sono ancora posizioni aperte.

Confronta queste verifiche con l’istantanea di account-stats dello stesso giorno per comprendere meglio come il conto è cambiato nel corso del mese.

La documentazione di riferimento di cTrader CLI elenca tutte le opzioni disponibili per i comandi utilizzati in questa procedura.