Liquidationsübersicht für ein TradFi-Symbol
Liquidationsübersicht für ein TradFi-Symbol
/api/liquidations/tradfi-symbolAnfrage
Query-Parameter
| Name | Typ | Erforderlich | Standard | Zulässige Werte | Beschreibung |
|---|---|---|---|---|---|
| symbol | string | Erforderlich | — | — | TradFi-Symbol (Aliasse werden akzeptiert); 400, wenn es sich nicht auflösen lässt; 404, wenn keine Liquidationshistorie vorliegt. Beispiel: SNDK |
Beispielanfrage
curl -s "https://www.coinboss.com/api/liquidations/tradfi-symbol?symbol=SNDK"Antwortfelder
Die Feldtabelle wird aus echten Antworten erzeugt und führt daher genau das auf, was der Endpunkt zurückgibt. In Pfaden steht a[] für Array-Elemente und {*} für Objekte, deren Schlüssel ein dynamischer Name ist, etwa ein Coin oder eine Börse.
| Feld | Typ | Einheit | Beschreibung |
|---|---|---|---|
| success | boolean | — | true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`. |
| now | number | ms | Serverzeit beim Erstellen der Antwort. |
| symbol | string | — | Instrumentensymbol in der von CoinBoss normalisierten Form (zum Beispiel BTCUSDT). |
| is_alias_input | boolean | — | True, wenn das angefragte `symbol` ein Alias ist, der einem anderen kanonischen Symbol zugeordnet wurde. |
| canonical_symbol | string | — | Kanonisches Symbol, unter dem alle Aliasse dieses Basiswerts aggregiert werden; derselbe Wert wie `symbol`. |
| merged_from | array | — | In dieser Zeile zusammengeführte Quellen. |
| merged_from[] | string | — | In dieser Zeile zusammengeführte Quellen. |
| display_name | string | — | Anzeigename. |
| contract_name | string | — | Hinterlegter Name des tokenisierten Kontrakts dieses Basiswerts; leerer String, wenn keiner bekannt ist. |
| contract_type | string | — | `perpetual` oder `delivery`. |
| asset_class | string | — | `stock`, `index`, `commodity` oder `forex`. |
| subclasses | array | — | Unterschiedliche Tags der Anlage-Unterklasse, die in den Liquidationsdatensätzen dieses Symbols vorkommen. |
| subclasses[] | string | — | Ein Tag der Anlage-Unterklasse, z. B. `common_stock` oder `unspecified`. |
| exchanges | array | — | Börsen. |
| exchanges[] | string | — | Börsen. |
| dexes | array | — | Dezentrale Börsen. |
| dexes[] | string | — | Dezentrale Börsen. |
| first_ts | number | ms | Zeitstempel. |
| last_ts | number | ms | Zeitstempel. |
| cnt_30d | number | count | Anzahl der Liquidationsdatensätze für dieses Symbol in den letzten 30 Tagen. |
| tier | string | — | Aktivitätsstufe aus `cnt_30d`: `T1` ≥ 1000, `T2` 200–999, `T3` 50–199, `T4` 10–49, `none` unter 10. |
| min_cnt_30d | number | count | Mindestanzahl an Liquidationen in 30 Tagen (10), die ein Symbol benötigt, um im Symbolverzeichnis aufgeführt zu werden. |
| overview | object | — | Übersichtsblock. dynamische Schlüssel: 1h,4h,12h,24h,7d,30d |
| overview.{*} | object | — | Übersichtsblock. |
| overview.{*}.long_usd | number | USD | Long-Seite. |
| overview.{*}.short_usd | number | USD | Short-Seite. |
| overview.{*}.total_usd | number | USD | Gesamtzahl. |
| overview.{*}.cnt | number | — | Anzahl. |
| class_evidence | array | — | Bis zu 3 häufigste Belege für die Zuordnung des Symbols zu einer Anlageklasse, häufigster zuerst. |
| class_evidence[] | object | — | Ein Belegeintrag mit seiner `source`, dem String `evidence` und der Anzahl der Datensätze (`cnt`), die ihn tragen. |
| class_evidence[].source | string | — | Herkunft des Werts. |
| class_evidence[].evidence | string | — | Roher Klassifikationsbeleg, der mit der Liquidation erfasst wurde, z. B. `desc:common_stock`. |
| class_evidence[].cnt | number | — | Anzahl. |
Erzeugt 2026-11-11 23:00 UTC aus 1 echten Antworten.
Beispielantwort
/api/liquidations/tradfi-symbol?symbol=SNDK · Echte Antwort, erfasst 2026-11-13 03:58:43 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: overview hatte 6 Elemente; exchanges hatte 9 Elemente.
- "success"true
- "now"1794542323216
- "symbol""SNDK"
- "is_alias_input"false
- "canonical_symbol""SNDK"
- "merged_from"
- "SNDK"
- "display_name""Sandisk"
- "contract_name""Sandisk"
- "contract_type""stock"
- "asset_class""stock"
- "subclasses"
- "common_stock"
- "unspecified"
- "exchanges"
- "aster"
- "binance"
- "bitget"
- "bybit"
- "gate"
- "htx"
- "hyperliquid"
- "lighter"
- "dexes"
- "io"
- "xyz"
- "first_ts"1781766257143
- "last_ts"1794542028089
- "cnt_30d"55476
- "tier""T1"
- "min_cnt_30d"10
- "overview"
- "1h"
- "4h"
- "class_evidence"
Details
- Authentifizierung
- Keine. Öffentlicher Endpunkt.
- Rate-Limit
- 1200 Anfragen pro Minute und IP
- Server-Cache
- 20s
- Edge-Micro-Cache
- 10s
- Aktualisierungsintervall
- Echtzeit (WebSocket-Push der Börsen); REST-Abfrage: okx alle 15 s, gate alle 25 s, htx alle 5 min; Fill-Batches des hyperliquid-Nodes werden alle 5 s eingelesen
- Zeitfenster
- rollierende Zeitfenster 1 h, 4 h, 12 h, 24 h, 7 d, 30 d für ein Symbol
- Datenquellen
- Liquidationen von Nicht-Krypto-Perpetual-Kontrakten (tokenisierte Aktien, Indizes, Rohstoffe, FX), erfasst von denselben eigenen Liquidations-Collectoren über 10 Börsen (z. B. binance, okx, hyperliquid, gate, bybit, bitget) und über einen Anlageklassen-Klassifikator abgetrennt.
- Börsenabdeckung
- 10 in den letzten 30 Tagen beobachtete Börsen (binance, okx, hyperliquid, gate, bybit, bitget, lighter, aster, htx, bitfinex); Anlageklassen stock / index / commodity / forex (ein kleiner Anteil ist als „unknown“ klassifiziert); die Historie beginnt am 2026-06-17
- Einheiten
- USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated
- Methode
- per window: long_usd, short_usd, total_usd = SUM(value_usd), cnt; tier from the 30-day event count (T1 >= 1000, T2 200-999, T3 50-199, T4 10-49, none < 10)
- Zeitstempel
- Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
- Antwortformat
- json
- Stabilität
- Stabil
Live-Status
Verfügbarkeit, letzte 30 Tage
100 % von 409 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
/api/liquidations/tradfi-symbolVerfügbarstring — TradFi symbol (aliases accepted); 400 if it cannot be resolved; 404 when no liquidation history.
https://www.coinboss.com/api/liquidations/tradfi-symbol?symbol=SNDKMehr in dieser Kategorie
- Liquidationsübersicht für TradFi-Perpetual-Kontrakte /api/liquidations/tradfi
- Liste der TradFi-Symbole mit Liquidationen im Zeitfenster /api/liquidations/tradfi-asset-list
- Liquidations-Ranking je Symbol für TradFi-Perpetual-Kontrakte /api/liquidations/tradfi-assets
- Liquidationen von TradFi-Perpetual-Kontrakten, aufgeteilt nach Börse /api/liquidations/tradfi-exchanges
- Liquidations-Feed für TradFi-Perpetual-Kontrakte /api/liquidations/tradfi-feed
- Größte Liquidationsorders bei TradFi-Perpetual-Kontrakten /api/liquidations/tradfi-largest
- Liquidationssummen für TradFi-Perpetual-Kontrakte über mehrere Zeitfenster /api/liquidations/tradfi-overview
- Liquidationsübersicht für ein TradFi-Symbol /api/liquidations/tradfi-symbol
- Liquidationszeitreihe für ein TradFi-Symbol /api/liquidations/tradfi-symbol-chart
- Liquidationen eines TradFi-Symbols, aufgeteilt nach Börse /api/liquidations/tradfi-symbol-exchanges
- Größte Liquidationen für ein TradFi-Symbol /api/liquidations/tradfi-symbol-largest
- TradFi-Symbole mit Liquidationshistorie /api/liquidations/tradfi-symbols
- TradFi-Liquidationstabelle /api/liquidations/tradfi-table
- Zeitreihe der Gesamtliquidationen für TradFi-Perpetual-Kontrakte /api/liquidations/tradfi-total-chart
- Kurse von Pre-IPO-Kontrakten /api/preipo/list
- Liste der Aktien-Basiswerte /api/stock-detail-list
- Details zu einem Aktien-Basiswert /api/stock-detail/:underlying
- Liste der Aktieninstrumente /api/stocks/list
- An Börsen gelistete Perpetual-Kontrakte auf Aktien / tokenisierte Aktien /api/tabs17/exchange-stocks
- Kurse kryptobezogener Aktien /api/tabs17/stocks