Orderbook en vivo
Cargando la demo interactiva…
La demo de arriba corre el SDK de verdad (createPredictions, createRealtime) con createMockFetch, withPredictionsRoutes y createMockRealtime de @getenginex/sdk/testing: ninguna llamada sale a la red. El libro es público: la base viene de markets.getOrderbook y cada orderbook_update reemplaza la base (la demo trata el mensaje como el libro completo, que es la convención más segura mientras el formato del delta no está confirmado; consulta el aviso más abajo). Drop the connection pierde una operación a propósito y onResync recarga el libro por HTTP. Después del login, el formulario envía una orden límite (precio de 1 a 99) o a mercado (sin precio) con orders.place y una Idempotency-Key por intención; la orden enviada también aparece en el libro, por el tiempo real. En el escenario Network failure la respuesta se pierde y el reintento reutiliza la clave y recibe la misma orden. La clave aparece enmascarada en el panel Under the hood, igual que la URL del WebSocket (token).
predictionsTopics.orderbook({ marketId }) avisa cada cambio en el orderbook de un mercado sin polling. Los conceptos (conexión, estado, onResync) están en Realtime. El tópico es público: funciona sin login.
1. Base por HTTP, luego el tiempo real
El SDK no aplica deltas: la base viene de markets.getOrderbook y la app decide cómo combinar las actualizaciones con ella.
import { createRealtime } from '@getenginex/sdk/realtime'
import { createPredictions } from '@getenginex/sdk-predictions'
import { predictionsTopics } from '@getenginex/sdk-predictions/realtime'
const predictions = createPredictions(enginex)
const realtime = createRealtime(enginex)
async function loadBook(marketId: string) {
const book = await predictions.markets.getOrderbook({ marketId, depth: 20 })
render(book)
}
async function watchBook(marketId: string) {
await loadBook(marketId) // initial base
const topic = predictionsTopics.orderbook({ marketId })
const off = realtime.subscribe(topic, (update, meta) => {
// update: { marketId, bids, asks, lastPriceYes, lastPriceNo, spread, updatedAt }
if (meta.kind === 'snapshot') return render(update) // full snapshot (sequenced mode)
applyUpdate(update) // app rule, see the warning below
})
// after a drop and reconnection, reload the base over HTTP
const offResync = realtime.onResync(topic, () => void loadBook(marketId))
return () => {
off()
offResync()
}
}Semántica del delta
El gateway publica cada orderbook_update en el formato del orderbook, pero el SDK no garantiza la convención de aplicación: no está verificado si un mensaje trae el libro completo o solo los niveles que cambiaron, ni si quantity: 0 elimina el nivel. Por eso el SDK no trae un helper de merge. Si tu gateway publica niveles parciales, confirma la convención con el equipo del gateway antes de mezclar; el camino más seguro es tratar cada mensaje como la instantánea actual y recargar por HTTP en onResync.
Snapshot en modo secuenciado
Solo en modo single-tenant (WS_SEQUENCED=true) el gateway numera los mensajes y envía un snapshot al suscribirse. En el tópico de orderbook ese snapshot tiene el mismo formato que orderbook_update y se entrega con meta.kind === 'snapshot' (y meta.seq). En producción multi-tenant no hay snapshot ni seq: un mensaje perdido en una caída no es detectable, y onResync es lo que mantiene la pantalla correcta.
Otros tópicos
// executed trades
realtime.subscribe(predictionsTopics.trades({ marketId }), (trade) => {
// { tradeId, marketId, side: 'yes' | 'no', price, quantity, makerFee, takerFee, executedAt }
})
// prices, volume and market status
realtime.subscribe(predictionsTopics.market({ marketId }), (m) => {
// { marketId, eventId, status, lastPriceYes, lastPriceNo, volume24h, totalVolume, openInterest,
// bestBidYes?, bestAskYes?, bestBidNo?, bestAskNo?, updatedAt }
})En trades, el snapshot del modo secuenciado es el historial de precios crudo del gateway (un formato distinto de trade_update): el SDK no lo entrega (como el balance del core); las operaciones nuevas siguen llegando, y la base viene de markets.getPriceHistory. En market, el snapshot tiene el mismo formato que market_update y se entrega.
Órdenes en vivo
predictionsTopics.orders() es privado: usa el usuario de la sesión y realtime.subscribe lanza UNAUTHENTICATED sin login. Cada cambio de estado de una orden del usuario llega como un OrderStatusUpdate:
const off = realtime.subscribe(predictionsTopics.orders(), (order) => {
// { orderId, marketId, side, direction, status, price, quantity, filledQuantity, remainingQuantity,
// lastFillPrice?, lastFillQuantity?, lastFillTradeId?, updatedAt }
if (order.status === 'filled') toast('Order filled')
})
// reload the orders over HTTP (private topic: applies to the session's user)
realtime.onResync(predictionsTopics.orders(), () => void predictions.orders.list())side, direction y status llegan en minúsculas ('yes', 'buy', 'partial'), aunque el gateway publique ORDER_SIDE_YES: el SDK acepta los dos estilos. No uses el evento para acreditar saldo: wallet.getBalance() y coreTopics.balance() son la fuente del dinero.
Pruebas
import { createMockRealtime } from '@getenginex/sdk/testing'
const mock = createMockRealtime()
const enginex = createEnginexClient({ /* ... */ webSocket: mock.webSocket })
// ... subscribe, wait for the connection to open
mock.emit('predictions:orderbook:mkt-1', 'orderbook_update', {
market_id: 'mkt-1',
bids: [{ price: 61, quantity: 100, order_count: 2 }],
asks: [{ price: 63, quantity: 50, order_count: 1 }],
last_price_yes: 62,
last_price_no: 38,
spread: 2,
updated_at: '2026-09-30T12:00:00Z',
})
mock.emitSequenced('predictions:orderbook:mkt-1', 'snapshot', 1, { /* same payload */ })