Um diário de trades tem duas metades. Uma é o plano: por que você entrou, o que esperava, quão calmo estava, o que fez de errado. Ninguém pode escrever essa metade por você, e ela leva trinta segundos por trade. A outra metade é o recibo: as execuções, os preços, a corretagem e o swap, o líquido que a corretora de fato liquidou. Essa metade a plataforma já tem, e digitá-la de novo é onde os diários erram em silêncio: um preço de entrada arredondado, uma saída parcial esquecida, um swap deixado de fora. Sincronização ao vivo é a metade do recibo chegando sozinha, para que os trinta segundos que você gasta vão para a metade que te ensina algo.

Este artigo explica como o SetupBook se conecta ao MetaTrader 4 e 5, cTrader, Bybit, Binance e OKX, o que cada conexão pode e não pode fazer, e quando a velha importação de arquivo ainda é a ferramenta melhor. Tudo o que está descrito aqui é somente leitura. A sincronização e a importação de arquivos fazem parte do Pro, e todo diário começa com 14 dias de Pro.

Como é um trade sincronizado

Um trade sincronizado é um trade comum no diário com uma diferença: os campos que vieram da plataforma ficam travados. Símbolo, direção, horário de abertura e fechamento, cada execução com preço e tamanho, corretagem, taxas e o resultado líquido pertencem à plataforma e são sobrescritos a cada sincronização. Stop, alvo, risco, estratégia, qualidade do setup, emoção, calma na entrada, erros, capturas de tela e as quatro notas são seus, e a sincronização nunca mexe neles.

Dois detalhes valem a pena saber. Primeiro, o líquido é o que a corretora liquidou, não o que a aritmética dos preços diz. Em um par cruzado, ou quando um swap caiu durante a noite, os dois diferem; o diário mostra o valor liquidado e o marca como corretora para você ver por quê. Segundo, se você remover uma conexão, os trades dela ficam e voltam a ser editáveis. Não se perde nada ao experimentar.

MetaTrader 4 e 5

O MetaTrader não tem API pública, então a conexão funciona ao contrário: um pequeno Expert Advisor (EA) dentro do terminal lê o histórico da conta e o envia ao diário. O EA é somente leitura. Ele nunca abre, altera ou fecha uma ordem, e não precisa de permissão de negociação para rodar.

Configurá-lo leva três passos, mostrados no diálogo quando você cria a conexão. Cada clique com imagens, para Windows e Mac, está no guia do MetaTrader 4 e no guia do MetaTrader 5.

  1. Crie uma conexão MetaTrader 5 ou MetaTrader 4 em Contas → Conexões e copie o token que ela mostra. O token é mostrado uma vez; é o único segredo que o EA guarda, e ele só consegue escrever nessa única conexão.
  2. Coloque o arquivo do EA (baixado do mesmo diálogo) na pasta MQL5/Experts (ou MQL4/Experts) do terminal. Para o MetaTrader 4 é o SetupBookSync.ex4 já compilado, pronto para usar; para o MetaTrader 5 é o SetupBookSync.mq5, que você abre no MetaEditor e compila com F7. Depois permita https://setupbook.io em Tools → Options → Expert Advisors → Allow WebRequest for listed URL. Sem esse último passo o MetaTrader bloqueia toda requisição em silêncio.
  3. Arraste o EA para qualquer gráfico, cole o token nos inputs e confirme que a carinha no canto do gráfico não está riscada.

A primeira execução envia todo o histórico da conta. Depois disso cada negócio novo chega em segundos enquanto o terminal estiver aberto, e o stop e o alvo das suas posições abertas seguem o terminal, então um stop movido aparece no diário como movido. Quando o terminal está fechado nada é enviado; na próxima vez que abrir, o EA recupera de onde parou.

Uma armadilha específica do MetaTrader: o relógio do servidor da corretora. A maioria das corretoras roda em UTC+2 no inverno e UTC+3 no verão, mudando nas datas do horário de verão de Nova York, mas algumas rodam em UTC o ano todo. O diário assume a regra de Nova York e permite trocá-la por conexão; se as suas aberturas por dia operado e por sessão parecem deslocadas em uma hora, essa configuração é a primeira coisa a conferir.

cTrader

O cTrader tem uma API de verdade, então a conexão é um login. Aperte Continuar para o cTrader, entre com o seu cTrader ID e aprove o pedido. A permissão solicitada é accounts, que é somente leitura; o diário não pode operar, depositar nem sacar. Cada conta de trading sob o seu cTrader ID volta como uma conexão própria, real e demo igualmente, e você escolhe qual conta do SetupBook cada uma alimenta.

Os negócios são puxados, não enviados: aperte Sincronizar agora para a primeira busca, e depois disso o diário busca os novos negócios em uma programação. A primeira busca alcança até onde a corretora guarda histórico.

Cada clique com imagens está no guia do cTrader.

Bybit, Binance e OKX

As exchanges se conectam com uma chave de API. Crie uma na página de gerenciamento de API da exchange com permissões somente leitura e nada mais: sem negociação, sem saques, sem transferências. Cole a chave e o secret no diálogo da conexão (a OKX também pede a passphrase que você definiu ao criar a chave), marque os mercados que você opera (spot, perpétuos com margem em USDT) e salve. O diário confere as permissões da chave e avisa se ela pode mais do que ler; se você vir esse aviso, apague a chave na exchange e crie uma somente leitura.

Cada exchange limita até onde a API volta no tempo. A Bybit devolve cerca de dois anos de execuções, a Binance e a OKX cerca de três meses. Para histórico mais antigo, exporte o arquivo de histórico de trades da exchange e importe; os dois caminhos pulam duplicatas um contra o outro. As execuções são agrupadas em posições do mesmo jeito que a importação de arquivo faz, então uma posição fechada em três partes é um trade com três saídas. Contratos com margem em moeda (inversos) ainda não são suportados.

Cada passo com imagens: o guia da Bybit, o guia da Binance e o guia da OKX.

Como os segredos são guardados

Chaves de exchange e tokens do cTrader ficam no servidor, selados com AES-256-GCM sob uma chave que nunca sai do servidor, para que uma sincronização programada possa rodar enquanto o seu celular está no bolso. Tokens do MetaTrader são guardados só como hash SHA-256; se o banco de dados fosse lido, os tokens não poderiam ser recuperados dele. Nada disso é legível pelo navegador, e nada disso é jamais enviado a terceiros. Uma chave pode ser revogada na exchange a qualquer momento e a conexão simplesmente para.

Quando importar um arquivo ainda é melhor

A sincronização não substitui a importação, ela se junta a ela. Use um arquivo quando:

  • a plataforma não está na lista (TradingView, uma corretora de futuros, o painel de uma mesa proprietária, uma planilha);
  • o histórico é mais antigo do que a API da exchange alcança;
  • a conta está encerrada e o terminal já se foi, mas você ainda tem o relatório;
  • você quer um único preenchimento limpo e nenhuma conexão depois.

O guia de importação cobre cada formato de arquivo e a armadilha do fuso horário que corrompe as estatísticas por hora do dia.

Qual caminho para qual trader

Você opera em Melhor caminho O que você recebe
MetaTrader 4 ou 5 Expert Advisor cada negócio em segundos, stops e alvos acompanhados
cTrader login com cTrader ID todas as suas contas, puxadas em uma programação
Bybit, Binance, OKX chave de API somente leitura execuções agrupadas em posições, dois anos ou três meses para trás
qualquer outra coisa importação de arquivo um preenchimento limpo por relatório
uma conta nova sem histórico à mão trinta segundos por trade, tamanho da posição pela calculadora

Seja qual for o caminho do recibo, a metade do plano continua sua: marque a estratégia, avalie o setup, anote o que sentiu, marque o erro. Essa é a parte que muda o próximo trade, e é a parte que nenhuma sincronização consegue fazer.

As conexões ficam em Contas → Conexões e fazem parte do Pro. Todo diário começa com 14 dias de Pro, então dá para conectar a sua plataforma no primeiro dia. O guia do usuário percorre cada diálogo com capturas de tela.