WebSocket
WebSocket é um protocolo de conexão bidirecional persistente sobre TCP: o cliente abre a conexão uma vez e, a partir daí, o servidor envia mensagens assim que surgem dados novos. O protocolo é definido na RFC 6455 (2011); as URLs começam com ws:// ou wss://, esta última criptografada com TLS.
Como a conexão funciona
A conexão começa como uma requisição HTTP comum com o cabeçalho Upgrade: websocket. O servidor responde 101 Switching Protocols, e as mensagens passam a fluir nos dois sentidos pela mesma conexão TCP, sem novas requisições. Os quadros de controle ping e pong verificam se o outro lado ainda está lá.
Com uma API REST, cada atualização precisa ser pedida, e isso é polling. No WebSocket o servidor envia as atualizações por conta própria, mas é preciso manter a conexão viva, reabri-la após uma queda e processar o fluxo tão rápido quanto ele chega.
WebSocket nas exchanges
As exchanges transmitem negociações e mudanças do order book por WebSocket. Na Binance, o fluxo btcusdt@trade envia cada negociação de BTC/USDT e btcusdt@depth@100ms, as mudanças do book a cada 100 ms (documentação da Binance).
// Navegador: negociações BTC/USDT da Binance, uma mensagem por negociação
const ws = new WebSocket(
'wss://stream.binance.com:9443/ws/btcusdt@trade'
);
ws.onmessage = (event) => {
const trade = JSON.parse(event.data);
console.log(trade.p, trade.q); // preço e quantidade
};
O fluxo de profundidade envia apenas as mudanças. O book completo é montado a partir de um snapshot REST (/api/v3/depth) mais os eventos do fluxo, casados pelo ID de atualização; se um evento é perdido, o book é refeito do zero. Uma conexão da Binance dura no máximo 24 horas.
WebSocket e Genesis API
A Genesis API não tem WebSocket: os dados são servidos por REST e o plano define a atualidade da saída, de 60 segundos no Trial a 5 segundos no Max. A Genesis Arbitrage coleta os fluxos das exchanges por conta própria: na resposta do order book do mercado, o campo source mostra se um book veio por WebSocket (ws) ou por REST (rest), e age_sec informa sua idade em segundos.
| Tarefa | O que serve |
|---|---|
| Enviar ordens e reagir em frações de segundo | O WebSocket e a API de trading da exchange |
| Manter na memória o order book completo de um par | O WebSocket da exchange mais um snapshot REST |
| Varrer spreads em mais de 20 exchanges, alertas, dashboards | Genesis API por REST, consultada na atualidade do plano |
Não é possível operar pela Genesis API: as ordens passam pela API da própria exchange, por sua conta e risco.
Veja também: latência, webhook, APIs de order book, APIs de criptomoedas: tipos e como escolher.
Perguntas e respostas
A Genesis API tem WebSocket?
Não. Todas as requisições são chamadas HTTP GET a uma API REST com respostas JSON, e a atualidade dos dados depende do plano: 60, 30, 10 ou 5 segundos.