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