Flusso di liquidazioni e prezzi

Un'unica connessione WebSocket invia le singole liquidazioni e gli aggiornamenti di prezzo. Non esiste un messaggio di sottoscrizione: alla connessione il server invia un frame `history` e un frame `price_snapshot`, poi i frame `liquidation` e `price` man mano che si verificano.

WSwss://www.coinboss.com/ws

Richiesta

Non esiste un messaggio di sottoscrizione: il server inizia a inviare dati non appena la connessione si apre. Quando il socket si chiude, riconnettersi dopo un'attesa e recuperare via HTTP i dati mancanti.

Richiesta di esempio

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

Campi della risposta

Tipo di frame	Invio	Struttura
history	una volta, alla connessione	{ "type": "history", "data": [ <liquidation>, ... ] }
price_snapshot	una volta, alla connessione	{ "type": "price_snapshot", "data": { "<SYMBOL>": <price>, ... }, "ts": <ms> }
liquidation	a ogni singola liquidazione	{ "type": "liquidation", "data": <liquidation> }
price	a ogni variazione di prezzo	{ "type": "price", "symbol": "BTCUSDT", "price": <number>, "ts": <ms> }

Risposta di esempio

Nessun esempio in archivio: l'ultima risposta riuscita era troppo grande per essere visualizzata. Chiamare l'endpoint nel Playground.

Dettagli

Autenticazione: Nessuna. Endpoint pubblico.
Limite di richieste: 1200 richieste al minuto per IP
Cache del server: Senza cache
Frequenza di aggiornamento: Inviati in tempo reale. I frame `liquidation` seguono i feed di liquidazioni degli exchange; i frame `price` seguono gli aggiornamenti dei ticker futures.
Finestra: `history` contiene le singole liquidazioni più recenti al momento della connessione; tutto il resto è in tempo reale.
Fonti dei dati: Feed di liquidazioni degli exchange raccolti da CoinBoss; flusso dei ticker futures.
Timestamp: Millisecondi dall'epoca Unix (UTC) in `ts` / `timestamp`.
Formato della risposta: json-frames
Stabilità: Stabile

Stato in tempo reale

DisponibileVerificato 2026-11-13 03:53:49 UTCHTTP 1014 msSchema non verificato

Disponibilità, ultimi 30 giorni

100% di 407 verifiche superate

Errori

Le chiamate non riuscite hanno la stessa struttura su tutti gli endpoint. L'elenco completo è nella pagina degli errori. Errori e limiti di richieste →

Codice	HTTP	Significato	Che cosa fare
INVALID_PARAM	400	Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto.	Non riprovare senza modifiche; correggere la richiesta.
UNAUTHORIZED	401	L'header `CB-API-KEY` è stato inviato ma la chiave è sconosciuta o revocata. I dati pubblici non richiedono alcuna chiave: rimuovere l'header o usare una chiave valida.	Non riprovare senza modifiche.
FORBIDDEN	403	La route non fa parte dell'API pubblica (interna o riservata agli account).	Non riprovare.
NOT_FOUND	404	Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste.	Non riprovare; verificare il percorso e gli identificatori nel catalogo.
RATE_LIMITED	429	Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere.	Attendere `Retry-After`, poi riprovare con backoff.
INTERNAL	500	Errore imprevisto del server. Il messaggio è volutamente generico; citare `request_id` quando lo si segnala.	Riprovare una volta dopo qualche secondo; se persiste, segnalarlo con l'ID della richiesta.
UPSTREAM_FAILED	503	La fonte di dati alla base di questo endpoint non ha risposto in tempo. Al suo posto non vengono restituiti numeri obsoleti o sostitutivi.	Riprovare con backoff; controllare la pagina di stato.
UNAVAILABLE	501 / 503	Il dataset è temporaneamente non pronto (riscaldamento della cache) oppure l'endpoint non ha ancora una fonte pubblica lecita.	Riprovare più tardi; il catalogo contrassegna gli endpoint non disponibili per scelta progettuale.
REQUEST_FAILED	200	Alcuni endpoint meno recenti rispondono HTTP 200 con `success: false`. Controllare sempre `success`, non solo lo stato HTTP.	Dipende dal messaggio; trattare come una richiesta non riuscita.

Prova

WS/wsDisponibile

Questo è un flusso WebSocket. Connettersi per osservare l'arrivo di messaggi reali; la connessione viene chiusa automaticamente dopo 25 messaggi.

URL della richiestawss://www.coinboss.com/ws

Risposta

Scegliere un endpoint e premere «Invia richiesta». La risposta, gli header e i tempi compariranno qui.

Flusso di liquidazioni e prezzi /ws