Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

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.

TarefaO que serve
Enviar ordens e reagir em frações de segundoO WebSocket e a API de trading da exchange
Manter na memória o order book completo de um parO WebSocket da exchange mais um snapshot REST
Varrer spreads em mais de 20 exchanges, alertas, dashboardsGenesis 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.