Chave de API de corretora

A chave é uma segunda porta para a mesma conta, aberta por um token e uma assinatura, e não por uma tela de login. Os Termos de Uso da Bitstamp, atualizados por último em 30 de maio de 2025, colocam sob sua responsabilidade toda perda decorrente de uma chave que você gerou, inclusive acesso não autorizado e perda de fundos. Conceda escopo somente de leitura, nunca de saque, e exclua as chaves que você não usa mais.

Como funciona

Uma chave de API de corretora chega como um par: um identificador público que nomeia a conta e um segredo com o qual quem faz a chamada assina cada solicitação. O segredo aparece uma única vez, na criação, e a corretora guarda a própria cópia para conferir cada assinatura. A partir daí, um programa pode enviar ordens, consultar saldos ou movimentar fundos assinando uma solicitação, sem navegador, sem pedido de senha e sem segundo fator no caminho.

As permissões são o produto inteiro. Os termos da Bitstamp dizem em uma linha: "The scope of access you permit by such API key is defined by you when you create API Key" (o escopo de acesso que você permite por essa chave de API é definido por você ao criar a chave de API), e apontam para a página de controle de acesso da conta. As plataformas dividem esse escopo em leitura, negociação e saque, e muitas permitem fixar uma chave a endereços IP determinados, de modo que um segredo roubado é inútil em outro lugar. Uma chave somente de leitura entregue a um rastreador não pode fazer você perder dinheiro. Uma chave com permissão de saque é uma instrução permanente de pagar a quem tiver o segredo.

Contratualmente, uma solicitação assinada com sua chave é uma ordem sua. Os Termos da Bitstamp UK Limited, versão datada de 01 de julho de 2026, definem Instrução como qualquer ordem ou instrução recebida de você, e a cláusula de API isenta de responsabilidade por perdas "resulting from use or Instructions submitted through API Keys" (resultantes do uso ou de Instruções enviadas por meio de Chaves de API). A mesma cláusula consta em seis dos termos de entidades do grupo, cobrindo a Bitstamp Limited, a Bitstamp Europe S.A., a Bitstamp USA Inc., a Bitstamp UK Limited, a Bitstamp Global Ltd e a Bitstamp Asia Pte. Ltd. A Bitstamp também se reserva o direito de suspender qualquer chave sem aviso prévio quando acredita que a segurança foi comprometida.

Onde você a encontra

As chaves de API de corretora ficam nas configurações de segurança de toda plataforma que publica uma interface de negociação, em geral sob um título como controle de acesso. Você cria uma para conectar um rastreador de portfólio, uma ferramenta de impostos, um script de compra recorrente ou uma planilha que puxa seu histórico de negociações. Uma plataforma também pode permitir que um aplicativo externo solicite uma chave em seu nome: a Bitstamp chama isso de Bitstamp Connect e exige seu consentimento dentro da sua conta antes que a conexão de um integrador seja estabelecida.

Dois hábitos cobrem a maior parte do risco. Ajuste o escopo à tarefa, pois uma ferramenta de impostos que lê seu histórico de execuções não tem motivo para ter direitos de negociação ou de saque, e revogue uma chave no momento em que a ferramenta dela for aposentada, porque nada em uma chave expira sozinho. Se sua plataforma aceitar lista de IPs permitidos, use. Se você acha que um segredo vazou, exclua a chave primeiro e investigue depois.

Um detalhe surpreende quem constrói as próprias ferramentas. Os termos da Bitstamp no Reino Unido licenciam os dados de mercado que uma chave retorna apenas para Uso Permitido de Dados de Mercado, que abrange ver preços, enviar ordens, conciliar suas transações e cumprir obrigações fiscais ou de auditoria. Republicar esses preços, combiná-los com feeds de outras plataformas ou treinar um modelo com eles conta como Uso Comercial de Dados de Mercado e exige um contrato de dados de mercado separado.

Chave de API de corretora vs chave privada

Uma chave privada controla o bitcoin na blockchain; uma chave de API de corretora controla uma conta em uma empresa. A diferença aparece quando uma das duas vaza. Uma chave de API comprometida é revogável: exclua-a, e a plataforma deixa de aceitar assinaturas feitas com ela. Uma chave privada comprometida não pode ser revogada por ninguém, porque a rede não tem ideia de quem deveria detê-la, e a única defesa é mover os bitcoins para uma chave nova antes que o ladrão o faça. Essa assimetria também limita o que uma chave de API vazada pode custar: ela alcança o saldo que a corretora mantém para você e nada do que você já sacou.