A API da Brasil Bitcoin permite que você automatize as operações que hoje faz na mão: consultar preços, enviar e cancelar ordens, acompanhar saldo e integrar a corretora ao seu próprio sistema. Ela serve tanto para quem investe como pessoa física quanto para empresas que movimentam cripto todos os dias.
Neste guia, você vê o que dá para automatizar em cada caso, como começar e quais cuidados de segurança tomar.
O que é uma API e o que dá para automatizar
API é a porta pela qual um programa conversa com a corretora sem passar pela tela do app. Em vez de clicar em comprar, o seu código envia a ordem, e a resposta volta em segundos.
Na Brasil Bitcoin, a API cobre duas frentes:
- Dados de mercado: cotações, livro de ofertas e histórico de negociações, abertos para consulta.
- Negociação e conta: criação e cancelamento de ordens, consulta de saldo e de ordens abertas, com autenticação por chave.
Para quem precisa reagir rápido ao mercado, a API também oferece conexão por WebSocket, que entrega as atualizações em tempo real sem precisar perguntar à corretora a cada segundo.
Como pessoas físicas usam a API
Para o investidor pessoa física, a API transforma uma estratégia em regra. Você define o que quer e o código executa, inclusive de madrugada e no fim de semana.
- Compras recorrentes: programe a compra de um valor fixo em BTC ou outro ativo toda semana ou todo mês, sem depender de lembrar.
- Ordens com preço alvo: deixe o código vigiar o mercado e enviar a ordem limitada quando o preço chegar onde você quer.
- Rebalanceamento de carteira: se um ativo passar do percentual definido, o código vende o excesso e compra o que ficou abaixo.
- Bots de negociação: estratégias como grid, que compra em faixas de queda e vende em faixas de alta, rodando 24/7.
- Painel próprio: puxe saldo e histórico para uma planilha ou dashboard pessoal.
- Operar por chat: com poucas linhas de código, dá para mandar ordens de compra por um aplicativo de mensagens ou por um assistente de IA conectado à sua conta.
Não programa? Na própria plataforma, o menu Negociar tem a área de Bots, que configura estratégias automáticas sem código. E ferramentas de IA que escrevem código já ajudam quem está começando a montar a primeira integração.
Automatizar não elimina risco. Um bot executa exatamente o que foi programado, inclusive os erros. Teste com valores pequenos antes de aumentar o volume.
Como empresas usam a API
Para a pessoa jurídica, a API tira a cripto da operação manual e coloca dentro do fluxo financeiro da empresa.
- Tesouraria automatizada: converta recebimentos em USDT para reais, ou reais para USDT, por regra, no momento definido pela política da empresa.
- Conciliação: puxe saldos, ordens executadas e histórico direto para o ERP ou para o sistema contábil.
- Pagamentos internacionais: compre o USDT para pagar fornecedores no exterior de forma programada. Veja o guia de comércio exterior com USDT.
- Market making e liquidez: empresas e traders profissionais que mantêm ordens no livro de ofertas operam como maker, com taxa de 0,20% a 0,05% conforme o volume em 30 dias.
- OTC via API: para volumes a partir de R$ 50 mil, a mesa OTC tem uma camada automatizada que integra cotação travada e execução ao sistema da empresa, com apoio técnico do desenho ao go live.
- Oferecer cripto aos seus clientes: bancos digitais, fintechs e plataformas que querem colocar compra, venda, depósito e saque de cripto dentro do próprio produto usam o Crypto as a Service (BB Core).
| Perfil | Ponto de partida | Para quê |
|---|---|---|
| Pessoa física | API de negociação | Compras recorrentes, ordens com preço alvo, bots, painel próprio |
| Empresa que opera cripto | API de negociação e OTC via API | Tesouraria, conciliação, pagamentos, market making |
| Plataforma ou fintech | Crypto as a Service (BB Core) | Oferecer cripto aos próprios clientes |
Como começar a usar a API
- Abra e verifique sua conta. A API usa a mesma conta da plataforma, pessoa física ou jurídica, com a verificação concluída.
- Gere sua chave de API na área de configurações da conta. Dê à chave só as permissões de que a sua automação precisa.
- Leia a documentação. Em brasilbitcoin.com.br/api/docs estão os endpoints, os formatos de requisição e de resposta e os limites de uso.
- Comece pelos dados públicos. Consultar cotação e livro de ofertas não mexe no seu saldo e é o melhor jeito de entender as respostas da API.
- Envie a primeira ordem com valor pequeno. Confira no app se ela apareceu como esperado e só então aumente o volume.
- Coloque em produção com monitoramento. Registre cada chamada, trate erros e defina um limite máximo de valor por operação no próprio código.
Empresas com volume relevante ou interesse em OTC via API podem falar direto com a mesa para desenhar a integração.
Segurança e boas práticas
Uma chave de API dá acesso à sua conta. Trate como trataria a sua senha.
- Nunca compartilhe a chave e nunca a coloque em código publicado, prints ou repositórios abertos.
- Use o mínimo de permissões. Um painel de saldo não precisa poder negociar. Se a automação não faz saques, a chave não deve fazer.
- Restrinja o acesso aos servidores de onde a automação roda, quando essa opção estiver disponível.
- Troque a chave periodicamente e revogue na hora qualquer chave que possa ter vazado.
- Coloque travas no código: valor máximo por ordem, limite diário e parada automática em caso de erro repetido.
- Respeite os limites de requisição descritos na documentação, para a automação não ser bloqueada no meio de uma estratégia.
- Desconfie de bots prontos vendidos com promessa de lucro garantido. Ninguém garante resultado no mercado de cripto.
E a Brasil Bitcoin?
A Brasil Bitcoin tem mais de 650 mil clientes, R$ 28 bilhões negociados e mais de 200 ativos, e está em processo de autorização junto ao Banco Central. A API dá acesso a esse livro de ofertas com a mesma estrutura de taxas da plataforma. Acesse a documentação da API.
Perguntas frequentes
Pessoa física pode usar a API da Brasil Bitcoin?
Sim. Qualquer conta verificada, de pessoa física ou jurídica, pode gerar uma chave de API.
Preciso saber programar?
Para integrar via API, sim, ou contar com alguém que programe. Quem não programa pode usar os Bots da plataforma, que funcionam sem código.
Quais são as taxas para operar via API?
As mesmas da plataforma: maker de 0,20% a 0,05% e taker de 0,50% a 0,12%, conforme o volume negociado em 30 dias. Veja Taxas e Prazos.
A API tem dados em tempo real?
Sim. Além das consultas tradicionais, há conexão por WebSocket para receber atualizações de mercado em tempo real.
Dá para usar a mesa OTC pela API?
Sim. Empresas e plataformas podem integrar o OTC automatizado, com cotação travada, e contam com apoio técnico na integração.
Minha empresa quer oferecer cripto aos clientes. A API serve?
Para esse caso, o caminho é o Crypto as a Service (BB Core), que leva compra, venda, depósito e saque de cripto para dentro do seu produto.
