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ística | Detalle |
|---|---|
| URL WebSocket | wss://tu-backend.com/ws |
| Autenticación | No requerida |
| Evento principal | orderbook_update |
| Datos enviados | Bids y Asks (top 10 niveles) |
| Símbolos | Todos activos |
| Profundidad inicial | Hasta 50 niveles |
| Actualizaciones | Incrementales en tiempo real |