WebSocket
WebSocket es un protocolo para una conexión bidireccional persistente sobre TCP: el cliente abre la conexión una vez y, desde entonces, el servidor envía mensajes en cuanto hay datos nuevos. El protocolo está definido en el RFC 6455 (2011); las URL empiezan por ws:// o wss://, esta última cifrada con TLS.
Cómo funciona la conexión
La conexión empieza como una petición HTTP normal con el encabezado Upgrade: websocket. El servidor responde 101 Switching Protocols y, a partir de ahí, los mensajes fluyen en ambos sentidos por la misma conexión TCP sin nuevas peticiones. Las tramas de control ping y pong comprueban que el otro extremo sigue ahí.
Con una API REST hay que pedir cada actualización, y eso es polling. Con WebSocket el servidor envía las actualizaciones por sí mismo, pero hay que mantener viva la conexión, reabrirla tras una caída y procesar el flujo tan rápido como llega.
WebSocket en los exchanges
Los exchanges emiten operaciones y cambios del libro de órdenes por WebSocket. En Binance, el flujo btcusdt@trade envía cada operación de BTC/USDT y btcusdt@depth@100ms, los cambios del libro cada 100 ms (documentación de Binance).
// Navegador: operaciones BTC/USDT de Binance, un mensaje por operación
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); // precio y cantidad
};
El flujo de profundidad envía solo los cambios. El libro completo se construye a partir de una instantánea REST (/api/v3/depth) más los eventos del flujo, casados por el ID de actualización; si se pierde un evento, el libro se reconstruye desde cero. Una conexión de Binance dura como máximo 24 horas.
WebSocket y Genesis API
Genesis API no tiene WebSocket: los datos se sirven por REST y el plan fija la frescura de la salida, de 60 segundos en Trial a 5 segundos en Max. Genesis Arbitrage recoge por su cuenta los flujos de los exchanges: en la respuesta del libro de órdenes del mercado, el campo source indica si un libro llegó por WebSocket (ws) o por REST (rest), y age_sec da su antigüedad en segundos.
| Tarea | Qué conviene |
|---|---|
| Enviar órdenes y reaccionar en fracciones de segundo | El WebSocket y la API de trading del exchange |
| Mantener en memoria el libro de órdenes completo de un par | El WebSocket del exchange más una instantánea REST |
| Escanear spreads en más de 20 exchanges, alertas, paneles | Genesis API por REST, consultada a la frescura del plan |
No se puede operar a través de Genesis API: las órdenes se envían por la API del propio exchange, bajo tu responsabilidad.
Véase también: latencia, webhook, API de libro de órdenes, API de criptomonedas: tipos y cómo elegir.
Preguntas y respuestas
¿Tiene Genesis API un WebSocket?
No. Todas las peticiones son llamadas HTTP GET a una API REST con respuestas JSON, y la frescura de los datos depende del plan: 60, 30, 10 o 5 segundos.