pnclENGINEObtener acceso a la API

CAPACIDAD WEBSOCKET

Capacidad de la API WebSocket de Pinnacle: frames en bruto, no sondeos.

El dimensionamiento de la API REST de Pinnacle parte de un intervalo de sondeo y de un presupuesto por segundo. Un stream WebSocket en bruto elimina ambos y los sustituye por un flujo de frames, un presupuesto de reconexión y una copia del estado de mercado que solo tu cliente mantiene. La planificación de capacidad sigue importando; solo mide cosas distintas.

Qué cambia la API WebSocket de Pinnacle

En REST, la frescura es un calendario que diseñas. Cada actualización es una solicitud, y las solicitudes son lo que miden los planes: 10 por segundo en Core 10 a 99 USD al mes, 30 por segundo en Core 30 a 229 USD al mes. Toda la cuestión de capacidad se reduce a intervalo por alcance, medido contra ese techo.

Un stream WebSocket en bruto invierte el modelo. Una vez que el socket está abierto y suscrito, los frames llegan a medida que los precios se mueven: no hay intervalo de sondeo que ajustar ni presupuesto por segundo que defender en el propio stream. Lo que llega no es una alerta procesada sino el flujo de frames en bruto, y aplicar esos frames para formar una imagen coherente de cada evento y mercado que sigues es trabajo de tu código. La API deja de ser un servicio de consulta y se convierte en un feed del que mantienes una réplica.

Las cuestiones de capacidad que permanecen

Tasa de frames en el pico. El tráfico medio es tranquilo; una jornada completa de sábado o un favorito en vivo no lo son. Dimensiona el parseo, la CPU y las colas aguas abajo para el minuto más cargado que pretendas seguir, no para la media diaria, porque los frames se encolan en tu lado del socket en cuanto tu consumidor se queda atrás.

Coste de reconexión y resincronización. Los sockets se caen. Recuperarse significa volver a suscribirse y reconstruir el estado a partir del snapshot fresco que el socket envía al inicio de cada conexión. Ese snapshot llega por el socket, no a través de tu presupuesto REST, pero un tablero grande viene en varios fragmentos, así que reconstruir lleva tiempo real de parseo justo cuando más ocupado estás.

Almacenamiento del estado. Cada worker que consume el stream conserva su propia copia de los mercados que sigue. Decide qué vive en memoria, qué persistes para reinicios más rápidos y cuánta RAM cuesta una jornada completa de mercados antes de suscribirte a una.

Frames en bruto vs alertas SSE

SSE y WebSocket en bruto son ambos push, pero empujan cosas distintas. Las alertas de caída por SSE están procesadas: el lado del feed ya ha decidido qué cambió y si el movimiento supera un umbral, y tu código reacciona a una notificación. Los frames de WebSocket en bruto no están procesados: tú calculas los cambios, los umbrales y el significado.

Esa división corresponde a dos tipos de consumidor. Si tu producto reacciona a movimientos, SSE encaja: Alertas de caída a 99 USD al mes, o Core 10 + alertas a 149 USD al mes cuando también necesitas 10 solicitudes por segundo de REST. Si tu producto es dueño del estado, una pantalla de precios, un backend de trading, cualquier cosa que renderice el libro en lugar de reportar eventos, los frames en bruto son la entrada correcta. El complemento cuesta 99 USD cada 30 días y es elegible en Core 10, Core 10 + alertas y Core 30; no está disponible en Alertas de caída ni en la clave gratuita.

Comparar planes y complementos

Cuándo quedarse en REST

Si tus lecturas son simples y tu volumen es bajo, REST es la mejor herramienta. Un puñado de eventos, frescura a nivel de minuto, un trabajo lanzado por cron: las 20 solicitudes por minuto y 100 solicitudes por día de la clave gratuita pueden cubrir la evaluación, y Core 10 cubre la mayoría de los paneles de producción, sin nada que mantener entre llamadas. La guía de planificación de capacidad explica cómo convertir deportes, mercados e intervalos en la tasa de solicitudes que necesitas.

El WebSocket se gana su complemento cuando realmente eres dueño del estado en vivo: percepción por debajo del segundo en una jornada relevante, muchos mercados por evento, un producto que renderiza el libro continuamente. En ese punto el complemento de 99 USD cada 30 días en Core 10 y superiores sustituye las matemáticas del intervalo de sondeo por las de la tasa de frames, y la comparación de planes muestra los niveles elegibles uno al lado del otro.

Ver planes de capacidad