24h Volumen—Open Interest—24h Liquidationen$1.36B24h Long/Short—BTC-Dominanz—ETH-Dominanz—
App
Sprache ▾
€ EUR ▾
/api/sd/liquidity/rank
GETTeilweisePARTIAL

Coin-Ranking nach Orderbuchtiefe

Coin-Ranking nach aggregierter Orderbuchtiefe (Bid + Ask) innerhalb eines Bands, mit der Anzahl der einbezogenen Kontrakte und dem engsten Spread.

GET/api/sd/liquidity/rank

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
marketstringOptionalperpperp, spotMarkttyp. Perpetual- und Spot-Orderbücher werden nie zusammengerechnet.
bandstringOptional10.5, 1, 2Abstand vom Mittelkurs in Prozent.
limitintegerOptional50≥ 1 · ≤ 200Anzahl der Zeilen.

Beispielanfrage

curl -s "https://www.coinboss.com/api/sd/liquidity/rank"

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 }`.
schemastring—Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert.
nownumbermsServerzeit beim Erstellen der Antwort.
marketstring—`perp` oder `spot`.
band_pctnumber%Ausgewähltes Band: Abstand vom Mittelkurs.
limitnumber—Angewendetes Zeilenlimit.
total_coinsnumber—Coins, die mindestens eine Orderbuch-Zeile haben.
rowsarray—Eine Zeile je Coin.
rows[]object—Eine Zeile je Coin.
rows[].coinstring—Coin-Symbol (Großbuchstaben).
rows[].bid_depth_usdnumberUSDRuhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist.
rows[].ask_depth_usdnumberUSDRuhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist.
rows[].total_depth_usdnumberUSDBid-Tiefe + Ask-Tiefe des Bands, nur als Ranking-Schlüssel verwendet.
rows[].n_includednumber—In die Tiefensumme einbezogene Zeilen: aktuell und für das Band vollständig. Zusammen mit dem Tiefenwert zu lesen.
rows[].n_freshnumber—Aktuelle Zeilen.
rows[].n_rowsnumber—Gefundene Zeilen, einschließlich veralteter.
rows[].mid_mediannumberUSDMedian des Mittelkurses der aktuellen Zeilen.
rows[].spread_bps_minnumberbpEngster Spread unter den aktuellen Zeilen.
rows[].included_exchangesarray—Quellen, deren aktuelle Daten einbezogen sind.
rows[].included_exchanges[]string—Quellen, deren aktuelle Daten einbezogen sind.
rows[].uses_aggregated_bucketsboolean—True, wenn eine einbezogene Zeile preisaggregierte Buckets verwendet hat, wodurch die Summe zu einer Untergrenze wird.
rows[].ranknumber—Position im Ranking; `null`, wenn die Zeile keinen Wert für das Ranking hat.
coverageobject—Was in den Zahlen enthalten ist und was nicht. Vergleichen Sie dies, bevor Sie Summen mit einer anderen Quelle vergleichen.
coverage.included_exchangesarray—Quellen, deren aktuelle Daten einbezogen sind.
coverage.included_exchanges[]string—Quellen, deren aktuelle Daten einbezogen sind.
coverage.unavailablearray—Quellen, die nicht einbezogen werden konnten, jeweils mit Begründung. Sie werden nie als 0 gezählt. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde
coverage.stale_excludedarray—Zeilen, die unberücksichtigt bleiben, weil ihre letzte Aktualisierung außerhalb des Aktualitätsfensters liegt.
coverage.stale_excluded[]object—Zeilen, die unberücksichtigt bleiben, weil ihre letzte Aktualisierung außerhalb des Aktualitätsfensters liegt.
coverage.stale_excluded[].exchangestring—Börsenkennung (Kleinbuchstaben).
coverage.stale_excluded[].age_snumbersSekunden seit dem Empfang der Zeile.
coverage.n_fresh_rowsnumber—Aktuelle Zeilen über alle Coins.
coverage.n_stale_rowsnumber—Veraltete Zeilen über alle Coins.
coverage.n_incomplete_rowsnumber—Aktuelle Zeilen, deren Snapshot die Bandgrenze nicht erreicht.
methodobject—Klartextangabe der für diese Antwort verwendeten Formeln, ein Eintrag je Feld.
method.bid_depth_usdstring—Formelhinweis zu `bid_depth_usd`, Klartext.
method.ask_depth_usdstring—Formelhinweis zu `ask_depth_usd`, Klartext.
method.completestring—Formelhinweis zu `complete`, Klartext.
method.aggregatestring—Formelhinweis zu `aggregate`, Klartext.
method.freshstring—Formelhinweis zu `fresh`, Klartext.
method.rankstring—Formelhinweis zu `rank`, Klartext.
metaobject—Datenherkunft und Aktualität dieser Antwort.
meta.schemastring—Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert.
meta.sourcearray—Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden.
meta.source[]object—Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden.
meta.source[].exchangestring—Börsenkennung (Kleinbuchstaben).
meta.source[].marketstring—`perp` oder `spot`.
meta.source[].endpointstring—Öffentlicher Endpunkt der Quelle, den der Collector liest (zur Datenherkunft angegeben; Clients rufen ihn nie auf).
meta.observed_atnumbermsVon der Quelle für die Daten angegebener Zeitstempel.
meta.received_atnumbermsZeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat.
meta.fetched_atnumbermsZeitpunkt, zu dem diese Antwort zusammengestellt wurde.
meta.windowstring—Zeitfenster, das die Zahlen abdecken.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN oder UNAVAILABLE, beurteilt anhand der Datenzeitstempel und der Abdeckung.
meta.is_staleboolean—True, wenn die Daten älter als ihr Aktualitätsfenster sind.
meta.cache_ttl_snumbersCache-Lebensdauer dieser Antwort.
meta.fallbackstring—Was der Endpunkt zurückgibt, wenn der Collector oder eine Quelle ausfällt.
meta.collector_heartbeat_age_snumbersSekunden, seit der Collector zuletzt gemeldet hat, dass er läuft.

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

Beispielantwort

/api/sd/liquidity/rank · Echte Antwort, erfasst 2026-11-13 04:02:46 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: rows hatte 50 Elemente; meta.source hatte 23 Elemente; coverage.stale_excluded hatte 23 Elemente; rows[].included_exchanges hatte 19 Elemente; coverage.included_exchanges hatte 23 Elemente.

  • {
    • "success": true,
    • "schema": "coinboss.sd.liquidity/1",
    • "now": 1794542566023,
    • "market": "perp",
    • "band_pct": 1,
    • "limit": 50,
    • "total_coins": 89,
    • "rows": [
      • { … 12 },
      • { … 12 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "unavailable": [],
      • "stale_excluded": [ … 2 ],
      • "n_fresh_rows": 1481,
      • "n_stale_rows": 82,
      • "n_incomplete_rows": 8
      },
    • "method": {
      • "bid_depth_usd": "sum of resting bid notional with price >= mid * (1 - band%), in USD; notional = price * size * contract_value (inverse contracts: size * contract_value); USDT /…",
      • "ask_depth_usd": "sum of resting ask notional with price <= mid * (1 + band%), in USD; same notional rule as bid_depth_usd",
      • "complete": "true when BOTH sides of the snapshot reach the band edge (reach_pct >= band) or the whole side of the book was returned; when false the depth values are lower b…",
      • "aggregate": "per market and band: sum over rows that are fresh AND complete for that band; n_included / n_fresh is the denominator; lower_bound_* additionally adds the incom…",
      • "fresh": "a row is fresh when now - received_at <= max(3 * period_s, 300s); stale rows are listed in coverage.stale_excluded; rows older than 24h are dropped",
      • "rank": "coins ordered by bid_depth_usd + ask_depth_usd of the chosen market and band, aggregated as in aggregate; coins with no fresh complete row carry nulls and sort …"
      },
    • "meta": {
      • "schema": "coinboss.sd.liquidity/1",
      • "source": [ … 2 ],
      • "observed_at": 1794542565862,
      • "received_at": 1794542565977,
      • "fetched_at": 1794542566023,
      • "window": "latest",
      • "quality": "PARTIAL",
      • "is_stale": false,
      • "cache_ttl_s": 30,
      • "fallback": "stale rows (older than max(3 * period_s, 300s)) are left out; coins whose rows are all stale or incomplete keep their place in the list with null depth",
      • "collector_heartbeat_age_s": 4
      }
    }

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
market=spot2005 msBestanden PARTIAL
band=0.5&limit=102007 msBestanden PARTIAL
limit=04002 msBestanden liefert den erwarteten Fehler

Geprüft 2026-11-13 03:58:06 UTC

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
30s
Edge-Micro-Cache
10s
Aktualisierungsintervall
Derselbe Erhebungszyklus wie bei `/api/sd/liquidity`.
Zeitfenster
Letzter Snapshot je Kontrakt.
Datenquellen
Öffentliche REST-Orderbuch-Snapshots von 24 Börsen (Perpetual- und Spot-Märkte), von CoinBoss erhoben und gespeichert (sd_book_latest, sd_book_hist). Tiefe und Slippage berechnet CoinBoss aus den rohen Preisniveaus.
Börsenabdeckung
24 Börsen, 38 Kombinationen aus Börse × Markt. Wo ein öffentlicher Snapshot nicht ±0.5 / 1 / 2 % um den Mittelkurs erreicht (Level-Obergrenze der Börse), wird dieses Band mit `complete: false` markiert, sein Wert ist eine Untergrenze und es bleibt im Aggregat unberücksichtigt; `n_included` / `n_fresh` liefern den Nenner, und `excluded_incomplete` führt auf, was ausgelassen wurde.
Paginierung
Keine Paginierung; `limit` begrenzt die Anzahl der Zeilen (max. 200).
Sortierung
`total_depth_usd` absteigend; Coins ohne eine vollständige, aktuelle Zeile stehen am Ende mit `rank: null`.
Einheiten
Depth in USD notional, bid and ask side reported separately and never added. Spread and slippage in basis points (1 bp = 0.01 %). USDT / USDC / USD quotes are counted 1:1 as USD.
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

TeilweiseGeprüft 2026-11-13 04:02:46 UTCHTTP 2009 msSchema stimmt übereinNeuester Datenpunkt 0s alt

Der Endpunkt meldet die Datenqualität PARTIAL

Verfügbarkeit, letzte 30 Tage

100 % von 408 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/liquidity/rankTeilweise
Parameter

string · Standard perp — Market type. Perpetual and spot books are never added together.

string · Standard 1 — Distance from mid price in percent.

integer · Standard 50 · min. 1 · max. 200 — Number of rows.

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