Rever as negociações do último mês¶

Uma revisão mensal responde a três perguntas: quantas negociações foram fechadas, que resultados produziram e onde continua a existir risco? Este guia reúne as transações, o histórico de ordens concluídas e a exposição atual numa pasta com data. Em seguida, combina os passos num script que pode voltar a executar no final de cada mês.

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

1. Obter as negociações fechadas durante o mês ¶

deals devolve apenas negociações fechadas: um registo por transação de fecho, com o P&L realizado. São os mesmos dados apresentados no separador Histórico do cTrader. --from e --to filtram as negociações pela hora de fecho; --count devolve as negociações fechadas mais recentes. As execuções de abertura não estão incluídas, pelo que uma posição só aparece em deals depois de ser fechada total ou parcialmente.

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

Para cada negociação fechada, a saída inclui o símbolo, o sentido da negociação, o volume, o preço de execução e o lucro realizado.

2. Obter o histórico de ordens concluídas ¶

orders-history apresenta as ordens concluídas no mesmo intervalo, com o respetivo estado final (filled, expired, cancelled ou error). As ordens pendentes estão excluídas.

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

Compare a lista de transações com o histórico de ordens para perceber quais as entradas que deram origem a cada saída.

deals e orders-history têm os seguintes limites de histórico:

• A CLI carrega todo o intervalo definido por --from / --to, sem limite de duração.
• Uma única chamada devolve apenas as últimas 200 transações (deals) ou as últimas 500 ordens (orders-history) do intervalo.
• Sem --from / --to, ambos os comandos devolvem apenas os dados dos últimos 30 dias.

Se tiver realizado muitas negociações durante o mês, divida o intervalo em períodos mais curtos e execute cada comando uma vez por período.

3. Consultar a exposição atual ¶

exposure resume a exposição das posições abertas na conta, agrupadas por símbolo. É uma visão instantânea do risco a que a conta continua exposta no dia seguinte à revisão.

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

4. Guardar cada resultado num ficheiro com data ¶

Cada comando produz dados JSON, pelo que basta redirecionar a saída para guardar um registo da revisão.

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

Três ficheiros com data, um para cada pergunta, fáceis de comparar com os da revisão do mês seguinte.

5. Reunir os passos num script de revisão mensal ¶

Guarde a sequência completa como monthly-review.sh. O script calcula automaticamente o primeiro e o último dia do mês anterior, pelo que funciona independentemente da data em que o executar.

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

Execute-o uma vez por mês para criar uma pasta com data e hora para cada período. Em Linux, date -d aceita diretamente as expressões last month e last day of last month. Em macOS, utilize o equivalente gdate das coreutils ou valores fixos para --from e --to.

6. Identificar padrões nos dados ¶

Os ficheiros JSON estão estruturados para serem analisados num notebook ou através de uma sequência simples de comandos de shell. Entre as verificações mais comuns estão:

• Taxa de negociações vencedoras: compare o número de transações com lucro positivo com o das que registaram perdas.
• Desagregação por símbolo: agrupe as transações por símbolo e some os lucros de cada grupo.
• Maior perda individual: ordene as transações pelo lucro e identifique o valor mais baixo.
• Risco das posições abertas: consulte o ficheiro de exposição para ver em que símbolos ainda existem posições abertas.

Combine estas verificações com o registo de account-stats do mesmo dia para compreender melhor como a conta evoluiu ao longo do mês.

A documentação de referência do cTrader CLI apresenta todas as opções disponíveis para os comandos utilizados neste procedimento.