Como Importar o Histórico da Binance, Foxbit e Mercado Bitcoin

Você tem anos de compras espalhadas pela Binance, pela Foxbit e pelo Mercado Bitcoin e quer reunir tudo em um lugar só, com preço médio e lucro calculados. O problema é que o histórico está em três lugares diferentes, em formatos diferentes. Este guia mostra as três formas de trazer esse histórico (conexão por API, arquivo CSV e lançamento manual), explica qual usar em cada caso, detalha os formatos que funcionam e ensina a conferir se nada ficou de fora.

📑 Neste guia

• As três formas de importar
• Opção 1: conexão por API (somente leitura)
• Passo a passo por corretora
• Opção 2: importar arquivo CSV
• Formatos de CSV aceitos
• Opção 3: lançamento manual
• Como conferir se a importação ficou correta
• Problemas comuns e como resolver
• Boas práticas para não bagunçar o histórico
• Perguntas frequentes

🧭 As três formas de importar

Na prática, muita gente combina: conecta por API para o dia a dia e usa o CSV ou o manual para completar o que ficou fora. Se ainda está na dúvida entre planilha e aplicativo, veja o comparativo em planilha ou app para controlar criptomoedas.

🔌 Opção 1: conexão por API (somente leitura)

Uma chave de API é uma credencial que permite que um aplicativo consulte dados da sua conta. Ela vem com permissões configuráveis, e para acompanhar o portfólio você só precisa da permissão de leitura. Com essa permissão, o aplicativo enxerga saldos e histórico, mas não consegue negociar, transferir nem sacar.

🧩 Passo a passo por corretora

Os nomes dos menus podem mudar com o tempo. De forma geral, o caminho é este:

Binance

1. Acesse a área de Gerenciamento de API da sua conta.
2. Clique em Criar API e escolha a opção gerada pelo sistema.
3. Dê um nome fácil de reconhecer (por exemplo, "Cripto Azul").
4. Nas permissões, mantenha apenas a leitura.
5. Copie a API Key e a Secret Key.

Mercado Bitcoin

1. Entre em Configurações e abra a área de API.
2. Clique em Gerar nova credencial (pode ser necessário ativar o dispositivo seguro no celular).
3. Na tela de permissões, marque apenas leitura.
4. Copie o ID (chave de acesso) e o segredo.

Foxbit

1. Acesse Configurações e a área de API.
2. Clique em Criar nova chave de API e dê um nome.
3. Nas permissões, marque apenas leitura.
4. Copie a API Key e a Secret Key. Atenção: a chave secreta costuma ser exibida uma única vez.

Na Cripto Azul, depois de gerar as chaves, você cola a chave e a senha de acesso na tela de conexão de corretoras. Os dados são armazenados de forma criptografada, e a plataforma só lê as informações da sua conta. O plano grátis permite uma corretora; para conectar mais de uma, é preciso um plano superior.

📄 Opção 2: importar arquivo CSV

Quando o histórico é antigo ou a API não traz tudo, o CSV é a saída. Você baixa o extrato de operações na própria corretora e envia o arquivo na área de transações. Alguns detalhes úteis sobre como a importação funciona:

• O sistema tenta reconhecer o formato pelas colunas do arquivo.
• Aceita colunas separadas por vírgula, ponto e vírgula ou tabulação.
• O arquivo pode ter até 5 MB e até 10.000 linhas por importação. Se o seu histórico for maior, divida em arquivos menores, por período.
• Linhas sem quantidade ou sem preço válidos são ignoradas, e o resultado informa quantas foram aproveitadas e quantas ficaram de fora.

🗂️ Formatos de CSV aceitos

Binance: histórico de ordens (Trade History)

O arquivo tem colunas como Date(UTC), Pair, Side, Price, Executed, Amount e Fee. É o formato mais completo da Binance, porque traz o preço de cada operação.

Binance: extrato da conta (Account Statement)

Tem colunas como UTC_Time, Account, Operation, Coin, Change e Remark. Esse formato registra as variações de saldo, mas nem sempre traz o preço. Sem preço, não há como calcular o preço médio corretamente, então prefira o histórico de ordens quando possível.

Mercado Bitcoin

As colunas esperadas são parecidas com Data, Tipo, Moeda, Quantidade, Preço, Total e Taxa.

CSV genérico (qualquer corretora)

Se a sua corretora não tem um formato reconhecido, monte um arquivo simples com as colunas abaixo. Serve inclusive para a Foxbit, quando você prefere trazer o histórico por arquivo:

O tipo aceita buy/sell (ou compra/venda, nos arquivos em português). O preço deve estar em reais, por unidade da moeda, e a taxa (fee) é uma coluna opcional. Esses valores são apenas um modelo de exemplo.

✍️ Opção 3: lançamento manual

O lançamento manual cobre o que as duas outras formas não alcançam:

• Carteira própria: compras e ativos que não estão em corretora. Veja como pensar nisso em corretora ou carteira própria.
• Compras muito antigas que não constam mais em extratos.
• Operações peer-to-peer (P2P) ou feitas fora de corretoras compatíveis.
• Correções pontuais em algo que ficou diferente do esperado.

Para cada operação, registre data, moeda, quantidade, preço unitário em reais e taxa. Quanto mais fiel for ao que aconteceu, mais correto será o preço médio.

✅ Como conferir se a importação ficou correta

Importar sem conferir é o erro mais comum. Faça este roteiro de três verificações:

1. Compare os saldos: o saldo de cada moeda na plataforma deve ser igual ao que a corretora mostra. Se divergir, há operações faltando ou duplicadas, ou transferências que não foram registradas.
2. Confira a contagem: veja quantas linhas foram importadas e quantas foram ignoradas. Muitas linhas ignoradas indicam um formato diferente do esperado.
3. Revise o preço médio: escolha uma moeda e refaça a conta na mão com poucas operações. Se bater, o resto tende a estar certo. Veja como calcular o preço médio e o lucro real.

🛠️ Problemas comuns e como resolver

🧼 Boas práticas para não bagunçar o histórico

• Um método por período: se importar de 2023 a 2025 por CSV, não conecte a API para o mesmo intervalo, para evitar duplicidade.
• Comece pelo mais antigo: importe o histórico em ordem cronológica, do começo para o fim.
• Guarde os arquivos originais: eles são a sua prova do que aconteceu, inclusive para uma eventual declaração.
• Faça a conferência no mesmo dia: logo após importar, compare saldos, enquanto é fácil identificar o que mudou.
• Mantenha atualizado: depois da carga inicial, a conexão por API reduz o trabalho do dia a dia.

Com o histórico organizado, fica fácil acompanhar todas as suas criptomoedas em um só lugar e, quando chegar a hora, calcular o imposto com segurança. O plano grátis da Cripto Azul comporta até 50 transações, o que serve para testar a importação com os seus dados; históricos maiores pedem um plano com transações ilimitadas.

🧭 Conclusão

Importar o histórico é o passo que transforma um monte de extratos soltos em informação útil. Comece pela API somente leitura, complete com CSV e lançamentos manuais quando precisar e, principalmente, confira os saldos no final. Meia hora de organização agora economiza muita dor de cabeça no futuro, seja para saber seu lucro real, seja para a declaração de imposto.

❓ Perguntas frequentes

Como importar o histórico da Binance, Foxbit e Mercado Bitcoin?

Há três formas: conectar a corretora por chave de API somente leitura, importar o arquivo CSV de operações exportado da própria corretora ou lançar as transações manualmente. O ideal é combinar os métodos, sem sobrepor o mesmo período, e conferir os saldos no final.

Conectar a corretora por API é seguro?

Quando a chave é criada apenas com permissão de leitura, ela consulta saldos e histórico, mas não consegue negociar, transferir nem sacar. Nunca habilite permissões de saque ou negociação em chaves usadas apenas para acompanhamento.

Quais formatos de CSV são aceitos?

O histórico de ordens da Binance, o extrato da conta da Binance, o arquivo do Mercado Bitcoin e um CSV genérico com colunas de tipo, moeda, quantidade, preço e data. O arquivo pode ter até 5 MB e 10.000 linhas por importação.

Posso usar API e CSV ao mesmo tempo?

Pode, desde que não sobreponha o mesmo período, porque isso duplica as operações. Uma boa prática é importar o histórico antigo por CSV e usar a API para o período recente.

Como saber se a importação deu certo?

Compare o saldo de cada moeda na plataforma com o da corretora, confira quantas linhas foram importadas e quantas foram ignoradas e refaça na mão o preço médio de uma moeda com poucas operações. Se tudo bater, o histórico está consistente.

Este conteúdo é educativo e não constitui recomendação de investimento nem aconselhamento tributário. Os valores dos exemplos são ilustrativos. Criptoativos são voláteis e você pode perder parte ou todo o valor investido.