Às vezes, ao criar um robô no TradeSanta, você pode ver o erro “Invalid API Key.”
Neste caso, o robô não começará a negociar, e a barra abaixo da opção “Stop Bot” fica vermelha, mostrando a mesma mensagem — Invalid API Key.
Então, o que isso significa e como você pode corrigir?
⚙️ O que causa o erro “Invalid API Key”
Este erro geralmente significa que sua chave API foi criada com permissões incorretas ou que a lista de permissões de IP não foi configurada corretamente ao conectar sua exchange ao TradeSanta.
Em outras palavras, a chave API não permite que o TradeSanta acesse dados de negociação ou execute negociações devido a configurações ausentes ou incorretas.
Vamos analisar o que você deve verificar dependendo da exchange que está usando.
🟡 Binance
Se você conectou a Binance e viu “Invalid API Key,” verifique as seguintes permissões na sua página de API Management na Binance:
Permissões necessárias:
- ✅ Enable Reading — deve estar on
- ✅ Enable Spot & Margin Trading — deve estar on
- ❌ Enable Withdrawals — deve estar off
- ❌ Enable Symbol Whitelist — deve estar off
- 🔒 Restrições de endereço IP:
- Deve ser Restricted com a lista de permissões de IP do TradeSanta para maior segurança
Você pode encontrar sua lista de IPs única em sua conta TradeSanta em
Your exchanges → Binance → IP List.
Certifique-se de que todos os IPs foram copiados e colados no campo “Restrict access to trusted IPs only” na Binance.
Se a lista de permissões estiver ausente ou incorreta, a chave API não funcionará e o robô mostrará Invalid API Key.
Você pode encontrar a configuração passo a passo completa aqui:
Como criar chave API na Binance
Como ativar a lista de permissões de IP na Binance/Binance Futures
🔵 HTX (Huobi)
Se você estiver usando HTX (anteriormente Huobi), abra sua página de Gerenciamento de API e verifique se as permissões da sua chave correspondem ao seguinte:
Permissões necessárias:
- ✅ Somente leitura — ativado
- ✅ Trade — ativado
- ❌ Withdraw — desativado
- 🌐 Vincular endereço IP: permanecer vazio
Se as suas permissões foram configuradas incorretamente, ou se você não tiver mais a opção de editá-las, crie uma nova chave API e certifique-se de ativar as opções corretas acima.
Você pode encontrar a configuração passo a passo completa aqui:
Como criar chave API na HTX
⚫ OKX
Se você estiver conectando a OKX, verifique as permissões e configurações da sua chave cuidadosamente.
Motivos comuns para “API Key Inválida” na OKX incluem permissão de trade ausente, frase secreta incorreta ou lista branca de IP não configurada.
Permissões necessárias:
- ✅ Read — ativado
- ✅ Trade — ativado
- ❌ Withdraw — desativado
- 🧩 Passphrase: deve corresponder exatamente à que você inseriu no TradeSanta
- 🌐 Lista branca de IP: em branco
Você pode encontrar o guia de configuração completo aqui:
Como criar API na OKX
🧭 O que fazer se o erro persistir
Se a sua chave API foi criada com as permissões ou IPs errados e você não puder mais editá-la, por favor:
- Exclua a chave antiga na sua conta da exchange.
- Crie uma nova chave com as permissões e lista branca de IP corretas.
- Reconecte sua exchange no TradeSanta.
Você pode aprender como substituir com segurança sua chave API antiga por uma nova aqui:
Como atualizar o ponto de acesso com uma nova chave API
✅ Checklist Final
Antes de reconectar, certifique-se de que:
- Todas as permissões necessárias estão ativadas (Read + Trade, sem Withdraw).
- Os IPs do TradeSanta foram adicionados corretamente à lista branca.
- A Passphrase (para OKX) coincide exatamente.
- A chave API e o segredo foram copiados corretamente, sem espaços extras.
Assim que todas as configurações estiverem corretas, reconecte a exchange no TradeSanta — seu bot deve começar a negociar com sucesso.