Skip to main content

OrderBook en tiempo real


Permite recibir actualizaciones en tiempo real del libro de órdenes (OrderBook) de todos los mercados activos.


🌐 Conexión al WebSocket

  • URL:

    wss://tu-backend.com/ws

    (Reemplazar con la URL real del servidor)

  • La conexión es pública, no requiere autenticación.

  • El frontend debe abrir una conexión WebSocket a esta URL para recibir las actualizaciones.


📡 Eventos y datos recibidos

Evento principal: orderbook_update

Se recibe un objeto JSON con la siguiente estructura:

{
"symbol": "BTCUSDT",
"bids": [
["50000.0", "0.5"],
["49950.0", "1.2"]
],
"asks": [
["50010.0", "0.3"],
["50020.0", "0.7"]
],
"timestamp": 1687000000000
}
  • symbol: Símbolo del mercado.
  • bids: Lista de órdenes de compra, cada elemento es [precio, cantidad].
  • asks: Lista de órdenes de venta, mismo formato que bids.
  • timestamp: Marca de tiempo UNIX en milisegundos del último update.

🔎 Símbolos y cobertura

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

⏱️ Frecuencia y profundidad

  • Al conectar, se recibe un snapshot completo con hasta 50 niveles de profundidad.
  • Luego, se envían actualizaciones incrementales con los 10 mejores niveles de bids y asks.

📝 Recomendaciones para el frontend

  • Mantén la conexión abierta para recibir datos en tiempo real.
  • Implementa reconexión automática en caso de desconexión.
  • Filtra y muestra solo los símbolos necesarios.

📋 Resumen rápido

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