Os cinco campos obrigatórios
A Edgelog precisa de cinco informações para criar um registro normalizado de operação encerrada: símbolo, lado, preço de entrada, volume ou quantidade e P&L. Símbolo é o nome do instrumento no broker, como EURUSD ou o ticker de um contrato. Lado descreve se a operação foi de compra/long ou venda/short.
Preço de entrada é a execução de abertura ou o preço médio de entrada válido. Volume é a quantidade ou o tamanho da posição. P&L deve ser o resultado realizado daquela linha — não o saldo total da conta, margem, saldo em dinheiro ou lucro acumulado.
Preço de saída, taxas, horário de abertura, horário de fechamento e ID de ticket/transação são campos opcionais quando o relatório os inclui. O importador pode inferir nomes comuns, mas você continua responsável por checar se o mapeamento inferido corresponde ao relatório de origem.
Se um campo obrigatório não estiver presente, use uma exportação diferente em vez de mapear um número sem relação apenas para conseguir importar o arquivo.
Mapeie pelo significado, não pelo rótulo parecido
Relatórios de brokers usam rótulos diferentes. “Instrument”, “pair” ou “contract” podem significar símbolo; “direction”, “action” ou “B/S” podem significar lado; “qty”, “units”, “lots” ou “size” podem significar volume. Mas “price” pode ser um preço médio de execução, preço de mercado atual, preço de fechamento ou preço limite. “Amount” pode ser unidades, valor em moeda de cotação ou movimento de caixa.
“Profit” pode ser bruto ou líquido. Leia a descrição da coluna no relatório e inspecione valores de exemplo antes de aceitar o campo sugerido.
Muitos extratos incluem dados tanto de ordem quanto de execução. Uma ordem pode ser parcialmente executada ou cancelada; uma execução é um preenchimento real. Uma linha com uma execução de abertura e outra de fechamento separada não é automaticamente uma operação completa com valores de entrada e saída.
Escolha um relatório que já agrupe operações encerradas, ou entenda o agrupamento da exportação antes de fazer o mapeamento.
Verifique direção, sinais decimais e unidades
Verifique pelo menos uma compra e uma venda na prévia. A direção deve ser explícita; não deduza a direção com base em o P&L estar positivo ou negativo. Os sinais de lucro e prejuízo devem permanecer intactos: uma operação perdedora não deve se tornar positiva por causa de parênteses, um sinal de menos ou de um separador decimal específico de localidade.
Se os valores usam vírgulas para decimais ou milhares, confira a prévia em vez de assumir que o parser interpretou tudo corretamente.
Confirme também as unidades do volume. Arquivos de Forex podem expressar lots, units ou valores nocionais. Futuros podem informar a contagem de contratos; ações podem informar a quantidade de ações; cripto pode informar a quantidade de moedas. Esses números não são intercambiáveis.
A Edgelog consegue armazenar o tamanho de operação mapeado, mas não conhece o multiplicador do instrumento do broker nem corrige uma escolha errada de unidade para você.
Trate datas e taxas com cuidado
Um arquivo pode conter data da operação, horário de criação da ordem, horário de execução, data de liquidação e horário de fechamento. Só mapeie um timestamp quando você souber que evento ele representa. Relatórios de broker podem usar horário do servidor, UTC, um fuso horário escolhido ou o fuso local da conta.
Compare várias linhas com a plataforma original e mantenha um fuso horário consistente entre lotes.
As taxas podem aparecer como comissão, taxa de bolsa, swap, financiamento ou um resultado líquido combinado. Evite subtrair uma taxa duas vezes: se a coluna de P&L já for líquida de comissão e swap, mapear esses custos novamente pode distorcer a análise. Quando o relatório separar os custos, preserve cada um apenas se você entender o sinal e a convenção de taxas da Edgelog.
Uma rotina de validação com cinco linhas
Antes de importar um histórico grande de conta, inspecione uma compra vencedora, uma compra perdedora, uma venda vencedora, uma venda perdedora e uma linha com taxa ou fechamento parcial, se disponível. Compare instrumento, direção, preços, tamanho, P&L e horários com o relatório de origem. Depois compare a contagem total de operações e o resultado líquido para um intervalo curto de datas.
Só prossiga quando a prévia contar a mesma história que a fonte.
Para passos específicos por broker, comece pelo hub de importação CSV por broker. Se os títulos estiverem corretos, mas o parser indicar campos ausentes ou valores inválidos, use a solução de problemas da importação CSV.