Gerenciamento de API | Bitsgap 🔑 Saiba como criar, atualizar e gerenciar chaves API com segurança para conectar exchanges e executar bots de trading automatizado 📊

Segurança de API

Garantir a segurança da sua conta na exchange é uma prioridade. Algumas exchanges exigem o uso de IP whitelisting para utilizar chaves de API com a Bitsgap. Atualmente, isso é obrigatório para Binance, KuCoin, Kraken e Crypto.com. Este guia fornece instruções passo a passo para atualizar as permissões da sua API e adicionar os endereços IP confiáveis da Bitsgap.<hr><h3 id="h_01KCWCJZ00P6R968B54225NM7K" data-start="669" data-end="684">Visão geral</h3><ul data-start="686" data-end="815">
<li data-start="686" data-end="733" data-list-item-id="ed761f43f2ef36f226da9cb4e657c7996"><a href="https://bitsgap4907.zendesk.com/hc/en-us/articles/9948309520924#h_01JHXD7DNAWWA7CDHXJD8A95H0">Substituição rápida (Binance, KuCoin e OKX)</a></li>
<li data-start="734" data-end="757" data-list-item-id="e84f33c168c9f12b56faf4096cef5564f"><a href="https://bitsgap4907.zendesk.com/hc/en-us/articles/9948309520924#h_01JHXD7DNAG7Z4F5APEMAXHE3M">Substituição manual</a></li>
<li data-start="758" data-end="815" data-list-item-id="e7a5c4bb1f444be2303d29ec781736344"><a href="https://bitsgap4907.zendesk.com/hc/en-us/articles/9948309520924#h_01JHXD7DNA9ZK9AMZAWGMJP5C0">Adicionar IPs confiáveis a uma chave de API existente</a></li>
</ul><hr><h3 id="h_01KCWCP56BWTTYZNMSS2Z8WE18" data-start="822" data-end="845">Substituição rápida</h3>A Substituição rápida simplifica a atualização das chaves de API e está disponível para Binance, KuCoin e OKX.Passos:<ol><li data-list-item-id="e82f5af905adf7c3350005531c1176e76">Acesse a página My Exchanges Vá para Bitsgap &gt; My Exchanges, clique nos três pontos (More) ao lado da exchange e selecione Replace API key.</li></ol><figure class="wysiwyg-image"><img style="aspect-ratio: 536/275;" src="https://bitsgap4907.zendesk.com/hc/article_attachments/24365747272860" width="536" height="275"></figure><ol start="2"><li data-list-item-id="ecf5f3b4a45839f1dd25caaefde1b6120">Renove a chave de API Clique em Replace para gerar automaticamente uma nova chave de API.</li></ol><figure class="wysiwyg-image"><img style="aspect-ratio: 522/642;" src="https://bitsgap4907.zendesk.com/hc/article_attachments/24365724955548" width="522" height="642"></figure>3. Verifique o status da conexão O sistema criará uma nova chave chamada “Bitsgap_com” com as permissões necessárias e a conectará à Bitsgap.<figure class="wysiwyg-image"><img style="aspect-ratio: 691/285;" src="https://bitsgap4907.zendesk.com/hc/article_attachments/24365747273500" width="691" height="285"></figure><hr><h3 id="h_01KCWDFTMRESMHNB79M2K7EJPM" data-start="1401" data-end="1424">Substituição manual</h3>Para exchanges que não suportam a Substituição rápida, siga os passos abaixo:<ol data-start="1505" data-end="2177"><li data-start="1505" data-end="1651" data-list-item-id="e925805db5a8678a19ff285630c7b6b58">Acesse My Exchanges Vá para Bitsgap &gt; My Exchanges, clique nos três pontos (More) ao lado da exchange e selecione Replace API key.</li></ol><figure class="wysiwyg-image"><img style="aspect-ratio: 624/321;" src="https://bitsgap4907.zendesk.com/hc/article_attachments/24365882423324" width="624" height="321"></figure><ol data-start="1505" data-end="2177" start="2"><li data-start="1653" data-end="1790" data-list-item-id="e48a74569ea2b4aeb22022516ad1aa3e2">Copie os IPs confiáveis da Bitsgap Na janela Manual Replace, clique no ícone de copiar para salvar a lista de IPs confiáveis.</li></ol><figure class="wysiwyg-image"><img style="aspect-ratio: 292/435;" src="https://bitsgap4907.zendesk.com/hc/article_attachments/24365887705628" width="292" height="435"></figure><ol data-start="1505" data-end="2177" start="3">
<li data-start="1792" data-end="1897" data-list-item-id="e47ba6d96a6c93da459236a209d27cc36">Faça login na exchange Vá para as configurações de API da sua exchange e crie uma nova chave.</li>
<li class="ck-list-marker-bold" data-list-item-id="ef745d8f2cfcf9385a220d9baa998925d">
Set Permissions and Whitelist IPs<ul>
<li data-list-item-id="eb799fd00438470e351ebce0a34197239">Adicione os endereços IP copiados à lista de permissões.</li>
<li data-list-item-id="e75ac90ec9ad0acdcc3451132ff0b0da8">Ajuste as permissões conforme exigido pela Bitsgap. Consulte as configurações detalhadas de permissões para <a href="https://bitsgap.com/helpdesk/article/9898682355868-How-to-create-and-set-up-Binance-API-key">Binance</a>, <a href="https://bitsgap.com/helpdesk/article/9900297148188-How-to-create-and-set-up-Kucoin-API-key">KuCoin</a>, <a href="https://bitsgap.com/helpdesk/article/9932313131932-How-to-create-and-set-up-Kraken-Pro-API-key">Kraken</a>, <a href="https://bitsgap.com/helpdesk/article/10087762559260-How-to-create-and-set-up-Crypto-com-API-key">Crypto.com</a> e <a href="https://bitsgap.com/helpdesk/category/9837454117788-Connect-your-exchange">outras exchanges</a>.</li>
<li data-list-item-id="e1f7da98075a69b3e53a1ce38f5787f8b">Salve as alterações.</li>
</ul>
</li>
<li data-start="2045" data-end="2177" data-list-item-id="e45cd60790b785db4c987280271043cbb">Insira as informações da API na Bitsgap Cole a API Key, Secret Key e Passphrase (se necessário) e clique em Replace.</li>
</ol><hr><h3 id="h_01KCWEJY9XPS7A8G2Y4V9HK870" data-start="2184" data-end="2243">Adicionando IPs confiáveis a uma chave de API existente</h3>Se você precisar ajustar as permissões de uma chave de API existente, siga os passos abaixo:<ol data-start="2245" data-end="2665">
<li data-start="2245" data-end="2352" data-list-item-id="e1d1056640f4ae0a1bcec83b5eb1bfcf0">Acesse My Exchanges Vá para Bitsgap &gt; My Exchanges e clique em Fix ao lado da chave de API.<img src="https://bitsgap4907.zendesk.com/hc/article_attachments/24366230547740" width="624" height="264"></li>
<li data-start="2354" data-end="2435" data-list-item-id="e74256d091719decac1f64e0d36cffb0e">
Copiar os endereços IP confiáveis da Bitsgap Salve os endereços IP exibidos na janela pop-up clicando no ícone Copy.
<figure class="wysiwyg-image"><img style="aspect-ratio: 253/339;" src="https://bitsgap4907.zendesk.com/hc/article_attachments/24366230547868" width="253" height="339"></figure>
</li>
<li data-start="2437" data-end="2574" data-list-item-id="e2285cbfbca9f5c03a1d44e2600379448">Acessar o gerenciamento de API da sua exchange Localize sua chave de API na seção de gerenciamento de API da exchange e clique em Edit.</li>
<li class="ck-list-marker-bold" data-start="2576" data-end="2665" data-list-item-id="eaa66a7a25c985638355436bf9889faf7">
Atualizar restrições de IP e permissões
<ul>
<li data-start="2576" data-end="2665" data-list-item-id="e102023619beed7ad207e9910e3828559">Adicione os endereços IP copiados à lista de permissões (whitelist).</li>
<li data-list-item-id="ed765b8d9e9fc9211889186b78b855f9e">Ajuste as permissões conforme exigido pela Bitsgap. Consulte as configurações detalhadas de permissões para <a href="https://bitsgap.com/helpdesk/article/9898682355868-How-to-create-and-set-up-Binance-API-key">Binance</a>, <a href="https://bitsgap.com/helpdesk/article/9900297148188-How-to-create-and-set-up-Kucoin-API-key">KuCoin</a>, <a href="https://bitsgap.com/helpdesk/article/9932313131932-How-to-create-and-set-up-Kraken-Pro-API-key">Kraken</a>, <a href="https://bitsgap.com/helpdesk/article/10087762559260-How-to-create-and-set-up-Crypto-com-API-key">Crypto.com</a> e <a href="https://bitsgap.com/helpdesk/category/9837454117788-Connect-your-exchange">outras exchanges</a>.</li>
<li data-list-item-id="e06652019601157edbdabacf0fb2e9754">Salve as alterações.</li>
</ul>
</li>
<li class="ck-list-marker-bold" data-list-item-id="e06895e7f545d953333b74827c7d54416">
Atualizar a conexão na Bitsgap
<ul><li data-list-item-id="e84b58545877fee582486e5460de75bb2">Retorne à página My Exchanges e clique em Refresh.</li></ul>
</li>
</ol><figure class="wysiwyg-image"><img style="aspect-ratio: 275/370;" src="https://bitsgap4907.zendesk.com/hc/article_attachments/24366301983644" width="275" height="370"></figure><hr><h4 id="h_01KBH275HGPRHQXM3RY865KPSH">O que fazer a seguir?</h4><ul>
<li data-list-item-id="e81053a40320377458ae17e0557f17623"><a href="https://bitsgap.com/helpdesk/article/13091210942364-How-to-Launch-Your-First-Bot-on-Bitsgap">Inicie seu primeiro bot:</a> automatize sua estratégia de negociação com os bots inteligentes e fáceis de usar do Bitsgap.</li>
<li data-list-item-id="e0183e5b6c4626daabdf96dce892cb56d"><a href="https://bitsgap.com/helpdesk/article/18030543601308-Introduction-to-Manual-Trading">Guia de negociação manual:</a> execute operações precisas usando o terminal de negociação avançado e intuitivo do Bitsgap.</li>
</ul><hr><h4 id="h_01KBH2EQSB5C90SC0MQHN1996K">Precisa de ajuda?</h4>Se você encontrar algum problema ou tiver dúvidas, não hesite em entrar em contato com a Equipe de <a href="support@bitsgap.com">Suporte ao Cliente</a> da Bitsgap.&nbsp;

Atualizando as permissões da API com endereços IP confiáveis

A Bitsgap exibe o status atual das suas chaves de API conectadas. Cada status indica o que deu errado ao conectar suas chaves à plataforma. Vamos analisar cada um deles mais de perto.
<h3 id="h_01J66X0VQAHR8V3F6JWZ7608H3">Status</h3>
<table id="6cf9915a-90a6-4b3b-8be2-6fd76f200004" class="simple-table">
<tbody>
<tr id="95719396-5210-40c1-ae0b-19e6b0e05f67">
<td id="SVe}" class="" style="width: 142px;">Status</td>
<td id="V@c^" class="" style="width: 231px;">Descrição do status</td>
<td id="ViUf" class="" style="width: 292px;">Solução</td>
</tr>
<tr id="50e5ce2e-f5f5-4f04-b3dc-9f5bb166dfde">
<td id="SVe}" class="" style="width: 142px;">Conectada</td>
<td id="V@c^" class="" style="width: 231px;">Sua chave está conectada e pronta para ser usada.</td>
<td id="ViUf" class="" style="width: 292px;">-</td>
</tr>
<tr id="1f2fbc99-4719-49d2-9b8b-604446055339">
<td id="SVe}" class="" style="width: 142px;">Expira em N* dias</td>
<td id="V@c^" class="" style="width: 231px;">A chave ficará inativa após o número especificado de dias. ______________________ *N&nbsp;- número de dias.</td>
<td id="ViUf" class="" style="width: 292px;">Em sua exchange,&nbsp;<a href="https://bitsgap.com/helpdesk/article/9948309520924-Updating-API-Key-Permissions-with-Trusted-IP-Addresses#https://bitsgap4907.zendesk.com/hc/en-us/articles/9948309520924" target="_blank" rel="noopener noreferrer">adicione nossos endereços de IP</a> à chave API conectada à Bitsgap.</td>
</tr>
<tr id="cfdbeaff-0905-4e39-9394-77837ad38d1d">
<td id="SVe}" class="" style="width: 142px;">Expirou</td>
<td id="V@c^" class="" style="width: 231px;">Faltam todas as permissões necessárias para a chave API devido à política de segurança da exchange.</td>
<td id="ViUf" class="" style="width: 292px;">Reative todas as permissões solicitadas, renove a chave ou&nbsp;<a href="https://bitsgap.com/helpdesk/article/9948309520924-Updating-API-Key-Permissions-with-Trusted-IP-Addresses#https://bitsgap4907.zendesk.com/hc/en-us/articles/9948309520924" target="_blank" rel="noopener noreferrer">adicione nossos endereços IP</a>&nbsp;à chave API conectada à Bitsgap.</td>
</tr>
<tr id="a9bb2c75-d322-4d8b-ae9c-fb7b384f89ac">
<td id="SVe}" class="" style="width: 142px;">Permissões incorretas</td>
<td id="V@c^" class="" style="width: 231px;">Permissões da chave API ausentes ou inválidas.</td>
<td id="ViUf" class="" style="width: 292px;">Verifique se todas as permissões necessárias estão ativadas e compare-as com a&nbsp;<a href="https://bitsgap4907.zendesk.com/hc/pt-br/articles/9898682355868" target="_blank" rel="noopener noreferrer">instrução em nossa Central de Ajuda</a>.</td>
</tr>
<tr id="ba42cae9-48df-40e8-bf92-e3d406e57222">
<td id="SVe}" class="" style="width: 142px;">Saque ativado</td>
<td id="V@c^" class="" style="width: 231px;">A chave API não pode ser usada porque a permissão de saque está ativada.</td>
<td id="ViUf" class="" style="width: 292px;">Desative a permissão de saque da chave API conectada à Bitsgap.</td>
</tr>
<tr id="09549edd-2dbe-4572-b9da-1d22db264e0b">
<td id="SVe}" class="" style="width: 142px;">Problema temporário</td>
<td id="V@c^" class="" style="width: 231px;">A chave está temporariamente inválida devido a problemas no lado da exchange.</td>
<td id="ViUf" class="" style="width: 292px;">Nenhuma ação adicional é necessária; aguarde até que o problema seja resolvido.</td>
</tr>
<tr id="a7c829b7-b40f-4a36-b4dc-5209554303af">
<td id="SVe}" class="" style="width: 142px;">Inválida</td>
<td id="V@c^" class="" style="width: 231px;">A chave não existe ou não pode ser usada.</td>
<td id="ViUf" class="" style="width: 292px;">O problema pode ser um dos seguintes: 1. A chave não está ativada; 2. Verificação KYC é necessária na exchange; 3. Sua conta da exchange está congelada ou desativada; Para resolver esse status, entre em contato com a equipe de suporte da exchange ou crie uma nova chave API e tente conectá-la à Bitsgap <a href="https://bitsgap.com/pt/helpdesk/article/9898682355868-Como-criar-e-configurar-a-chave-API-da-Binance">seguindo nossas instruções na Central de Ajuda</a>.</td>
</tr>
<tr id="807764e6-88a5-4a46-977b-092940a403f8">
<td id="SVe}" class="" style="width: 142px;">Futuros inativos</td>
<td id="V@c^" class="" style="width: 231px;">Sua chave API da Binance não permite a negociação de futuros.</td>
<td id="ViUf" class="" style="width: 292px;">Cadastre a conta de Futuros da Binance seguindo este&nbsp;artigo da&nbsp;<a href="https://bitsgap4907.zendesk.com/hc/pt-br/articles/9919541399580" target="_blank" rel="noopener noreferrer">Central de Ajuda</a>. Se você já abriu a conta de Futuros, verifique se a permissão de negociação de Futuros está ativada para a chave API conectada.</td>
</tr>
</tbody>
</table>
<hr>
<h4 id="h_01JQDC735ZCV7MHJ4S6WWGST1P" data-start="289" data-end="333">O que fazer a seguir?</h4>
<ul data-start="334" data-end="578" data-is-last-node="" data-is-only-node="">
<li class="" data-start="334" data-end="489">
<a href="https://bitsgap.com/helpdesk/article/9948309520924-Updating-API-Key-Permissions-with-Trusted-IP-Addresses">Verifique as configurações da sua API:</a> Certifique-se de que suas chaves de API tenham as permissões corretas para uma negociação segura e ininterrupta.
</li>
<li class="" data-start="490" data-end="578">
<a href="https://bitsgap4907.zendesk.com/hc/pt-br/articles/9807484280732">Bloqueio de conta API:</a> Entenda como a Bitsgap protege sua conta com restrições de API.
</li>
</ul>
<hr>
<h4 id="h_01JQDCERSTACZC4VD3Z5MA902Z">Precisa de ajuda?</h4>
Para qualquer problema ou dúvidas, não hesite em entrar em contato com a equipe de <a href="mailto:support@bitsgap.com">suporte ao cliente</a> da Bitsgap.

Status de erro em chave API

O algoritmo de bloqueio de conta API (API Account Lock) garante que uma chave API não seja reutilizada em várias contas da Bitsgap. Esse recurso otimiza a verificação dos dados da API e melhora a segurança das suas conexões com a exchange.
<hr>
<h3 id="h_01JQDDKESAD4JFDE5Z3AQFY3RH" data-start="258" data-end="343">Como funciona</h3>
O sistema impede a adição de uma chave API se:
<ul data-start="345" data-end="487" data-is-last-node="" data-is-only-node="">
<li class="" data-start="345" data-end="410">
A chave já foi conectada a outra conta Bitsgap anteriormente.
</li>
<li class="" data-start="411" data-end="487">
Se passaram mais de 24 horas desde que a chave foi removida da plataforma.
</li>
</ul>
<hr>
<h3 id="h_01JQDDV1NKFT7YZKB0SFJ34FTK">O que acontece se eu usar a mesma chave API?</h3>
1. Você receberá uma notificação por e-mail enviada para a conta onde a chave API já está conectada.
<img src="https://bitsgap4907.zendesk.com/hc/article_attachments/15639802906268" alt="Untitled (26).png">
2. Uma notificação pop-up aparecerá, indicando que a chave API está vinculada a outra conta Bitsgap.
<img src="https://bitsgap4907.zendesk.com/hc/article_attachments/15639802908444" alt="Untitled (27).png">
3. A chave será marcada com um status de erro de API na página "Minhas Exchanges".
<hr>
<h3 id="h_01JQDE5K7ME2C1DSW77HRJ64FN" data-start="787" data-end="846">Resolvendo o erro "API Account Lock"</h3>
<ul data-start="847" data-end="1171">
<li class="" data-start="847" data-end="962">
Para uma nova conta: Faça login no seu exchange, crie uma nova chave API e conecte-a à sua conta Bitsgap.
</li>
<li class="" data-start="964" data-end="1171">
Se você receber um erro, mas ainda não vinculou a chave API:
<ol data-start="1035" data-end="1171">
<li class="" data-start="1035" data-end="1076">
Faça login na sua conta do exchange.
</li>
<li class="" data-start="1079" data-end="1126">
Exclua todas as chaves API não utilizadas.
</li>
<li class="" data-start="1129" data-end="1171">
Crie uma nova chave API para o Bitsgap.
</li>
</ol>
</li>
</ul>
Nota O sistema deixará de enviar notificações se a chave correta estiver conectada. Para fechar, clique no botão [Ignorar].
<hr>
<h4 id="h_01JQDE6H7DXY257NSJ1TQ06VW1" data-start="1304" data-end="1329">O que fazer depois?</h4>
<ul data-start="1330" data-end="1531" data-is-last-node="" data-is-only-node="">
<li class="" data-start="1330" data-end="1445">
<a href="https://bitsgap.com/helpdesk/article/9948309520924-Updating-API-Key-Permissions-with-Trusted-IP-Addresses">Atualizando as permissões da chave API:</a> Aprenda a configurar as permissões e garantir conexões API seguras.
</li>
<li class="" data-start="1446" data-end="1531">
<a href="https://bitsgap4907.zendesk.com/hc/pt-br/articles/10044910693020">Resolvendo erros de API:</a> Obtenha soluções para problemas comuns de conexão API.
</li>
</ul>
<hr>
<h4 id="h_01JQDE9DFPG71E4N14K81MB30B">Precisa de ajuda?</h4>
Para qualquer problema ou dúvidas, não hesite em entrar em contato com a equipe de <a href="mailto:support@bitsgap.com">suporte ao cliente</a> da Bitsgap.

Segurança de API

Atualizando as permissões da API com endereços IP confiáveis

Status de erro em chave API

Bloqueio de conta por API