Chaves de corretora somente leitura, explicadas: o que uma chave pode fazer e o que recusamos

Para mostrar o que você tem em uma corretora, o Burokku precisa de uma chave de API que você cria nas configurações dessa corretora. As permissões que você marca ao criá-la decidem tudo o que um app pode fazer com ela. O Burokku lê mais de 10 corretoras assim, e a primeira coisa que ele faz com qualquer chave que você cola é descobrir o que ela tem permissão para fazer.

O que uma chave somente leitura pode e não pode fazer

Uma chave só com a leitura ativada deixa o Burokku ver:

• os seus saldos em cada carteira dentro da conta: spot, funding, earn, futuros e as demais;
• as suas posições de futuros abertas;
• o seu histórico: depósitos, saques, negociações e pagamentos de taxa de financiamento.

Ela não pode criar, alterar ou cancelar uma ordem, nem sacar ou transferir nada. Se alguém a copiasse, poderia ver os seus saldos e nada mais.

As corretoras não dão os mesmos nomes a essas permissões, então lemos a resposta de cada uma em vez de adivinhar:

• A Binance lista transferências internas e universais separadas dos saques. Contamos as duas como saque.
• A Kraken tem direitos separados para adicionar ou alterar um endereço de saque. Também contamos esses como saque.
• A Bybit cria uma chave somente leitura ou de leitura e escrita. Só uma somente leitura se conecta para leitura.
• A Coinbase tem um único direito que cobre mover fundos para dentro e para fora. Uma chave com ele é recusada.

Como criar uma chave de API somente leitura na Binance mostra as telas de uma corretora; o Burokku mostra os passos de cada corretora quando você a conecta.

Como o Burokku confere uma chave antes de guardá-la

Quando você cola uma chave, o Burokku pergunta à corretora o que ela pode fazer antes de armazenar qualquer coisa. Uma chave conectada para leitura precisa conseguir ler e não pode conseguir negociar nem sacar. Se puder fazer qualquer uma dessas coisas, ela é recusada e você fica sabendo qual direito tirar. Nada é salvo.

Por que recusar uma chave que pode sacar, mesmo que você confie em nós? Porque a chave mais segura de guardar é uma que não consegue mover dinheiro nenhum: uma cópia roubada não consegue esvaziar a sua conta. Por isso nunca aceitamos uma "só por garantia".

Uma chave que passa é lida na mesma hora, então você vê os seus saldos reais antes de dar um nome à conta. Quando a corretora nos diz a quem pertence a conta de uma chave (a Bybit diz), uma segunda chave para uma conta que você já adicionou é recusada, para que ela não seja contada duas vezes.

A verificação não termina na conexão. O Burokku pergunta de novo à corretora sobre as permissões de cada chave uma vez por dia. Se uma chave somente leitura ganhou o direito de negociar ou sacar, o Burokku a exclui, mantém os seus últimos saldos na tela e avisa você uma vez, no app e por e-mail. Conectar uma chave e uma chave que excluímos vão, as duas, para o registro de auditoria da sua conta.

Onde a sua chave fica

Uma chave que você conecta é criptografada nos nossos servidores com uma chave feita só para a sua conta, e vinculada a essa conta e a essa corretora, então uma cópia levada para qualquer outro lugar não abre. Nada fora do espaço próprio da sua conta chega a ver a chave em texto puro.

Depois que você a cola, a chave nunca é enviada de volta a um navegador, nosso ou seu. O app mostra só os quatro últimos caracteres dela. Como funciona a segurança explica o resto do que é guardado e onde.

Quando uma chave para de funcionar

Chaves param de funcionar por motivos comuns: você excluiu uma, mudou a lista de IPs permitidos dela, ou a corretora a encerrou. O que o Burokku faz depende de a corretora ter recusado a chave ou só estar difícil de alcançar.

• A corretora recusa a chave. Uma vez pode ser só um momento ruim da corretora, então o Burokku espera cinco minutos e tenta de novo. Recusada duas vezes seguidas, ele para de usar a chave e avisa você uma vez, no app e por e-mail. Ele não fica tentando em segundo plano; algumas corretoras bloqueiam uma chave que falha repetidamente. Ele só tenta de novo quando você substitui a chave ou pede que ele verifique outra vez.
• A corretora não pode ser alcançada. O Burokku espera cada vez mais entre uma tentativa e outra, até uma hora, e continua mostrando os seus últimos saldos. A conta só diz que não consegue alcançar a corretora depois que isso dura meia hora.

Algumas chaves expiram sozinhas: a Bybit e a Gate encerram uma chave sem lista de IPs permitidos depois de cerca de três meses. O Burokku avisa você uma semana antes, uma vez, para você colar uma chave nova antes de os seus saldos pararem de atualizar.

Como as chaves de negociação são diferentes

Se você quiser enviar ordens pelo Burokku, pode conectar uma chave de negociação, nas corretoras que oferecem isso, como a Binance e a Kraken. As regras para essa chave são diferentes, e mais rígidas:

• Ela precisa conseguir negociar.
• Ela não pode conseguir sacar nem transferir. Uma chave de negociação que consegue é recusada, como uma somente leitura seria.
• Ela precisa estar restrita a um endereço IP. O Burokku envia ordens a partir de um único endereço IP fixo, que ele mostra quando você conecta. A chave precisa estar restrita a ele, então uma cópia não serve em nenhum outro lugar. Quando uma corretora não informa se uma chave está restrita, testamos a chave a partir de outro endereço: se a corretora a recusar ali, ela está restrita.

Ativar a negociação também exige a verificação em duas etapas na sua conta do Burokku, e você confirma com essa segunda etapa. Depois disso, toda ordem é conferida com limites que você define antes de ser enviada.

A verificação diária também vale aqui. Uma chave de negociação que ganha o direito de sacar, ou perde a restrição de IP, é excluída e você é avisado uma vez. Uma que perde o direito de negociar volta a só ler a sua conta. Negociação no Burokku explica como as ordens são precificadas e conferidas.

Se estiver em dúvida, comece com uma chave somente leitura. Você vê cada saldo, posição e negociação ao lado das suas carteiras, e a chave não consegue mover nada. Você pode adicionar uma chave de negociação depois, ou nunca.