Como importar histórico via CSV quando a exchange não tem API

Nem toda corretora oferece API — e, mesmo quando oferece, a API às vezes não devolve o histórico mais antigo. Para esses casos, o IR do Investidor aceita importação por arquivo CSV: você exporta o extrato de operações pela própria exchange e sobe o arquivo na plataforma. O sistema entende vários formatos de extrato.

Quando usar o CSV

O CSV é o caminho certo nessas situações:

• a sua corretora não tem integração por API na plataforma;
• a API existe, mas não retornou todo o histórico (período limitado ou dados antigos purgados);
• a exchange fechou e você só tem o extrato que baixou enquanto ela funcionava;
• você quer completar lacunas que a reconciliação apontou.

Passo 1 — Exportar o CSV na exchange

Quase toda corretora tem uma opção de exportar o histórico, geralmente em "Histórico de operações", "Trades", "Relatórios" ou "Exportar". Dicas:

• Prefira o período completo (desde a primeira operação) para não deixar buracos.
• Inclua, se possível, trades, depósitos, saques e rendimentos (staking, juros). Algumas exchanges separam isso em arquivos diferentes — então pode ser mais de um CSV.
• Baixe no formato que a corretora oferecer (CSV ou XLSX são os mais comuns).

Passo 2 — Subir o arquivo no IR do Investidor

1. Na plataforma, abra a área de importação por arquivo.
2. Envie o CSV exportado.
3. A plataforma reconhece o formato e mostra uma prévia das operações lidas.
4. Confirme a importação.

O IR do Investidor já entende vários layouts de CSV de diferentes corretoras. Se o seu arquivo seguir um dos formatos suportados, o reconhecimento é automático.

Passo 3 — Conferir o resultado

Como sempre, confira o saldo final depois de importar. Se algo não bater:

• verifique se você exportou todos os tipos de movimentação (faltou o arquivo de depósitos? de rendimentos?);
• confira se o período do extrato cobre desde a primeira operação;
• use a etapa de reconciliação para localizar o que ainda falta.

Se o seu CSV estiver em um formato diferente

Aqui vale ser transparente: a plataforma cobre os formatos de extrato mais comuns, mas não existe um conversor universal para qualquer layout de qualquer corretora do mundo. Se o seu CSV vier num formato que a plataforma ainda não reconhece, você tem dois caminhos:

• Ajustar o arquivo para um dos modelos aceitos (organizando as colunas de data, ativo, tipo de operação, quantidade, preço e valor); ou
• Falar com o suporte enviando uma amostra do extrato — assim conseguimos orientar a melhor forma de importar (ou avaliar a inclusão daquele formato).

Boas práticas para um CSV limpo

• Não edite valores — só ajuste o layout/colunas se for estritamente necessário.
• Mantenha datas e fusos consistentes (a plataforma trabalha com timestamps).
• Se a corretora gera vários arquivos (spot, futuros, rendimentos), suba todos.
• Guarde os arquivos originais — eles são a sua documentação de custo em caso de questionamento da Receita.

Resumo

Quando não há API, o CSV resolve: exporte o histórico completo da corretora, suba na plataforma e confira o saldo. O IR do Investidor entende vários formatos; se o seu for diferente, ajuste o layout ou acione o suporte. O extrato original também serve como comprovação dos seus custos.