Erros comuns de importação e como resolver
A maioria dos problemas ao importar exchanges, carteiras ou arquivos cai em um punhado de causas conhecidas. Este guia reúne os erros mais frequentes e o caminho prático para resolver cada um. Vale a transparência logo de início: o IR do Investidor não tem (ainda) uma base de conhecimento interna de troubleshooting passo a passo dentro do produto — então, se o seu caso não estiver aqui, o caminho é completar os dados manualmente e, persistindo, acionar o suporte.
1. "Chave de API inválida" ou erro de autenticação
Causa provável: Key/Secret copiadas com espaço extra, incompletas, ou passphrase errada (em exchanges que pedem, como OKX).
Como resolver:
- recopie a API Key e a Secret sem espaços nas pontas;
- confirme a passphrase, quando a exchange exigir;
- se a chave foi revogada/expirada, gere uma nova chave read-only e atualize as credenciais.
2. "Sem permissão" / acesso negado
Causa provável: a chave foi criada sem a permissão de leitura, ou com trava de IP que bloqueia o acesso.
Como resolver:
- gere a chave novamente marcando só leitura (read-only) — nunca trade ou saque;
- se você ativou restrição por IP na corretora, ajuste ou remova a trava.
3. Importou, mas o saldo não bate
Causa provável: a API da exchange não devolveu todo o histórico (período limitado, dados antigos purgados), ou faltou algum tipo de movimentação (depósito, saque, rendimento).
Como resolver:
- exporte o CSV completo da exchange e suba para preencher o que faltou;
- confira se você trouxe todos os tipos de operação (algumas corretoras separam spot, futuros e rendimentos em arquivos diferentes);
- use a etapa de reconciliação para localizar exatamente o que está faltando.
4. CSV não foi reconhecido
Causa provável: o arquivo está em um formato/layout que a plataforma ainda não entende.
Como resolver:
- confira se exportou o extrato no formato certo da própria corretora;
- ajuste o layout para um modelo aceito (colunas de data, ativo, tipo, quantidade, preço, valor);
- se ainda assim não reconhecer, envie uma amostra do arquivo ao suporte.
5. Saldo duplicado depois de reimportar
Causa provável: a mesma operação entrou por dois caminhos (API + CSV, por exemplo), ou uma transferência entre carteiras não foi conciliada.
Como resolver:
- concilie as transferências entre suas carteiras (saída de um lado, entrada do outro) como a mesma operação;
- use a reconciliação para identificar entradas em duplicidade.
6. Carteira on-chain com saldo faltando
Causa provável: você adicionou só um dos vários endereços/redes da carteira, ou a rede/token não é lida automaticamente.
Como resolver:
- adicione todos os endereços e todas as redes que você movimentou;
- para redes/tokens muito específicos, complemente com lançamento manual a partir do explorador de blocos.
7. Interactive Brokers não importou
Causa provável: Token/Query ID do Flex Query incorretos, query sem as seções necessárias, ou mais de uma conta IB não contemplada.
Como resolver:
- confira o Token e o Query ID no portal da IB;
- garanta que a Flex Query inclui operações e posições;
- se você tem múltiplas contas IB, contemple todas.
Quando nada disso resolver
Se o seu erro não está nesta lista ou o problema persiste depois de tentar o caminho acima, fale com o suporte. Descreva:
- a exchange/carteira envolvida;
- o método usado (API, CSV, on-chain, IB);
- a mensagem de erro ou o sintoma (ex.: saldo divergente, ativo faltando);
- o que você já tentou.
Quanto mais detalhes, mais rápido conseguimos orientar a solução.
Resumo
A maioria dos erros de importação é autenticação (chave/permissão) ou histórico incompleto (resolve com CSV + reconciliação). Para CSV não reconhecido, ajuste o layout ou mande amostra ao suporte. Como ainda não há uma central de troubleshooting dentro do produto, em casos fora do comum o suporte é o caminho — com os detalhes do erro em mãos.