Em resumo: a chave de API da BingX é criada no site, em Conta, Gerenciamento de API, e exige autenticação em dois fatores com Google Authenticator. Marque só as permissões que o uso exige: leitura para ferramentas de imposto e acompanhamento, negociação de spot ou futuros para robôs. Ative a restrição para IPs confiáveis, nunca libere saque e guarde a secret key no momento da criação, porque ela aparece uma única vez.
Uma chave de API permite que um programa fale com a sua conta da BingX sem a sua senha: um robô que envia ordens, uma planilha que lê saldos ou um sistema de imposto que importa o histórico. É prático e, se mal configurado, perigoso: quem tem a chave faz tudo o que as permissões dela autorizam. Este guia é o passo a passo prático na BingX. A parte técnica, com assinatura HMAC, biblioteca ccxt e exemplos em Python, está no nosso guia de API de corretora cripto.
Regras de ouro da chave de API
Você precisa mesmo de uma API?
Antes de gerar a chave, confira se ela é necessária. Na BingX, várias automações funcionam sem API:
- Robôs grid e martingale rodam dentro da própria corretora, sem chave. Veja grid bot e robôs de trading da BingX.
- Alertas do TradingView podem virar ordens pelo Signal Trading, que usa webhook e dispensa programar. O passo a passo está em Signal Trading com TradingView.
- Copy trading também não precisa de chave para quem copia. Veja copy trading na BingX.
A API faz sentido quando você roda um robô próprio (em Python, por exemplo), conecta uma plataforma externa de automação ou usa um sistema que importa o histórico para calcular imposto. Se esse é o seu caso, siga em frente. Para começar a programar, veja como criar um robô de trading e Python para trading.
Antes de criar: prepare a conta
- Autenticador ativado. O tutorial da HASH7 para a BingX informa que só é possível criar chaves com o autenticador do Google ativado, e o guia da Cryptohopper mostra que a BingX pede código de e-mail e do Google Authenticator na criação.
- Proteções da conta ligadas. Código anti-phishing, whitelist de endereços de saque e passkey reduzem o estrago se alguém tentar usar a conta. A BingX explica os recursos em código anti-phishing e whitelist e no guia de passkey.
- Use o computador. O tutorial da HASH7 recomenda fazer pela versão web.
- Considere uma subconta. O guia da Cryptohopper cita a opção de gerenciar subcontas: deixar o robô numa subconta com saldo limitado isola o risco do resto do patrimônio.
Passo a passo para criar a chave
O caminho abaixo foi montado a partir dos guias de conexão da Cryptohopper, da Altrady e da HASH7 para a BingX. Os nomes dos botões podem variar com a versão do site e o idioma.
- Abra o Gerenciamento de APINo site, clique no ícone da conta, no canto superior direito, e escolha Gerenciamento de API (API Management).
- Crie a chaveClique em Criar API, escolha a conta (principal ou subconta) e dê um nome que identifique o uso, como “robo-spot-vps”.
- Confirme a identidadeDigite o código enviado por e-mail e o código do Google Authenticator.
- Copie a API key e a secret keyA secret key aparece só agora. Guarde num gerenciador de senhas. Se fechar a janela sem copiar, terá de criar outra chave.
- Defina as permissõesEm Editar, marque só o necessário: leitura, negociação spot ou negociação de futuros. Nunca marque saque.
- Restrinja por IPAtive a opção de restringir acesso a IPs confiáveis e cole o IP fixo do servidor ou da plataforma que vai usar a chave.
- Salve e confirme de novoClique em Salvar e confirme com e-mail e autenticador. Só então cole a chave na ferramenta.
Qual permissão marcar para cada uso
| Uso | Permissão | Restrição de IP |
|---|---|---|
| Planilha ou painel que só lê saldo | Leitura | Recomendada |
| Sistema de imposto ou contabilidade | Leitura (a Cryptact pede apenas “Read”) | Recomendada, se o serviço informar IPs |
| Robô de spot | Leitura e negociação spot | Obrigatória na prática |
| Robô de futuros | Leitura e negociação de futuros | Obrigatória na prática |
| Qualquer uso | Saque: nunca | Não se aplica |
O guia da Altrady é direto: a plataforma precisa apenas de permissão para negociar e ver saldo, e “nunca precisa (e você nunca deve conceder)” permissão de saque. Vale para qualquer ferramenta. Um robô não precisa sacar para operar. Se um serviço pedir saque, desconfie.
Restrição por IP: a trava mais importante
Com a restrição para IPs confiáveis ligada, a chave só funciona a partir dos endereços que você cadastrou. Se ela vazar, quem a copiou não consegue usá-la de outro lugar. Na prática:
- Robô próprio: rode num servidor com IP fixo (uma VPS, por exemplo) e cadastre esse IP. Internet residencial costuma ter IP que muda, o que derruba a conexão.
- Plataforma de terceiros: use os IPs que ela publicar. A Cryptohopper, por exemplo, mostra os endereços na própria configuração.
- Mudou de servidor? Atualize a lista de IPs antes de migrar, ou o robô para de enviar ordens.
Uma chave por ferramenta, e separe spot de futuros
Crie uma chave para cada ferramenta, com nome claro. Se uma delas der problema, você revoga só aquela. A Altrady sugere ainda chaves separadas para spot e futuros em uso intenso, para evitar erros de limite de requisições da BingX. Outro detalhe útil: o modo de posição dos perpétuos (one-way ou hedge) vale também para a API e para plataformas de terceiros, segundo o guia da BingX. Se você mudar o modo no app, o robô passa a operar no novo modo, o que pode quebrar a lógica de fechamento. Entenda o impacto em como fechar posição na BingX.
Como guardar e rodar a chave com segurança
- Guarde API key e secret key num gerenciador de senhas ou em variáveis de ambiente do servidor, nunca no código publicado no GitHub.
- Não use a mesma chave no computador pessoal e no servidor.
- Ative logs no robô para saber quais ordens ele enviou e quando.
- Teste antes com valor mínimo. A BingX tem modo demo com saldo virtual em VST para treinar estratégias de futuros, como explicamos no guia do app da BingX.
- Defina limites de risco no próprio código: tamanho máximo de ordem e perda diária máxima. Veja gestão de risco no trading.
API de leitura para o imposto
Muita gente cria chave só para importar o histórico num sistema de cálculo de imposto. Nesse caso, leitura basta. Fique atento a um limite: a Cryptact informa que não consegue importar o histórico de spot da BingX pela API porque a corretora fornece apenas 7 dias desses dados, e que o histórico de futuros cobre só os últimos 3 meses. Por isso, baixe extratos com frequência e guarde. O caminho da declaração está em BingX e imposto de renda.
Erros comuns ao conectar a chave
Nem toda falha de conexão é problema na chave. O guia da Cryptohopper lista causas frequentes, mesmo com API key e secret corretas:
- Saldo na conta errada. O dinheiro está na Conta de Fundos, e não na conta de spot ou de futuros que o robô usa.
- Conta sem saldo para o teste de conexão.
- Verificação de identidade (KYC) incompleta.
- IP não cadastrado. A ferramenta tenta acessar a partir de um endereço que não está na lista de IPs confiáveis.
- Permissão faltando. A chave tem só leitura, e o robô tenta enviar ordens.
Se a ferramenta mostrar erro de limite de requisições, a sugestão da Altrady é usar chaves separadas para spot e futuros. Em qualquer caso, resista à tentação de “liberar tudo” para ver se funciona: corrija a causa específica.
Quando apagar ou trocar a chave
- Parou de usar a ferramenta.
- Suspeita de que a chave vazou ou de que o servidor foi invadido.
- Viu ordens que não reconhece no histórico.
- Mudou de servidor ou de plataforma.
- A ferramenta passou a pedir permissões maiores sem explicação.
Apague a chave no Gerenciamento de API, crie uma nova com as permissões certas e atualize a ferramenta. Se houver suspeita de invasão, troque também senha e autenticador. Um caso conhecido de vazamento de chaves numa plataforma de robôs está no nosso guia de API de corretora cripto.
Automatize com segurançaConta com autenticador, chave sem saque e IP restrito: esse é o mínimo.Abrir conta na BingXA BingX não tem registro na CVM nem pedido público de autorização no Banco Central, segundo levantamento de 10/10/2026 do Bitnotícias.
Transparência: o Boletim Bitcoin pode receber comissão por cadastros feitos pelos links da BingX, sem custo extra para você. Isso não muda o que escrevemos sobre riscos e custos.
Perguntas frequentes
Onde crio a chave de API na BingX?
No site, clique no ícone da conta e escolha Gerenciamento de API (API Management). Depois clique em Criar API, dê um nome, confirme com e-mail e Google Authenticator e copie a API key e a secret key.
Que permissões devo dar à chave?
Só as necessárias. Leitura para painéis e sistemas de imposto; leitura mais negociação spot ou de futuros para robôs. Nunca libere saque: nenhum robô precisa sacar para operar.
Para que serve a restrição por IP?
Ela faz a chave funcionar só a partir dos endereços cadastrados. Se a chave vazar, quem a copiou não consegue usá-la de outro computador. Para robôs, use um servidor com IP fixo.
Perdi a secret key. E agora?
A secret key é exibida uma única vez, na criação. Se você não guardou, apague a chave no Gerenciamento de API e crie uma nova.
Preciso de API para usar robôs na BingX?
Não para os robôs nativos, como grid e martingale, nem para o Signal Trading com TradingView, que usa webhook. A API é necessária para robôs próprios e plataformas externas.
Referências
- Cryptohopper: como conectar a BingX com chaves de API
- Altrady: conectar a BingX
- HASH7: tutorial de vinculação de API da BingX
- Cryptact: como obter uma chave de API da BingX
- BingX: modo one-way e efeito na API
- BingX: código anti-phishing, whitelist de saque e bloqueio de conta
- BingX: guia do recurso passkey (16/07/2026)
- Bitnotícias: licença cripto do Banco Central, quem pediu e quem está saindo (10/10/2026)
Este conteúdo é informativo e não é recomendação de investimento. Encontrou um erro? Escreva para contato@boletimbitcoin.com.