Saltar al contenido principal

OrderBook en tiempo real

Canal WebSocket público para recibir actualizaciones en tiempo real del libro de órdenes (OrderBook) de todos los mercados activos.


📈 Datos de mercado en tiempo real

Este WebSocket permite mostrar el OrderBook actualizado de todos los símbolos activos, ideal para vistas de trading, profundidad de mercado y análisis en tiempo real.


🌐 Conexión al WebSocket

Conexión pública

  • URL: wss://tu-backend.com/ws
  • La conexión es pública (no requiere autenticación).
  • El frontend debe abrir una conexión WebSocket para comenzar a recibir datos.
const socket = new WebSocket('wss://tu-backend.com/ws');

socket.onopen = () => {
console.log('Conectado al OrderBook en tiempo real');
};

📡 Evento principal: orderbook_update

orderbook_update

Evento emitido cada vez que se actualiza el libro de órdenes de un símbolo.

{
"symbol": "BTCUSDT",
"bids": [
["50000.0", "0.5"],
["49950.0", "1.2"]
],
"asks": [
["50010.0", "0.3"],
["50020.0", "0.7"]
],
"timestamp": 1687000000000
}

Campos:

  • symbol: Símbolo del mercado
  • bids: Órdenes de compra [precio, cantidad]
  • asks: Órdenes de venta [precio, cantidad]
  • timestamp: Tiempo UNIX en milisegundos del último update

🔎 Símbolos y cobertura

Cobertura de mercados

  • Se envían datos para todos los símbolos activos.
  • El frontend debe filtrar y mostrar solo los símbolos que necesite.

Ejemplo de filtrado:

socket.onmessage = (event) => {
const data = JSON.parse(event.data);
if (data.symbol === 'BTCUSDT') {
updateOrderBookUI(data);
}
};

⏱️ Frecuencia y profundidad

Snapshot + updates incrementales

  • Al conectar:

    • Se envía un snapshot inicial con hasta 50 niveles de profundidad.
  • Luego:

    • Se envían updates incrementales con los 10 mejores niveles de bids y asks.

📝 Recomendaciones para el frontend

Buenas prácticas

  • Mantener la conexión WebSocket abierta.
  • Implementar reconexión automática ante desconexiones.
  • No renderizar todos los símbolos si no es necesario (optimización).
  • Usar estructuras eficientes para actualizar el OrderBook (diff / merge).

📋 Resumen rápido

Características del OrderBook

CaracterísticaDetalle
URL WebSocketwss://tu-backend.com/ws
AutenticaciónNo requerida
Evento principalorderbook_update
Datos enviadosBids y Asks
Profundidad inicialHasta 50 niveles
ActualizacionesTop 10 niveles (incremental)
SímbolosTodos los activos

📝 Notas Importantes

Notas finales

  • Diseñado para lectura intensiva y visualización en tiempo real.
  • Ideal para OrderBook, depth chart y herramientas de trading.
  • El backend controla la frecuencia para evitar sobrecarga.