WSVerfügbar
Liquidations- und Preis-Stream
Eine WebSocket-Verbindung überträgt einzelne Liquidationen und Preis-Updates. Es gibt keine Subscribe-Nachricht: Der Server sendet beim Verbindungsaufbau einen `history`-Frame und einen `price_snapshot`-Frame, danach `liquidation`- und `price`-Frames, sobald die Ereignisse eintreten.
WS
wss://www.coinboss.com/wsAnfrage
Es gibt keine Subscribe-Nachricht: Der Server beginnt mit dem Senden, sobald die Verbindung steht. Wird der Socket geschlossen, verbinden Sie sich mit Verzögerung neu und laden Sie die Lücke über HTTP nach.
Beispielanfrage
# WebSocket needs a WS client; with websocat:
websocat "wss://www.coinboss.com/ws"Antwortfelder
| Frame-Typ | Gesendet | Aufbau |
|---|---|---|
| history | einmal, beim Verbindungsaufbau | { "type": "history", "data": [ <liquidation>, ... ] } |
| price_snapshot | einmal, beim Verbindungsaufbau | { "type": "price_snapshot", "data": { "<SYMBOL>": <price>, ... }, "ts": <ms> } |
| liquidation | bei jeder einzelnen Liquidation | { "type": "liquidation", "data": <liquidation> } |
| price | bei jeder Preisänderung | { "type": "price", "symbol": "BTCUSDT", "price": <number>, "ts": <ms> } |
Beispielantwort
Es ist kein Beispiel gespeichert, weil die letzte erfolgreiche Antwort für die Anzeige zu groß war. Rufen Sie den Endpunkt im Playground auf.
Details
- Authentifizierung
- Keine. Öffentlicher Endpunkt.
- Rate-Limit
- 1200 Anfragen pro Minute und IP
- Server-Cache
- Nicht gecacht
- Aktualisierungsintervall
- In Echtzeit übertragen. `liquidation`-Frames folgen den Liquidations-Feeds der Börsen; `price`-Frames folgen den Aktualisierungen der Futures-Ticker.
- Zeitfenster
- `history` enthält die jüngsten einzelnen Liquidationen zum Zeitpunkt des Verbindungsaufbaus; alles andere ist live.
- Datenquellen
- Von CoinBoss erhobene Liquidations-Feeds der Börsen; Futures-Ticker-Stream.
- Zeitstempel
- Unix-Epoche in Millisekunden (UTC) in `ts` / `timestamp`.
- Antwortformat
- json-frames
- Stabilität
- Stabil
Live-Status
VerfügbarGeprüft 2026-11-13 03:53:49 UTCHTTP 1014 msSchema nicht geprüft
Verfügbarkeit, letzte 30 Tage
100 % von 407 Prüfungen bestanden
Fehler
Fehlgeschlagene Aufrufe haben auf jedem Endpunkt denselben Aufbau. Die vollständige Liste steht auf der Fehlerseite. Fehler und Rate-Limits →
| Code | HTTP | Bedeutung | Empfohlene Reaktion |
|---|---|---|---|
| INVALID_PARAM | 400 | Ein erforderlicher Parameter fehlt oder ein Wert wird nicht akzeptiert. `param` nennt den Parameter, sofern er bekannt ist. | Nicht unverändert wiederholen; die Anfrage korrigieren. |
| UNAUTHORIZED | 401 | Der Header `CB-API-KEY` wurde gesendet, der Schlüssel ist jedoch unbekannt oder widerrufen. Öffentliche Daten erfordern keinen Schlüssel – lassen Sie den Header weg oder verwenden Sie einen gültigen Schlüssel. | Nicht unverändert wiederholen. |
| FORBIDDEN | 403 | Die Route gehört nicht zur öffentlichen API (intern oder nur für Konten). | Nicht wiederholen. |
| NOT_FOUND | 404 | Unbekannte Route, oder der angefragte Coin / die Börse / der Fonds existiert nicht. | Nicht wiederholen; Pfad und Kennungen mit dem Katalog abgleichen. |
| RATE_LIMITED | 429 | Mehr Anfragen, als das Limit pro Minute zulässt. `Retry-After` gibt die Wartezeit in Sekunden an. | `Retry-After` abwarten, dann mit Backoff wiederholen. |
| INTERNAL | 500 | Unerwarteter Serverfehler. Die Meldung ist bewusst allgemein gehalten; geben Sie `request_id` an, wenn Sie den Fehler melden. | Einmal nach einigen Sekunden wiederholen; wenn der Fehler bestehen bleibt, mit der Request-ID melden. |
| UPSTREAM_FAILED | 503 | Die Datenquelle hinter diesem Endpunkt hat nicht rechtzeitig geantwortet. Es werden ersatzweise keine veralteten oder stellvertretenden Zahlen zurückgegeben. | Mit Backoff wiederholen; die Statusseite prüfen. |
| UNAVAILABLE | 501 / 503 | Der Datensatz ist vorübergehend nicht bereit (Cache wird aufgewärmt), oder der Endpunkt hat noch keine rechtmäßige öffentliche Quelle. | Später wiederholen; der Katalog kennzeichnet Endpunkte, die konzeptbedingt nicht verfügbar sind. |
| REQUEST_FAILED | 200 | Einige ältere Endpunkte antworten mit HTTP 200 und `success: false`. Prüfen Sie immer `success`, nicht nur den HTTP-Status. | Hängt von der Meldung ab; als fehlgeschlagene Anfrage behandeln. |
Ausprobieren
WS
/wsVerfügbarDies ist ein WebSocket-Stream. Verbinden Sie sich, um echte Nachrichten eintreffen zu sehen; die Verbindung wird nach 25 Nachrichten automatisch geschlossen.
Anfrage-URL
wss://www.coinboss.com/wsWählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.