Black Friday: um dezembro inteiro grátis, até 27 de novembro. Ver a oferta →
SonarSignal
Tutorial5 min de leitura

Chave API da Blofin: crie com segurança e conecte ao SonarSignal

Como criar uma chave API da Blofin só com permissões de leitura e trading, por que ela precisa estar vinculada ao SonarSignal e o que significam os erros mais comuns da API da Blofin.

Compartilhar:XTelegramWhatsAppRedditFacebookLinkedIn

Uma chave API permite que um app opere na sua conta da corretora sem saber a sua senha. Para usar o SonarSignal com a Blofin, a chave precisa de exatamente duas permissões: Read e Trade. Nada que tire dinheiro da sua conta. Este guia mostra como criar uma chave assim na Blofin, como conectá-la ao SonarSignal e o que significam as mensagens de erro quando algo dá errado.

Antes de começar

– Você precisa de uma conta na Blofin com autenticação em dois fatores. Ao criar a chave, a Blofin pede um código por e-mail e um código do Google Authenticator.

– Deixe pronto um lugar seguro para três dados: a API key, a secret key e uma passphrase que você mesmo escolhe. A secret key aparece uma única vez.

– Se você ainda não tem conta na Blofin, o guia de conexão com a corretora mostra o link de cadastro dentro do app.

Passo 1: crie a chave API na Blofin

– Entre em blofin.com, abra o seu menu de perfil e escolha API e depois Create API Key (criar chave API).

– Em API Key Usage (uso da chave API), escolha Connect to Third-Party Applications (conectar a aplicativos de terceiros) e selecione SonarSignal na lista. Esta etapa é obrigatória para o SonarSignal; explicamos o motivo mais abaixo.

– Dê um nome à chave, por exemplo "SonarSignal".

– Permissões: Read (leitura) normalmente já vem marcada. Marque Trade (negociar). Deixe Transfer (transferir) e tudo o que pareça saque desligado.

– Escolha uma passphrase e anote. Você vai precisar dela no SonarSignal e não poderá consultá-la depois.

– Confirme com o código do e-mail e o código do Google Authenticator.

– Copie a API key e a secret key imediatamente. A secret key só aparece uma vez.

Passo 2: conecte a chave no SonarSignal

– No app, abra os cartões das corretoras no topo da página e clique em "Enter API" ao lado da Blofin. Isso abre o Sonaris AI com a janela da Blofin.

– Cole a "API Key", o "API Secret" e a sua "Passphrase".

– Marque as duas caixas de segurança: "Withdrawal rights are DISABLED on the exchange" (os direitos de saque estão desativados na corretora) e "The key is bound to the SonarSignal application (Connect to Third-Party Applications)" (a chave está vinculada ao aplicativo SonarSignal). Sem a segunda marcação, a janela não salva.

– Aceite o aviso de risco e clique em "Save Connection". O cartão da Blofin passa então a mostrar "Connection active".

Por que a chave precisa estar vinculada ao SonarSignal

Na Blofin, o SonarSignal só funciona com uma chave vinculada ao aplicativo SonarSignal. Uma chave comum com lista de IPs permitidos não funciona aqui: a Blofin rejeita todas as ordens que o SonarSignal envia com ela. É por isso que a janela não mostra um IP de servidor para a Blofin, ao contrário de outras corretoras. A vinculação substitui a etapa do IP.

Segurança: o que a chave pode fazer e o que você decide

– Com Read e Trade, a chave pode ver a sua conta e abrir ou cancelar ordens. Ela não precisa de Transfer, e o SonarSignal nunca pede isso.

– O SonarSignal não verifica automaticamente as permissões da sua chave. As marcações na janela são a sua confirmação. Confira na Blofin que só Read e Trade estão ativas.

– Trate a secret key e a passphrase como uma senha. Ninguém do SonarSignal vai pedi-las a você por chat ou por e-mail.

– Se você acha que uma chave vazou, apague-a na Blofin e crie uma nova. Se você perdeu a passphrase, o caminho mais seguro é o mesmo: apagar a chave e criar uma nova.

– A documentação da API da Blofin descreve uma lista de endereços permitidos para saques. Se a sua conta oferece isso, é uma camada extra de proteção.

Erros comuns da API da Blofin

Os códigos vêm da documentação da API da Blofin.

– 152401: a access key não existe. Geralmente foi copiada pela metade ou apagada.

– 152402: a access key expirou. A Blofin faz as chaves sem vinculação de IP expirarem após 90 dias.

– 152404: a operação não é permitida com esta chave. Geralmente falta a permissão Trade.

– 152406: o seu IP não está na lista de IPs permitidos da chave.

– 152408: passphrase errada.

– 152409: assinatura inválida. Geralmente uma secret key errada.

Para desenvolvedores: limites e documentação

– Documentação: docs.blofin.com.

– Limites de requisições por IP: 500 por minuto (ultrapassar bloqueia por 5 minutos) e 1.500 a cada 5 minutos (ultrapassar bloqueia por 1 hora). Endpoints de trading: 30 requisições a cada 10 segundos por usuário. Acima do limite você recebe o código 429.

– WebSocket: no máximo uma conexão nova por segundo por IP; envie um ping em até 30 segundos, senão a conexão é encerrada.

– Cada requisição leva a passphrase no cabeçalho ACCESS-PASSPHRASE. Uma chave pode ser vinculada a até 20 endereços IP; sem vinculação de IP, ela expira após 90 dias.

Perguntas frequentes

– Como crio uma chave API da Blofin? Menu de perfil, API, Create API Key. Para o SonarSignal, escolha "Connect to Third-Party Applications" e SonarSignal, marque Read e Trade, defina uma passphrase e confirme com os seus códigos.

– O SonarSignal pode sacar o meu dinheiro? O SonarSignal só precisa de Read e Trade e nunca pede permissões de Transfer ou de saque. Se a chave tem mais permissões é decidido na Blofin, então confira lá.

– Onde fica a documentação da API da Blofin? Em docs.blofin.com.

– Qual é o limite de requisições da API da Blofin? 500 requisições por minuto e 1.500 a cada 5 minutos por IP; 30 requisições de trading a cada 10 segundos por usuário.

– Por que a minha chave API da Blofin expira após 90 dias? A Blofin faz as chaves sem vinculação de IP expirarem após 90 dias. Crie uma chave nova e cadastre-a de novo.

– Esqueci a minha passphrase. E agora? Apague a chave na Blofin e crie uma nova.

Leia também

– O que um robô de trading realmente faz e o que ele não consegue fazer

– Trading Desk: desenhe uma caixa e ative-a

– Stop-loss no Bitcoin: quanto o preço perfura abaixo das mínimas óbvias

Aviso de risco

Este guia explica uma configuração técnica e não é aconselhamento financeiro. Operar futuros pode levar à perda total do seu capital. Uma chave API dá a um app acesso à sua conta na corretora; conceda apenas as permissões de que você precisa.

Não é recomendação de investimento. Este artigo serve para informação e aprendizado. Não é recomendação de investimento nem indicação de compra ou venda. Operar com criptomoedas e produtos alavancados pode levar à perda total do capital aplicado.
Compartilhar:XTelegramWhatsAppRedditFacebookLinkedIn

Mais artigos