Como conectar minha exchange via API (passo a passo)

Conectar a sua exchange por API é a forma mais prática de trazer o histórico para o IR do Investidor: você gera uma chave de leitura na corretora, cola na plataforma e o sistema busca trades, depósitos, saques e rendimentos automaticamente. Todo o processo usa somente permissão de leitura — a plataforma nunca movimenta seus fundos.

Antes de começar

Você vai precisar de duas coisas, ambas geradas na sua própria exchange:

a API Key (uma espécie de identificador da chave);
a API Secret (a senha que acompanha a chave).

Algumas corretoras pedem ainda uma passphrase (caso de OKX, por exemplo) ou exigem que você confirme um e-mail / 2FA ao criar a chave.

Passo a passo geral

O fluxo é parecido em quase todas as exchanges:

Entre na área de API da sua corretora. Costuma ficar em Configurações, Segurança ou "API Management".
Crie uma nova API Key. Dê um nome que você reconheça depois (ex.: "IR do Investidor").
Marque APENAS permissão de leitura. Procure por opções como "Read", "Read-only" ou "Consultar". Deixe desligadas as permissões de saque/transferência e de negociação.
Restrinja por IP, se a exchange permitir. É uma camada extra de segurança, opcional.
Copie a API Key e a API Secret. A Secret normalmente só aparece uma vez — guarde com cuidado nesse momento.
No IR do Investidor, abra a área de conexão de exchanges e cadastre uma nova corretora: escolha a exchange na lista, cole a Key, a Secret (e a passphrase, se houver) e salve.
Aguarde a importação. A plataforma testa a conexão e começa a puxar o histórico. Dependendo do volume de operações, isso pode levar de alguns segundos a alguns minutos.

Suas credenciais ficam protegidas

Duas garantias importantes:

O IR do Investidor só usa chaves read-only (somente leitura). Mesmo que a chave vazasse, não seria possível mover seus fundos com ela.
As credenciais são cifradas ao serem guardadas (criptografia AES-256-GCM), e não ficam visíveis em texto puro depois de salvas.

Depois de conectar: confira o saldo

Assim que a importação terminar, faça uma conferência simples: compare o saldo final que aparece no IR do Investidor com o que você vê dentro da corretora. Se bater, está tudo certo.

Se não bater, normalmente é porque a API daquela exchange não devolveu todo o histórico (algumas limitam o período, outras não retornam operações muito antigas). Nesse caso:

complemente com o CSV exportado da própria corretora; e/ou
use a etapa de reconciliação da plataforma para identificar o que ficou faltando.

Problemas comuns ao conectar

"Chave inválida" ou erro de autenticação — confira se copiou Key e Secret sem espaços extras, e se a passphrase (quando exigida) está correta.
"Sem permissão" — a chave provavelmente foi criada sem a permissão de leitura, ou expirou. Gere uma nova chave read-only.
Restrição de IP — se você ativou trava por IP na exchange, a conexão pode falhar; libere o acesso ou remova a trava.
Histórico incompleto — não é erro de conexão, é limite da API da exchange; resolva com CSV + reconciliação.

Resumo

Conectar via API é gerar uma chave somente leitura na corretora e cadastrá-la na plataforma. As credenciais ficam cifradas, o acesso é read-only, e a importação é automática. Sempre confira o saldo ao final e, se algo faltar, complete com CSV. Em caso de dúvida sobre uma corretora específica, o suporte pode orientar o passo a passo dela.