24h Volumen—Open Interest—24h Liquidationen$1.36B24h Long/Short—BTC-Dominanz—ETH-Dominanz—
App
Sprache ▾
€ EUR ▾
/api/sd/liquidations
GETVerfügbar

Liquidationsübersicht für einen Coin

Eigene Datenschicht: Liquidationsübersicht für einen Coin

GET/api/sd/liquidations

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
coinstringErforderlich——Coin-Symbol; 400, wenn es fehlt. Alias: `base`. Beispiel: BTC

Beispielanfrage

curl -s "https://www.coinboss.com/api/sd/liquidations?coin=BTC"

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.

FeldTypEinheitBeschreibung
successboolean—true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`.
coinstring—Coin-Symbol in Großbuchstaben (zum Beispiel BTC).
nownumbermsServerzeit beim Erstellen der Antwort.
windowsobject—Summen für jedes Zeitfenster (Schlüssel wie `1h`, `4h`, `12h`, `24h`). dynamische Schlüssel: 1h,4h,12h,24h
windows.{*}object—Werte je Zeitfenster.
windows.{*}.long_usdnumberUSDLiquidierte Long-Positionen; null, wenn keine Quelle das Zeitfenster abgedeckt hat.
windows.{*}.short_usdnumberUSDLiquidierte Short-Positionen; null, wenn keine Quelle das Zeitfenster abgedeckt hat.
windows.{*}.total_usdnumberUSDLong + Short.
windows.{*}.countnumber—Anzahl der Liquidationsorders.
windows.{*}.long_pctnumber%Anteil der Longs an der Gesamtsumme.
windows.{*}.max_orderobject—Größte Einzelliquidation im Zeitfenster.
windows.{*}.max_order.exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
windows.{*}.max_order.symbolstring—Instrumentensymbol in der von CoinBoss normalisierten Form (zum Beispiel BTCUSDT).
windows.{*}.max_order.sidestring—Seite der liquidierten Position (`long` = eine Long-Position wurde liquidiert).
windows.{*}.max_order.pricenumber—Letzter Preis in der Kurswährung (USD oder USDT, sofern nicht anders angegeben).
windows.{*}.max_order.qtynumber—Ordergröße in Kontrakten oder Coins, wie von der Börse veröffentlicht.
windows.{*}.max_order.contract_multipliernumber—Coins je Kontrakt, mit denen `qty` in den Nominalwert umgerechnet wird.
windows.{*}.max_order.value_usdnumberUSDNominalwert der Liquidation: price × qty × contract multiplier.
windows.{*}.max_order.timestampnumbermsZeitstempel.
by_exchangeobject—Aufteilung nach Börse für jedes Zeitfenster. dynamische Schlüssel: 1h,4h,12h,24h
by_exchange.{*}array—Aufschlüsselung je Börse.
by_exchange.{*}[]object—Aufschlüsselung je Börse.
by_exchange.{*}[].exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
by_exchange.{*}[].long_usdnumberUSDLong-Seite.
by_exchange.{*}[].short_usdnumberUSDShort-Seite.
by_exchange.{*}[].total_usdnumberUSDGesamtzahl.
by_exchange.{*}[].countnumber—Anzahl der Liquidationsorders.
by_exchange.{*}[].share_pctnumber%Anteil an der Gesamtsumme.
last_event_atnumbermsZeitpunkt der jüngsten Liquidation für diesen Coin.
last_event_age_snumbersSekunden seit diesem Ereignis.
sourcesarray—Zustand jedes Liquidations-Feeds: wie er erhoben wird und wann er zuletzt geliefert hat.
sources[]object—Datenquellen.
sources[].exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
sources[].viastring—Erhebungsmethode (`ws`, `rest`, …).
sources[].statusstring—Zustand des Feeds, beurteilt anhand seiner eigenen Ereigniszeiten und Heartbeats.
sources[].feed_last_event_age_snumber|nullsSekunden seit dem Ereignis.
sources[].ws_heartbeat_age_snumber|nullsSekunden seit dem Ereignis.
sources[].judged_bystring—Gibt an, anhand welches Zeitstempels der Status beurteilt wurde.
sources[].coin_last_event_age_snumber|nullsSekunden seit dem Ereignis.
sources[].min_event_usdnumberUSDKleinste Ordergröße, die der Feed veröffentlicht; kleinere Liquidationen sind an dieser Börse nicht sichtbar.
sources[].notestring|null—Hinweis.
sources[].node_heartbeat_age_snumbersSekunden seit dem Ereignis. kann fehlen
sources[].pipeline_last_event_age_snumbersSekunden seit dem Ereignis. kann fehlen
coverageobject—Was in den obigen Zahlen enthalten ist und was nicht. Vergleichen Sie dies, bevor Sie Summen mit einer anderen Quelle vergleichen.
coverage.collected_exchangesarray—Börsen mit einem öffentlichen Liquidations-Feed, den CoinBoss erhebt.
coverage.collected_exchanges[]string—Erfasste Börsen.
coverage.unavailablearray—Paare aus Börse und Kontrakt, die nicht einbezogen werden konnten, jeweils mit Begründung. Sie werden nie als 0 gezählt.
coverage.unavailable[]object—Elemente, für die keine Daten verfügbar sind, mit Begründung. Werden nie als 0 ausgewiesen.
coverage.unavailable[].exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
coverage.unavailable[].reasonstring—Begründungscode.
methodobject—Klartextangabe der Formeln, die für diese Antwort verwendet wurden.
method.eventstring—Klartexthinweis dazu, was ein Liquidationsereignis ist: eine Liquidationsorder, die vom Stream der Börse übertragen oder von ihrer öffentlichen REST-API zurückgegeben wurde.
method.sidestring—Seite der liquidierten Position (`long` = eine Long-Position wurde liquidiert).
method.value_usdstringUSDNominalwert der Liquidation: price × qty × contract multiplier.
method.dedupestring—Klartexthinweis zur Deduplizierung: Ereignisse sind eindeutig nach Börse, Symbol, Seite, Preis, Wert und Zeitstempel, zuzüglich der Order-ID der Börse, sofern vorhanden.
method.null_rulestring—Klartexthinweis, dass ein Zeitfenster ohne erhobenes Ereignis null statt 0 liefert, und wo Börsen ohne öffentlichen Feed aufgeführt sind.
method.binance_notestring—Klartexthinweis, dass Binance höchstens eine Liquidation pro Symbol und Sekunde überträgt, sodass die Summen für Binance eine Untergrenze darstellen.
method.min_event_usdstringUSDKleinste Order, die der Feed veröffentlicht.

Erzeugt 2026-11-11 23:00 UTC aus 4 echten Antworten.

Beispielantwort

/api/sd/liquidations?coin=BTC · Echte Antwort, erfasst 2026-11-13 03:57:52 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: sources hatte 11 Elemente; windows hatte 4 Elemente; by_exchange hatte 4 Elemente; by_exchange.{*} hatte 10 Elemente; coverage.unavailable hatte 10 Elemente; coverage.collected_exchanges hatte 11 Elemente.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542272606,
    • "windows": {
      • "1h": { … 6 },
      • "4h": { … 6 }
      },
    • "by_exchange": {
      • "1h": [ … 2 ],
      • "4h": [ … 2 ]
      },
    • "last_event_at": 1794542269523,
    • "last_event_age_s": 3,
    • "sources": [
      • { … 9 },
      • { … 9 }
      ],
    • "coverage": {
      • "collected_exchanges": [ … 8 ],
      • "unavailable": [ … 2 ]
      },
    • "method": {
      • "event": "one row per liquidation order pushed by the exchange (WS) or returned by its public REST; REST used to fill WS gaps (OKX/Gate/HTX)",
      • "side": "LONG = a long position was liquidated (forced sell); SHORT = a short position was liquidated (forced buy)",
      • "value_usd": "linear: filled qty × price; inverse: contracts × contract face value (USD)",
      • "dedupe": "unique (exchange, symbol, side, price, value_usd, timestamp) + exchange order id hash where provided",
      • "null_rule": "a window with no collected event returns null (shown as —), never 0; exchanges without a public feed are listed in coverage.unavailable",
      • "binance_note": "Binance WS pushes at most one liquidation per symbol per second (latest only) → Binance totals are a lower bound",
      • "min_event_usd": "collectors keep events above a per-exchange floor (sources[].min_event_usd: OKX/Bitget/HTX/Bitfinex/Deribit ≥ $100; Gate/Hyperliquid/Lighter ≥ $1; Binance/Bybit…"
      }
    }

Geprüfte Stichproben

Neben dem obigen Beispiel ruft die Prüfsonde diesen Endpunkt mit den folgenden Parametern auf und prüft jedes Mal das Schema.

ParameterHTTPLatenzErgebnis
coin=ETH20059 msBestanden
coin=SOL20030 msBestanden
coin=ARKM20017 msBestanden
—4002 msBestanden liefert den erwarteten Fehler

Geprüft 2026-11-13 03:57:52 UTC

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
15s
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
Datenquellen
Liquidationsorders, intern aus den öffentlichen Liquidations-Feeds von 11 Börsen erhoben (z. B. binance, okx, bybit, gate, bitget, htx); Hyperliquid-Liquidationen stammen aus den Fills eines selbst betriebenen Hyperliquid-Nodes.
Börsenabdeckung
11 Börsen mit aktiven Collectoren (binance USDT-M + COIN-M, okx, bybit linear + invers, gate in USDT + BTC abgerechnet, bitget, htx, hyperliquid, aster, lighter, bitfinex, deribit); nur Krypto-Assets (tokenisierte Aktien-, Index-, Rohstoff- und FX-Kontrakte werden dem separaten TradFi-Datensatz zugeordnet); binance überträgt höchstens eine Liquidation pro Symbol und Sekunde, die Summen sind daher eine Untergrenze; Mindestgröße gespeicherter Ereignisse: 100 USD bei okx / bitget / htx / bitfinex / deribit / binance COIN-M, 1 USD bei gate / hyperliquid / lighter, keine bei binance USDT-M / bybit / aster
Einheiten
USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated; max_order price normalized for multiplier contracts
Methode
per window: long_usd, short_usd, total_usd = SUM(value_usd), count; by_exchange breakdown; largest single order
Zeitstempel
Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat
json
Stabilität
Stabil
Verfügbar seit
2026-11-11

Live-Status

VerfügbarGeprüft 2026-11-13 03:57:52 UTCHTTP 200853 msSchema stimmt übereinNeuester Datenpunkt 3s alt

Verfügbarkeit, letzte 30 Tage

100 % von 410 Prüfungen bestanden

Fehler

Fehlgeschlagene Aufrufe haben auf jedem Endpunkt denselben Aufbau. Die vollständige Liste steht auf der Fehlerseite. Fehler und Rate-Limits →

CodeHTTPBedeutungEmpfohlene Reaktion
INVALID_PARAM400Ein erforderlicher Parameter fehlt oder ein Wert wird nicht akzeptiert. `param` nennt den Parameter, sofern er bekannt ist.Nicht unverändert wiederholen; die Anfrage korrigieren.
UNAUTHORIZED401Der 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.
FORBIDDEN403Die Route gehört nicht zur öffentlichen API (intern oder nur für Konten).Nicht wiederholen.
NOT_FOUND404Unbekannte Route, oder der angefragte Coin / die Börse / der Fonds existiert nicht.Nicht wiederholen; Pfad und Kennungen mit dem Katalog abgleichen.
RATE_LIMITED429Mehr Anfragen, als das Limit pro Minute zulässt. `Retry-After` gibt die Wartezeit in Sekunden an.`Retry-After` abwarten, dann mit Backoff wiederholen.
INTERNAL500Unerwarteter 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_FAILED503Die 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.
UNAVAILABLE501 / 503Der 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_FAILED200Einige ä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

GET/api/sd/liquidationsVerfügbar
Parameter

string — Coin symbol; 400 when missing. Alias: `base`.

Anfrage-URLhttps://www.coinboss.com/api/sd/liquidations?coin=BTC
Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.