Flujo de liquidaciones y precios

Una única conexión WebSocket envía liquidaciones individuales y actualizaciones de precio. No hay mensaje de suscripción: al conectar, el servidor envía una trama `history` y una trama `price_snapshot`, y después tramas `liquidation` y `price` a medida que se producen.

WSwss://www.coinboss.com/ws

Solicitud

No hay mensaje de suscripción: el servidor empieza a enviar datos en cuanto se abre la conexión. Cuando el socket se cierre, reconecte con un retardo y recupere el hueco por HTTP.

Solicitud de ejemplo

# WebSocket needs a WS client; with websocat:
websocat "wss://www.coinboss.com/ws"

Campos de la respuesta

Tipo de trama	Envío	Estructura
history	una vez, al conectar	{ "type": "history", "data": [ <liquidation>, ... ] }
price_snapshot	una vez, al conectar	{ "type": "price_snapshot", "data": { "<SYMBOL>": <price>, ... }, "ts": <ms> }
liquidation	cada liquidación individual	{ "type": "liquidation", "data": <liquidation> }
price	cada cambio de precio	{ "type": "price", "symbol": "BTCUSDT", "price": <number>, "ts": <ms> }

Respuesta de ejemplo

No se guarda ningún ejemplo porque la última respuesta correcta era demasiado grande para mostrarla. Llame al endpoint en el Playground.

Detalles

Autenticación: Ninguna. Endpoint público.
Límite de solicitudes: 1200 solicitudes por minuto por IP
Caché del servidor: Sin caché
Frecuencia de actualización: Se envía en tiempo real. Las tramas `liquidation` siguen los feeds de liquidaciones de los exchanges; las tramas `price` siguen las actualizaciones de los tickers de futuros.
Ventana: `history` contiene las liquidaciones individuales más recientes en el momento de la conexión; todo lo demás es en vivo.
Fuentes de datos: Feeds de liquidaciones de exchanges recopilados por CoinBoss; flujo de tickers de futuros.
Marcas de tiempo: Milisegundos de época Unix (UTC) en `ts` / `timestamp`.
Formato de respuesta: json-frames
Estabilidad: Estable

Estado en vivo

DisponibleComprobado 2026-11-13 03:53:49 UTCHTTP 1014 msEsquema no comprobado

Disponibilidad, últimos 30 días

100% de 407 comprobaciones superadas

Errores

Las llamadas fallidas tienen la misma estructura en todos los endpoints. La lista completa está en la página de errores. Errores y límites de solicitudes →

Código	HTTP	Significado	Qué hacer
INVALID_PARAM	400	Falta un parámetro obligatorio o un valor no se acepta. `param` indica el nombre del parámetro cuando se conoce.	No reintente sin cambios; corrija la solicitud.
UNAUTHORIZED	401	Se envió la cabecera `CB-API-KEY`, pero la clave es desconocida o está revocada. Los datos públicos no necesitan clave: elimine la cabecera o use una clave válida.	No reintente sin cambios.
FORBIDDEN	403	La ruta no forma parte de la API pública (interna o solo para cuentas).	No reintente.
NOT_FOUND	404	Ruta desconocida, o la moneda / el exchange / el fondo solicitado no existe.	No reintente; compruebe la ruta y los identificadores en el catálogo.
RATE_LIMITED	429	Más solicitudes que el límite por minuto. `Retry-After` indica los segundos de espera.	Espere el tiempo de `Retry-After` y después reintente con espera progresiva.
INTERNAL	500	Error inesperado del servidor. El mensaje es genérico por diseño; cite `request_id` al informar del error.	Reintente una vez tras unos segundos; si persiste, infórmelo con el ID de solicitud.
UPSTREAM_FAILED	503	La fuente de datos de este endpoint no respondió a tiempo. No se devuelven cifras desactualizadas ni sustitutas en su lugar.	Reintente con espera progresiva; consulte la página de estado.
UNAVAILABLE	501 / 503	El conjunto de datos no está listo temporalmente (calentamiento de la caché) o el endpoint aún no tiene una fuente pública lícita.	Reintente más tarde; el catálogo marca los endpoints que no están disponibles por diseño.
REQUEST_FAILED	200	Algunos endpoints antiguos responden HTTP 200 con `success: false`. Compruebe siempre `success`, no solo el estado HTTP.	Depende del mensaje; trátelo como una solicitud fallida.

Pruébelo

WS/wsDisponible

Este es un flujo WebSocket. Conéctese para ver llegar mensajes reales; la conexión se cierra automáticamente tras 25 mensajes.

URL de la solicitudwss://www.coinboss.com/ws

Respuesta

Elija un endpoint y pulse «Enviar solicitud». Aquí aparecerán la respuesta, las cabeceras y los tiempos.

Flujo de liquidaciones y precios /ws