Binance: como gerar a API key read-only e importar para o IR do Investidor

A Binance é uma das exchanges mais usadas por investidores brasileiros e tem integração por API no IR do Investidor. Este guia mostra como gerar uma chave somente leitura na Binance e conectá-la à plataforma — sem nunca dar permissão para movimentar seus fundos.

Importante: a Binance é exchange do exterior

Antes do passo a passo, vale o lembrete fiscal: a Binance é uma corretora estrangeira. Para fins de imposto, suas operações nela entram no regime de aplicação financeira no exterior (Lei 14.754/2023), com apuração anual e alíquota de 15% — diferente do regime de ganho de capital mensal das corretoras brasileiras. O IR do Investidor já faz essa separação automaticamente; você não precisa classificar nada manualmente.

Passo 1 — Criar a API Key na Binance

1. Faça login na Binance e vá até a área de API Management (Gerenciamento de API), normalmente no menu do perfil/conta.
2. Crie uma nova chave do tipo System generated (gerada pelo sistema).
3. Dê um nome reconhecível à chave, por exemplo "IR do Investidor".
4. Confirme com 2FA / e-mail, como a Binance exigir.

Passo 2 — Configurar as permissões (só leitura)

Esta é a etapa mais importante:

• Mantenha ligada apenas a permissão de leitura (Enable Reading).
• Deixe desligadas as permissões de Spot & Margin Trading e de Withdrawals (saque).
• Se você usa a opção de restrição por IP, pode ativá-la para uma camada extra de segurança (opcional).

Com isso, a chave consegue consultar seu histórico, mas não consegue negociar nem sacar nada.

Passo 3 — Copiar Key e Secret

Ao concluir, a Binance mostra a API Key e a Secret Key. A Secret normalmente aparece uma única vez — copie e guarde nesse momento. Se você perder a Secret, terá que apagar a chave e gerar outra.

Passo 4 — Conectar no IR do Investidor

1. No IR do Investidor, abra a área de conexão de exchanges e adicione uma nova corretora.
2. Selecione Binance na lista.
3. Cole a API Key e a Secret Key (sem espaços extras).
4. Salve. A plataforma testa a conexão e começa a importar trades, depósitos, saques e rendimentos.

Suas credenciais são guardadas cifradas (AES-256-GCM) e o acesso é read-only — a plataforma nunca movimenta seus fundos.

Passo 5 — Conferir o resultado

Quando a importação terminar, compare o saldo final mostrado no IR do Investidor com o que você vê na própria Binance.

Se não bater, geralmente é porque a API não devolveu todo o histórico antigo (limites de período são comuns em qualquer exchange). Nesse caso:

• exporte o CSV de operações pela própria Binance e suba o arquivo na plataforma; e/ou
• use a etapa de reconciliação para identificar o que ficou faltando.

Problemas comuns

• Erro de autenticação — confira se copiou Key e Secret completas, sem espaços.
• "Sem permissão" — a chave foi criada sem "Enable Reading", ou expirou; gere uma nova read-only.
• Histórico incompleto — não é falha de conexão, é limite da API; complete com CSV + reconciliação.
• Conexão recusada por IP — se você travou a chave por IP na Binance, ajuste ou remova a trava.

Resumo

Gere na Binance uma chave só com leitura (sem trade e sem saque), copie Key e Secret, e cadastre em Binance no IR do Investidor. As credenciais ficam cifradas, o acesso é read-only, e a apuração já trata a Binance como ativo no exterior. Sempre confira o saldo ao final e complete com CSV se faltar histórico.

Aviso: este conteúdo é educativo e não substitui a orientação de um contador. A classificação fiscal das suas operações na Binance segue a Lei 14.754/2023; consulte um profissional para a sua situação.