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

Liquidationskarte

Liquidationskarte (geschätztes Liquidationsvolumen je Preisniveau und Hebel)

GET/api/liq-map

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
symbolstringOptionalBTC—Coin-Symbol; 404, wenn keine Daten vorliegen. Beispiel: BTC
rangestringOptional1d1d, 7dZeitfenster. Beispiel: 1d

Beispielanfrage

curl -s "https://www.coinboss.com/api/liq-map?symbol=BTC&range=1d"

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
symbolstring—Instrumentensymbol in der von CoinBoss normalisierten Form (zum Beispiel BTCUSDT).
rangestring—Angefragtes Zeitfenster.
updatedAtnumbermsZeitpunkt der letzten Aktualisierung der Daten.
currentPricenumber—Aktueller Preis.
binWidthnumberUSDPreisbreite eines Bins: Die Achse umfasst ±10 % (`1d`) oder ±18 % (`7d`) um `currentPrice`, aufgeteilt in 200 Bins.
leveragesarray—Hebelstufen, auf die das Modell die Positionen verteilt, aufsteigend (10, 25, 50, 100).
leverages[]numberxHebelfaktor einer Stufe; dient als Schlüssel innerhalb von `bins[].tiers`.
binsarray—Die 200 Preis-Bins der Karte in aufsteigender Preisreihenfolge; Modellschätzung, keine Börsendaten.
bins[]object—Ein Preis-Bin: mittlerer `price`, `side` (`long` unterhalb des aktuellen Preises, `short` auf oder über ihm), `tiers` je Hebel und deren `total`.
bins[].pricenumber—Letzter Preis in der Kurswährung (USD oder USDT, sofern nicht anders angegeben).
bins[].sidestring—`long` / `short` oder `buy` / `sell`.
bins[].tiersobject—Größenstufen.
bins[].tiers.10numberUSDModellierter Liquidations-Nominalwert in diesem Preis-Bin aus Positionen, die mit 10-fachem Hebel eröffnet wurden; der Schlüssel fehlt, wenn der Betrag 0 ist. kann fehlen
bins[].totalnumber—Gesamtzahl.
bins[].tiers.25numberUSDModellierter Liquidations-Nominalwert in diesem Preis-Bin aus Positionen, die mit 25-fachem Hebel eröffnet wurden; der Schlüssel fehlt, wenn der Betrag 0 ist. kann fehlen
cumarray—Kumulative Kurve, Index für Index an `bins` ausgerichtet.
cum[]numberUSDModellierter Liquidations-Nominalwert, kumuliert vom aktuellen Preis bis zu diesem Bin (abwärts für darunterliegende Bins, aufwärts für darüberliegende).
maxBinnumberUSDGrößter Wert von `bins[].total` in der Karte, verwendbar zur Skalierung der Chartachse.
totalLongnumber—Long gesamt.
totalShortnumber—Short gesamt.
actualLiq24hnumberUSDIn den letzten 24 Stunden für den Coin tatsächlich liquidierter Nominalwert (Long + Short, aufgezeichnete Liquidationsorders), zum Vergleich mit dem Modell.

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

Beispielantwort

/api/liq-map?symbol=BTC&range=1d · Echte Antwort, erfasst 2026-11-13 01:47:45 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: cum hatte 200 Elemente; bins hatte 200 Elemente.

  • {
    • "symbol": "BTC",
    • "range": "1d",
    • "updatedAt": 1794534390966,
    • "currentPrice": 70883.6,
    • "binWidth": 70.8836,
    • "leverages": [
      • 10,
      • 25,
      • 50,
      • 100
      ],
    • "bins": [
      • { … 4 },
      • { … 4 }
      ],
    • "cum": [
      • 219624903,
      • 219624903,
      • 219624903,
      • 219624903,
      • 219624903,
      • 215494082,
      • 215494082,
      • 208894197
      ],
    • "maxBin": 23159382,
    • "totalLong": 219624903,
    • "totalShort": 190818932,
    • "actualLiq24h": 352221772
    }

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
range=1d&symbol=ETH2001 msBestanden
range=1d&symbol=SOL2001 msBestanden

Geprüft 2026-11-13 01:28:03 UTC

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
60s
Edge-Micro-Cache
10s
Aktualisierungsintervall
alle 5 min für die Top 100 Coins; die Coins auf den Rängen 101-300 werden in 5 gestaffelten Batches aktualisiert (rund alle 25 min)
Zeitfenster
Parameter range: 1d | 7d (Annahme: Positionen wurden in den letzten 1 oder 7 Tagen eröffnet); letzter Modell-Snapshot
Datenquellen
Modellschätzung, intern aus den CoinBoss-eigenen stündlichen Futures-Klines (binance, okx als Fallback), der aggregierten Open-Interest-Historie und den erhobenen Liquidationen berechnet.
Börsenabdeckung
bis zu 300 Krypto-Coins, nach Futures-Nominalvolumen gerankt, mit >= 30 Liquidationsereignissen in den letzten 7 Tagen; tokenisierte Aktien, Rohstoffe, FX und Indizes sind ausgeschlossen; Schätzungen sind Modellausgabe, keine von Börsen gemeldeten Liquidationsniveaus
Einheiten
estimated liquidation notional in USD per price level; prices in USD; timestamps in Unix ms
Methode
each 1 h candle opens notional proportional to volume x close (boosted by OI increase), spread over leverage tiers; long liq price ~ P x (1 - 1/L + MMR), short ~ P x (1 + 1/L - MMR); levels swept by later candles are cleared; output = cumulative long/short liquidation notional by price and leverage tier
Zeitstempel
Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat
json
Stabilität
Stabil

Live-Status

VerfügbarGeprüft 2026-11-13 01:47:45 UTCHTTP 2001 msSchema stimmt übereinNeuester Datenpunkt 74s alt

Verfügbarkeit, letzte 30 Tage

100 % von 384 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/liq-mapVerfügbar
Parameter

string · Standard BTC — Coin symbol; 404 when no data.

string · Standard 1d — Time window.

Anfrage-URLhttps://www.coinboss.com/api/liq-map?symbol=BTC&range=1d
Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.