Bitsgap API: Execute seu próprio algoritmo de trading em 17 exchanges

Configurar sua própria automação de trading costumava significar uma semana de trabalho. Ler a documentação da API de uma corretora, implementar seu esquema de assinatura, lidar com suas particularidades e, em seguida, repetir tudo para a próxima corretora. Adicionar um servidor, implementar lógica de reconexão, criar uma forma de testar sem perder dinheiro.

A API da Bitsgap elimina essa semana. Um único par de chaves cobre 17 exchanges, os ambientes de demonstração já estão disponíveis e a conexão com sua exchange é a mesma que seus bots já utilizam. Entre as contas que já configuraram, o tempo mediano desde a criação da chave até a primeira solicitação assinada com sucesso é de 13 minutos. A API está incluída como Free em todos os planos, inclusive no plano Free.

O que realmente é uma API de trading

Uma API é uma lista fixa de comandos que um programa pode enviar para outro. Uma trading API é essa lista para um Market: ler um Preço, ler um Saldo, enviar uma Ordem, cancelar uma Ordem, fechar uma Posição. Seu programa envia um comando, o servidor executa a tarefa e retorna uma resposta. Tudo o que você pode fazer clicando no Bitsgap, seu código pode fazer automaticamente, no seu próprio ritmo.

A versão da Bitsgap é baseada em uma ideia chamada tópico — algo nomeado que você deseja. price, balance, orders, order_place. Você nomeia o tópico, passa seus parâmetros e recebe de volta um único instantâneo ou um fluxo ao vivo de atualizações.

json

{"topic": "price", "params": {"em": 101, "pair": "BTC_USDT"}}

O restante do protocolo define quais tópicos existem e quais parâmetros cada um aceita. Não há um endpoint separado para cada ação e não existe um segundo formato para aprender conforme você se aprofunda.

Por que não operar diretamente na corretora

Você pode, e para uma única corretora essa é uma escolha razoável. Três coisas mudam quando o número passa de um.

Cada exchange possui seu próprio esquema de assinatura, então adicionar uma segunda plataforma significa implementar tudo do zero novamente. Cada exchange exige uma chave exclusiva, armazenada e rotacionada separadamente. E a maioria não oferece um ambiente realista para testes, então o novo código entra em contato com dinheiro real logo na primeira execução.

Com a Bitsgap, é um único par de chaves, um único esquema de assinatura e um ambiente de demonstração que se comporta como o real. Seu algoritmo também fica na mesma Conta que seus bots GRID, DCA e COMBO, então suas posições aparecem em um só lugar, em vez de dois sistemas separados, cada um mostrando apenas parte do cenário.

Treze minutos, passo a passo

1. Crie uma Conta. Plano Free, sem cartão. A API está incluída em todos os planos, então nada aqui precisa de upgrade.

2. Gere uma chave. Menu da Conta → API keys → Criar nova chave. Dê um nome e defina uma data de expiração, depois clique em Gerar. O tempo de validade padrão é de três anos.

3. Salve a chave privada. Ela aparece uma única vez, como um arquivo PEM. Faça o download e armazene da mesma forma que você guardaria uma chave de exchange. Se for perdida, não poderá ser recuperada, apenas substituída.

4. Verifique se sua assinatura funciona offline. Os exemplos oficiais incluem um teste signing_offline que não requer chave nem conexão de rede. Execute-o primeiro. A maioria dos problemas de integração está relacionada à assinatura, e esse teste identifica esses problemas antes que qualquer outra coisa atrapalhe.

5. Execute o walkthrough no modo demo. Os exemplos estão disponíveis para Go, Rust, Python e TypeScript, e utilizam por padrão exchanges de demonstração. Um único comando conduz você pela conexão, dados de Market, saldos, uma Ordem à vista, uma Ordem de Futuros e o histórico de Ordens. Nenhum dinheiro real é utilizado em nenhum momento.

6. Aponte para uma exchange real. Altere apenas um número — o ID da exchange em — e o mesmo código será executado ao vivo.

Como configurar sem precisar escrever o código você mesmo

Você não precisa criar a integração manualmente.

A referência completa do protocolo é pública e legível por máquinas, e quatro implementações de referência completas estão disponíveis junto a ela. Entregue essa documentação para qualquer assistente de codificação com IA e descreva o que você deseja em linguagem simples: observar a taxa de financiamento em três pares e, quando ela ficar negativa em todos os três, fechar minhas posições longas. Você recebe de volta um script funcional apontado para o ambiente de demonstração, que pode ser executado e ajustado antes de acessar um saldo real.

Essa mediana de 13 minutos se mantém porque as partes mais complexas já existem em quatro idiomas, incluindo assinatura Ed25519, strings de requisição canônica e lógica de reconexão, restando apenas escrever a regra de negociação e nada mais.

O Market continua se expandindo mais rápido do que qualquer processo manual pode acompanhar, então o tempo gasto com integrações se tornou a parte mais cara da configuração.

Dois canais, uma lista de tópicos

Ambos os canais tratam dos mesmos tópicos com os mesmos parâmetros. REST é para um programa que “acorda”, faz uma pergunta e volta a dormir. WebSocket é para um que permanece ativo e reage.

Pelo REST, a resposta de um comando confirma que a tarefa foi aceita, e não concluída. O resultado da execução chega por meio de uma Assinatura WebSocket em orders, positions ou balance, ou consultando novamente esses tópicos. O contador de limite de taxa é compartilhado entre ambos os canais, portanto, trocar de transporte não gera orçamento extra.

O que você terá acesso

Chame conf_enums primeiro. Ele retorna as tabelas de referência que convertem nomes de exchanges nos IDs numéricos em que todos os outros tópicos esperam — Binance é 2, Binance demo é 101. O tópico manual retorna o catálogo ao vivo de todos os tópicos com seus limites de taxa atuais, para que seu código possa ler os limites em vez de defini-los manualmente.

Um campo que vale a pena usar desde o primeiro dia: apiid. É a sua própria tag em uma Ordem, com até 250 caracteres, e ela retorna em todos os relatórios futuros dessa Ordem. Coloque o nome e a versão da estratégia nela. Quando dois dos seus programas fazem Negociação no mesmo par, essa tag é a única coisa que indica qual deles executou cada ação.

A API da Bitsgap é segura para conectar?

A conexão da Bitsgap com sua exchange não é alterada. Ela é exclusiva para negociações e nunca teve permissão de saque. A API adiciona uma conexão separada entre seu programa e a Bitsgap, assinada com um par de chaves Ed25519 que você gera e controla. Ed25519 é um esquema de assinatura, não uma senha: você mantém a chave privada, a Bitsgap armazena apenas a chave pública, e o segredo nunca trafega pela rede. As solicitações não podem ser reproduzidas, pois cada uma carrega um nonce novo e um carimbo de data/hora que expira em dez segundos. Revogue a chave e todas as sessões abertas são encerradas imediatamente.

Os limites, em números

Dois desses fatores influenciam como você constrói. Os contadores de taxa são compartilhados entre REST e WebSocket por tópico, então um LOOP de polling consome o orçamento que uma Assinatura ao vivo precisa. E exceder a taxa de mensagens por conexão fecha o socket em vez de rejeitar a mensagem, então a lógica de reconexão precisa de backoff, um novo quadro de autenticação e uma nova Assinatura.

Três fatores costumam causar falhas nas primeiras tentativas, nesta ordem: um relógio dessincronizado, um nonce reutilizado e a reserialização do corpo da requisição após a assinatura. O payload é assinado byte por byte, então uma chave fora de ordem ou um espaço extra gera uma assinatura diferente. Envie exatamente a mesma string que você assinou.

Teste sem gastar nada

As exchanges de demonstração funcionam como as reais. Ordens, execuções, posições, saldos — tudo isso sem envolver dinheiro de verdade. demo_market_reset restaura a Conta ao estado inicial, permitindo que você leve uma estratégia ao limite e recomece com apenas um comando.

A API é Free em todos os planos, inclusive no plano Free de US$0. Sem cartão, sem upgrade, sem período de Teste. Crie uma Conta, gere uma chave e comece a assinar solicitações hoje mesmo.

Perguntas Frequentes

O que é a API da Bitsgap? Uma API pública que permite que seu próprio programa leia dados de Market e realize operações em qualquer corretora conectada à sua Conta Bitsgap. Os canais REST e WebSocket compartilham uma lista única de tópicos, autenticados com um par de chaves Ed25519 que você gera e controla.

A API da Bitsgap é Free? Sim. Ela está incluída em todo plano, inclusive no plano Free, sem custo adicional.

Preciso saber programar? Você precisa ser capaz de executar um script. Escrevê-lo é, em grande parte, opcional: a referência do protocolo e quatro implementações de referência completas são públicas, então um assistente de codificação com IA pode gerar uma integração funcional a partir de uma descrição em linguagem simples.

Quais linguagens de programação são suportadas? Qualquer linguagem que consiga fazer uma requisição HTTPS e calcular uma assinatura Ed25519. Exemplos oficiais prontos para uso são fornecidos em Go, Rust, Python e TypeScript.

A API pode sacar meus fundos? Não. A Bitsgap se conecta à sua corretora com uma chave exclusiva para negociações, que nunca teve permissão de saque, e a API não altera isso. Ela adiciona um canal assinado separado entre seu programa e a Bitsgap, que pode ser revogado a qualquer momento.

REST ou WebSocket — qual devo usar? REST para consultas pontuais e scripts agendados. WebSocket para qualquer situação que exija reação ao movimento de preço ou acompanhamento em tempo real do estado da ordem.

Posso testar sem dinheiro real? Sim. Os exemplos oficiais utilizam, por padrão, exchanges de demonstração, e a Conta demo pode ser redefinida para os saldos iniciais a qualquer momento.

Quanto tempo leva para configurar? O tempo médio desde a criação de uma Chave API até a primeira solicitação assinada bem-sucedida é de 13 minutos, medido entre contas Bitsgap que conectaram uma. [Adicionar janela de medição antes de publicar]