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

Liquidations-Heatmap (Modell 2 / 3)

Liquidations-Heatmap (Modell 2 / Modell 3)

GET/api/liq-heatmap

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
symbolstringOptionalBTC—Coin-Symbol; 404, wenn keine Daten vorliegen. Beispiel: BTC
rangestringOptional24h12h, 24h, 3d, 7d, 1MZeitfenster. Beispiel: 24h
modelstringOptional22, 3Modellnummer.

Beispielanfrage

curl -s "https://www.coinboss.com/api/liq-heatmap?symbol=BTC&range=24h"

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.
modelnumber—Verwendete Modellvariante: `2` (scharfe Niveaus, Einstiege zum Stundenschluss, stärkere Gewichtung des Open Interest) oder `3` (geglättet, Einstiege über die Spanne jeder Kerze verteilt).
updatedAtnumbermsZeitpunkt der letzten Aktualisierung der Daten.
currentPricenumber—Aktueller Preis.
pricesarray—Preisreihe.
prices[]number—Preisreihe.
timesarray—Zeitstempel der Reihe.
times[]number—Zeitstempel der Reihe.
gridarray—Rasterwerte.
grid[]array—Rasterwerte.
grid[][]number—Rasterwerte.
maxNotionalnumberUSDModellierter Liquidations-Nominalwert der dichtesten Zelle im gesamten Raster, also der Betrag, für den ein `grid`-Wert von 250 steht; Modellschätzung, keine Börsendaten.
clustersarray—Preiscluster.
clusters[]object—Preiscluster.
clusters[].pricenumber—Letzter Preis in der Kurswährung (USD oder USDT, sofern nicht anders angegeben).
clusters[].strengthnumberratioModellierter Nominalwert des Clusters ÷ `maxNotional`, zwischen 0.15 und 1; Cluster sind die bis zu 8 stärksten lokalen Spitzen der neuesten Spalte.
clusters[].usdnumberUSDWert.

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

Beispielantwort

/api/liq-heatmap?symbol=BTC&range=24h · Echte Antwort, erfasst 2026-11-13 03:58:04 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: grid hatte 24 Elemente; times hatte 24 Elemente; grid[] hatte 250 Elemente; prices hatte 250 Elemente; clusters hatte 8 Elemente.

  • {
    • "symbol": "BTC",
    • "range": "24h",
    • "model": 2,
    • "updatedAt": 1794542191150,
    • "currentPrice": 68700.4,
    • "prices": [
      • 65834.75,
      • 65878.66,
      • 65922.57,
      • 65966.48,
      • 66010.39,
      • 66054.3,
      • 66098.2,
      • 66142.11
      ],
    • "times": [
      • 1794456000000,
      • 1794459600000,
      • 1794463200000,
      • 1794466800000,
      • 1794470400000,
      • 1794474000000,
      • 1794477600000,
      • 1794481200000
      ],
    • "grid": [
      • [ … 8 ],
      • [ … 8 ]
      ],
    • "maxNotional": 575067181,
    • "clusters": [
      • { … 3 },
      • { … 3 }
      ]
    }

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=24h&symbol=ETH2001 msBestanden
range=24h&symbol=SOL2002 msBestanden

Geprüft 2026-11-13 03:58:04 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: 12h | 24h | 3d | 7d | 1M; Parameter model: 2 | 3; 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
time x price grid (250 price bins) of pending estimated liquidation notional; model 2 = OI-increment driven, leverage tiers 10/25/50/100, no decay; model 3 = entries spread across candle range, tiers 5/10/25/50/100, slow decay
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 03:58:04 UTCHTTP 2001 msSchema stimmt übereinNeuester Datenpunkt 2m 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/liq-heatmapVerfügbar
Parameter

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

string · Standard 24h — Time window.

string · Standard 2 — Model number.

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