Resolução de problemas na importação CSV

Corrigir erros comuns de importação CSV do broker num diário de trading

Quando um ficheiro do broker falha na importação, a causa normalmente é visível na linha de cabeçalho, nos valores de exemplo ou no tipo de relatório. Comece por identificar a primeira linha que não representa uma negociação concluída; depois verifique os campos obrigatórios e as convenções usadas nessa exportação.

Esta checklist é para a importação manual de trades em CSV/Excel do Edgelog. Ela não diagnostica login no broker, ligação por API em tempo real ou sincronização via EA MT4/MT5. Mantenha o ficheiro original privado e use uma pequena amostra anonimizada quando precisar de ajuda com o formato.

Erro: está a faltar um campo obrigatório

O importador precisa de símbolo, lado (direção), preço de entrada, volume ou quantidade e P&L. Se a pré-visualização indicar que um deles está em falta, verifique se o relatório selecionado é um resumo sem trades individuais, se o cabeçalho está numa linha posterior ou se a exportação do broker contém ordens e execuções em secções separadas.

Tente uma exportação de histórico de trades com uma linha por trade fechado. Não mapeie saldo da conta, preço atual, depósitos totais ou outra coluna não relacionada para o campo em falta.

Se um cabeçalho obrigatório estiver presente mas não for reconhecido, abra o guia de mapeamento de colunas. O cabeçalho pode usar um nome alternativo como “instrument”, “quantity”, “direction” ou “realized P&L”. Confirme pelo significado, não por tentativa e erro.

Erro: preço de entrada ou volume inválido

O preço de entrada tem de ser um número positivo e o volume tem de ser maior que zero. Verifique se há símbolos de moeda, separadores específicos de localização, marcadores de texto ou uma linha na folha de cálculo que contenha um subtotal em vez de um trade.

Certifique-se de que a coluna de quantidade não está em branco e de que o preço escolhido é de entrada ou média de entrada — não um preço de saída nem uma cotação de mercado. Um volume expresso em unidades, contratos, ações ou lotes deve ser interpretado de forma consistente com a sua conta de origem.

Se o seu ficheiro usar vírgula como separador decimal, separadores de milhar ou negativos entre parênteses, inspecione cuidadosamente os valores na pré-visualização. Guarde um novo CSV diretamente do broker se, ao abrir e voltar a guardar o ficheiro, o formato numérico tiver sido alterado.

Erro: compra/venda ou P&L parecem invertidos

A direção deve vir da coluna de side/type/action do broker, não de o trade ter sido vencedor ou perdedor. Compare uma venda/short conhecida e uma compra/long conhecida com o histórico do broker. Confirme que o P&L usa um valor realizado com sinal e que uma perda continua negativa.

Se o relatório tiver P&L bruto e líquido, determine qual pretende usar; se comissão e swap já estiverem incluídos no P&L líquido, não os subtraia novamente.

Erro: timestamps em falta ou deslocados

Um timestamp pode ser opcional, mas quando está presente deve representar o evento que pretende rever. As exportações dos brokers podem usar hora do servidor, UTC, hora local ou um fuso horário explícito no relatório. Compare a mesma execução no terminal do broker e no CSV.

O guia do HUB da OANDA, por exemplo, diz que o seu relatório usa o fuso horário selecionado; Exness e o histórico do MetaTrader podem seguir as suas próprias convenções de exportação. Registe o fuso horário e mantenha-o consistente entre lotes.

Erro: contagem de trades ou resultado líquido não coincidem

Compare a mesma conta, estado fechado/aberto, intervalo de datas, moeda e filtros de relatório em ambos os produtos. Verifique se a exportação inclui fechos parciais como linhas separadas, se agrupa múltiplas execuções, se exclui histórico arquivado ou se inclui depósitos e comissões. Um ficheiro com uma linha por execução pode não corresponder a um resumo com uma linha por posição.

Não apague linhas apenas para forçar a coincidência dos totais; primeiro entenda o que cada linha representa.

Ao importar um segundo lote, escolha a conta já existente que representa a mesma conta do broker e use limites de datas claros. Evite períodos sobrepostos enquanto estiver a diagnosticar. Mantenha um registo dos intervalos já importados e reveja duplicados na pré-visualização antes de prosseguir.

Erro: o workbook tem várias folhas ou secções de relatório

Escolha a folha que contém as linhas de trades, e não um resumo, balanço ou tabela de referência de instrumentos. Se o extrato estiver seccionado ou combinar atividades não relacionadas, crie uma cópia limpa com uma única linha de cabeçalho e apenas as linhas de trades concluídos e as colunas necessárias. Preserve o original em privado para poder comparar e repetir a transformação.

Nunca inclua credenciais, palavras-passe, chaves de API ou PINs de suporte no ficheiro.

Checklist de recuperação segura

  1. Cancele o upload atual e mantenha o ficheiro de origem inalterado.
  2. Exporte um intervalo de datas menor apenas com trades fechados ou um relatório focado em trades.
  3. Remova identificadores pessoais/de conta de qualquer amostra que partilhar.
  4. Confirme os cinco campos obrigatórios e faça o mapeamento de cada um conforme o significado documentado.
  5. Compare cinco linhas representativas e os totais com os do broker.
  6. Só volte a tentar depois de a pré-visualização estar correta.

Para orientação passo a passo de exportação, use o hub de importação CSV de brokers, o guia da Exness, o guia da OANDA ou o guia da IBKR.

Perguntas frequentes

QPorque é que um CSV válido indica que falta um campo?

A exportação pode não incluir esse campo de trade, usar um cabeçalho pouco familiar ou ter uma linha de título/resumo antes da tabela. Selecione uma exportação focada em trades e confirme os mapeamentos na pré-visualização.

QPorque é que a direção das trades importadas parece errada?

Verifique se a coluna mapeada é o side ou direção real do broker e compare linhas de compra e venda conhecidas. Nunca deduza a direção com base em o P&L ser positivo.

QPosso partilhar o meu CSV do broker com o suporte?

Partilhe apenas uma pequena amostra anonimizada, se necessário. Remova nomes, números de conta, saldos, identificadores de tickets e quaisquer credenciais ou segredos antes de enviar.

QDevo forçar a coincidência dos totais do CSV apagando linhas?

Não. Primeiro identifique se as linhas representam execuções, posições, fechos parciais, comissões ou eventos de conta. Remover linhas válidas pode tornar o diário impreciso.

Registre suas operações. Domine sua vantagem.

Grátis para sempre para traders de forex e cripto — até 3 contas conectadas e 50.000 operações armazenadas, com auto-sync de MT4/MT5, importação de exchanges e análises completas.

Crie seu diário grátis