Órdenes activas en tiempo real
Canal Socket.IO para recibir y actualizar órdenes activas en tiempo real por usuario. Actualmente deprecado (no activo por el momento).
⛔ Deprecado (no disponible por ahora)
Este canal no está activo actualmente. La documentación se conserva como referencia para una posible reactivación futura. No debe integrarse en producción en este momento.
🚀 Conexión y autenticación
Conexión Socket.IO
- Conectate al servidor Socket.IO usando la URL provista por el backend (ej:
https://api.tuapp.com). - Para acceder a órdenes activas, emití
join-trade-roomcon eluserIddel usuario autenticado. - No se requiere token adicional para la conexión Socket; el backend valida el
userIdinternamente.
🔄 Flujo de comunicación
1) Unirse a la sala del usuario
join-trade-room (frontend → backend)
{
"event": "join-trade-room",
"payload": {
"userId": 12345
}
}
joined-trade-room (backend → frontend)
{
"event": "joined-trade-room",
"payload": {
"room": "user-trade-room-12345"
}
}
2) Recepción de órdenes activas
order_update (si hay órdenes activas)
{
"event": "order_update",
"payload": [
{
"orderId": "abc123",
"symbol": "BTCUSDT",
"side": "Buy",
"price": "27000.00",
"quantity": "0.5",
"status": "New"
}
]
}
no_active_orders (si no hay órdenes activas)
{
"event": "no_active_orders",
"payload": {
"message": "Sin órdenes activas"
}
}
3) Actualizaciones en tiempo real
Actualizaciones
- El backend emite
order_updatecon la lista actualizada ono_active_orderssi ya no quedan órdenes. - El frontend debe actualizar la interfaz según el evento recibido.
📝 Consideraciones para el frontend
Notas de implementación
- Mantener la conexión abierta para recibir actualizaciones en tiempo real.
- Si se pierde la conexión, reconectar y volver a emitir
join-trade-roomcon eluserId. - El formato de órdenes sigue el estándar de Bybit para órdenes activas.
- La sala es exclusiva por usuario (no hay datos compartidos entre usuarios).
📚 Resumen de eventos
Eventos del canal
| Evento | Descripción | Payload |
|---|---|---|
join-trade-room | Solicita unirse a la sala de órdenes activas | { userId: number } |
joined-trade-room | Confirmación de unión a la sala | { room: string } |
order_update | Lista actualizada de órdenes activas | Array<Orden> |
no_active_orders | No hay órdenes activas | { message: string } |
📝 Estado del feature
Estado actual
Deprecado: no tenemos este canal activo por el momento. Se mantiene la documentación solo como referencia para una posible activación futura.