A Perly importa o histórico de transações a partir de arquivos CSV — a exportação que toda exchange séria oferece e o único formato que dispensa chaves de API, autorização OAuth e conexão permanente. Veja a seguir como baixar o seu da Binance e o que conferir antes de importá-lo, seja onde for.
A exportação
- Entre na sua conta da Binance pelo site: o aplicativo oculta algumas opções de exportação que o site exibe.
- Abra Orders → Spot Order → Trade History (para operações) ou Wallet → Transaction History para depósitos e saques.
- Procure a opção Export — a Binance a chama de «Export Trade History» ou a disponibiliza em um pequeno ícone de download — e escolha um intervalo de datas. Históricos longos podem precisar ser exportados em partes, pois a Binance limita quantos meses um único arquivo pode abranger.
- Selecione CSV como formato e confirme. Exportações maiores são geradas de forma assíncrona e aparecem abaixo do botão de exportação quando ficam prontas.
- Baixe o arquivo e abra-o ao menos uma vez antes de importar: o que você procura é uma linha por execução, com as colunas date, pair, side, price, quantity e fee.
As interfaces das exchanges mudam, e os nomes dos menus também. Se algum dos rótulos acima tiver mudado, o recurso continua lá — procure «export history CSV» na central de ajuda da própria exchange.
Antes de importar
- Os horários registrados pela Binance estão em UTC. A Perly armazena o horário de execução que você informa, portanto importe-os como estão: a consistência é mais importante do que o fuso horário.
- Na Binance, as taxas costumam ser cobradas no ativo comprado (ou em BNB). Uma taxa cobrada em BTC reduz o que você de fato recebeu; confira como suas linhas a registram antes de confirmar uma importação.
- Se você negociou BTC contra moedas diferentes da sua moeda base, cada linha ainda precisa de um preço nessa moeda para que o custo de aquisição faça sentido.
O que a importação faz
A Perly detecta as colunas, mostra cada linha que pretende gravar, sinaliza as prováveis duplicatas e as deixa desmarcadas. Nada é gravado até você confirmar — um registro em que não se pode confiar é pior do que nenhum registro, e o caminho mais curto para chegar a um assim é uma importação silenciosa. Em seguida, o custo de aquisição, o PnL e o ROI são recalculados a partir do seu histórico completo; os cálculos estão explicados no guia Custo médio versus FIFO.