Saltar al contenido principal

Ó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-room con el userId del usuario autenticado.
  • No se requiere token adicional para la conexión Socket; el backend valida el userId internamente.

🔄 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_update con la lista actualizada o no_active_orders si 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-room con el userId.
  • 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

EventoDescripciónPayload
join-trade-roomSolicita unirse a la sala de órdenes activas{ userId: number }
joined-trade-roomConfirmación de unión a la sala{ room: string }
order_updateLista actualizada de órdenes activasArray<Orden>
no_active_ordersNo 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.