Qual API devo usar? REST versus WebSocket

Última atualização: 8 de ago. de 2025

Nossas APIs fornecem uma maneira de interagir programaticamente com nossas plataformas, mas ambas as plataformas oferecem duas interfaces diferentes: no Spot, REST e WebSocket (v1 e v2), e no Futures, ambas as APIs REST e WebSocket também são fornecidas. Às vezes, escolher a interface mais apropriada para uma tarefa específica pode ser uma decisão difícil.

Diferenças entre REST e WebSocket

No Spot, embora ambos forneçam os mesmos dados de mercado (livros de ordens, histórico de negociações, etc.) e os mesmos dados de conta (saldos de conta, status de ordens/negociações, etc.), REST e WebSocket o fazem de maneiras significativamente diferentes.

REST oferece uma interface do tipo chamada/resposta (pergunta/resposta) e fornece um instantâneo dos dados atuais, enquanto WebSocket oferece uma interface do tipo streaming ao vivo e fornece atualizações em tempo real.

Uma analogia seria a diferença entre uma fotografia e um vídeo, pois, mediante solicitação, uma fotografia fornece um instantâneo do assunto, mas sem atualizações adicionais, enquanto um vídeo fornece uma visão em tempo real do assunto com atualizações de streaming ao vivo.

Facilidade de implementação

Embora nem REST nem WebSocket sejam difíceis de implementar, é geralmente aceito que REST é menos complexo, o que permite que o tempo de desenvolvimento seja reduzido e quaisquer problemas subsequentes sejam resolvidos mais rapidamente.

REST é baseado em requisições HTTPS padrão que estão incluídas nas bibliotecas padrão de todas as linguagens de programação modernas (e poderiam ser facilmente codificadas do zero, se não), enquanto WebSocket é baseado em um upgrade WSS de HTTPS que geralmente requer bibliotecas de terceiros adicionais (como nossa biblioteca WebSocket recomendada para Python).

Nossas páginas de suporte da API fornecem código de exemplo pronto para uso para REST e WebSocket, portanto, a escolha da interface pode ser feita usando critérios mais críticos do que a facilidade de implementação.

Qual interface de API devo usar? (REST ou WebSocket)

Dependendo da tarefa em questão, a escolha ideal seria apenas REST, apenas WebSocket ou, mais provavelmente, uma combinação de REST e WebSocket.

Para tarefas que exigem apenas atualizações ocasionais de dados de mercado, REST seria a escolha preferida. Por exemplo, um bot de custo médio diário que exigisse dados de mercado apenas uma vez a cada 24 horas não precisaria de dados de mercado de streaming em tempo real, portanto, os endpoints de dados de mercado REST seriam mais do que adequados.

Para tarefas que exigem os dados de mercado mais atualizados disponíveis, WebSocket seria a escolha preferida. Por exemplo, um bot de arbitragem precisaria de dados de mercado em tempo real de vários mercados para aproveitar as discrepâncias momentâneas de preços, portanto, os feeds de dados de mercado WebSocket seriam a escolha ideal.

Na maioria dos casos (como a maioria dos bots de negociação), uma combinação de REST e WebSocket permitiria a implementação mais eficaz. Por exemplo, um aplicativo móvel pode exigir dados de mercado em tempo real para seus gráficos, enquanto precisa de dados de conta apenas ocasionalmente (ao fazer uma negociação ou uma transação de financiamento, por exemplo), portanto, usar os feeds de dados de mercado WebSocket juntamente com os endpoints de status de ordem/negociação/financiamento REST seria a combinação mais eficiente.

Onde encontrar conselhos para uma implementação de API ideal

Nossa equipe de suporte da API terá prazer em discutir sua implementação de API com você e fazer sugestões para a maneira ideal de usar nossa API com base no seu cenário de uso pretendido.

Precisa de mais ajuda?