Comece a investir em bitcoin com Pix, em poucos minutosPatrocinadoAbrir conta grátis
BingX API: como criar sua chave de API com segurança
Trading

BingX API: como criar sua chave de API com segurança

O caminho no site da BingX para gerar a chave, que permissões marcar para cada uso e as travas que impedem que um vazamento vire prejuízo.

Foto: Unsplash

Por Redação Boletim Bitcoin

. Leitura de 8 min.

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

1 veza secret key é exibida
2FAobrigatório para criar a chave
0permissões de saque
1 chavepor ferramenta

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:

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.

  1. Abra o Gerenciamento de APINo site, clique no ícone da conta, no canto superior direito, e escolha Gerenciamento de API (API Management).
  2. Crie a chaveClique em Criar API, escolha a conta (principal ou subconta) e dê um nome que identifique o uso, como “robo-spot-vps”.
  3. Confirme a identidadeDigite o código enviado por e-mail e o código do Google Authenticator.
  4. 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.
  5. Defina as permissõesEm Editar, marque só o necessário: leitura, negociação spot ou negociação de futuros. Nunca marque saque.
  6. 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.
  7. Salve e confirme de novoClique em Salvar e confirme com e-mail e autenticador. Só então cole a chave na ferramenta.
Dica: a Cryptohopper alerta para colar os IPs e copiar a chave antes de clicar em Salvar. Na prática, confira tudo na tela de edição antes de confirmar: permissões e IPs são o que protege você se a chave vazar.
Crie sua conta antes da chaveAbra a conta, ative o autenticador e só depois gere a API.Criar conta grátis

Qual permissão marcar para cada uso

UsoPermissãoRestrição de IP
Planilha ou painel que só lê saldoLeituraRecomendada
Sistema de imposto ou contabilidadeLeitura (a Cryptact pede apenas “Read”)Recomendada, se o serviço informar IPs
Robô de spotLeitura e negociação spotObrigatória na prática
Robô de futurosLeitura e negociação de futurosObrigatória na prática
Qualquer usoSaque: nuncaNã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.

Atenção: nunca libere a permissão de saque numa chave de API. Com negociação, um invasor ainda pode causar prejuízo operando mal, mas com saque ele leva o dinheiro. Também nunca envie a secret key por mensagem, e-mail ou formulário de “suporte”: nenhum atendimento legítimo precisa dela. Veja golpes com criptomoedas.

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

  1. Parou de usar a ferramenta.
  2. Suspeita de que a chave vazou ou de que o servidor foi invadido.
  3. Viu ordens que não reconhece no histórico.
  4. Mudou de servidor ou de plataforma.
  5. 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 BingX

A 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

  1. Cryptohopper: como conectar a BingX com chaves de API
  2. Altrady: conectar a BingX
  3. HASH7: tutorial de vinculação de API da BingX
  4. Cryptact: como obter uma chave de API da BingX
  5. BingX: modo one-way e efeito na API
  6. BingX: código anti-phishing, whitelist de saque e bloqueio de conta
  7. BingX: guia do recurso passkey (16/07/2026)
  8. Bitnotícias: licença cripto do Banco Central, quem pediu e quem está saindo (10/10/2026)
  • BingX
  • API
  • segurança
  • robôs de trading
  • whitelist de IP

Este conteúdo é informativo e não é recomendação de investimento. Encontrou um erro? Escreva para contato@boletimbitcoin.com.

Leia também

Comece no cripto hoje

Abra sua conta grátis, deposite com Pix e acesse spot, futuros, copy trading e robôs de trading em um só app.

  • Depósito com Pix
  • Copy trading
  • Robôs grid e DCA
  • App completo
Publicidade. Cripto envolve risco, invista com responsabilidade.
Criar conta grátis