GETTeilweisePARTIAL
Orderbuchtiefe und Slippage
Orderbuchtiefe je Börse innerhalb von ±0.5 / 1 / 2 % um den Mittelkurs, Spread und Slippage einer Market-Order über 10k / 100k / 1M USD, dazu ein Aggregat je Markttyp mit Angabe seines Nenners.
GET
/api/sd/liquidityTeilweise Abdeckung. Bei den liquidesten Coins reichen die öffentlichen Snapshots mehrerer großer Börsen nicht über das gesamte Band, daher werden diese Börsen aus dem Aggregat ausgeschlossen und das Aggregat weist die Gesamttiefe zu niedrig aus. Die Felder `lower_bound_*` ergänzen den beobachteten Teil. Lesen Sie `n_included` immer zusammen mit dem Tiefenwert.
Anfrage
Query-Parameter
| Name | Typ | Erforderlich | Standard | Zulässige Werte | Beschreibung |
|---|---|---|---|---|---|
| coin | string | Erforderlich | — | — | Coin-Symbol, Groß-/Kleinschreibung wird nicht beachtet (zum Beispiel `BTC`). Fehlende oder fehlerhafte Werte liefern 400. Beispiel: BTC |
| market | string | Optional | all | perp, spot, all | Markttyp. Perpetual- und Spot-Orderbücher werden nie zusammengerechnet. |
Beispielanfrage
curl -s "https://www.coinboss.com/api/sd/liquidity?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.
| Feld | Typ | Einheit | Beschreibung |
|---|---|---|---|
| success | boolean | — | true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`. |
| schema | string | — | Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert. |
| now | number | ms | Serverzeit beim Erstellen der Antwort. |
| coin | string | — | Coin-Symbol (Großbuchstaben). |
| market | string | — | `perp` oder `spot`. |
| venues | array | — | Eine Zeile je Börse × Markt × Kontrakt. |
| venues[] | object | — | Eine Zeile je Börse × Markt × Kontrakt. |
| venues[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| venues[].market | string | — | `perp` oder `spot`. |
| venues[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| venues[].quote | string | — | Kurswährung des Markts; USDT, USDC und USD werden 1:1 als USD gezählt. |
| venues[].multiplier | number | — | Coins je notierter Einheit (1000 bei Kontrakten nach dem Muster `1000PEPE`). Die Preise sind bereits durch diesen Wert geteilt. |
| venues[].contract_value | number | — | Größe eines Kontrakts: Coins bei linearen Kontrakten, USD bei inversen Kontrakten. |
| venues[].inverse | boolean | — | True bei coin-marginierten Kontrakten, die in USD je Kontrakt notiert sind. |
| venues[].mid | number | USD | (bester Bid + bester Ask) ÷ 2, Preis eines Coins. |
| venues[].best_bid | number | USD | Bester Bid-Preis für einen Coin. |
| venues[].best_ask | number | USD | Bester Ask-Preis für einen Coin. |
| venues[].spread_bps | number | bp | (bester Ask − bester Bid) ÷ Mittelkurs. |
| venues[].n_bids | number | — | Bid-Preisniveaus im Snapshot. |
| venues[].n_asks | number | — | Ask-Preisniveaus im Snapshot. |
| venues[].reach_bid_pct | number | % | Abstand vom Mittelkurs zum entferntesten Bid-Niveau im Snapshot. |
| venues[].reach_ask_pct | number | % | Abstand vom Mittelkurs zum entferntesten Ask-Niveau im Snapshot. |
| venues[].book_complete_bid | boolean | — | True, wenn die gesamte Bid-Seite des Orderbuchs zurückgegeben wurde. |
| venues[].book_complete_ask | boolean | — | True, wenn die gesamte Ask-Seite des Orderbuchs zurückgegeben wurde. |
| venues[].bands | object | — | Tiefe je Band; die Schlüssel `0.5`, `1` und `2` sind der Abstand vom Mittelkurs in Prozent. |
| venues[].bands.1 | object | — | Band mit diesem Abstand vom Mittelkurs, in Prozent. |
| venues[].bands.1.bid_depth_usd | number | USD | Ruhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. |
| venues[].bands.1.ask_depth_usd | number | USD | Ruhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. |
| venues[].bands.1.complete | boolean | — | True, wenn beide Seiten des Snapshots die Bandgrenze erreichen. Unvollständige Zeilen bleiben in Aggregaten unberücksichtigt. |
| venues[].bands.2 | object | — | Band mit diesem Abstand vom Mittelkurs, in Prozent. |
| venues[].bands.2.bid_depth_usd | number | USD | Ruhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. |
| venues[].bands.2.ask_depth_usd | number | USD | Ruhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. |
| venues[].bands.2.complete | boolean | — | True, wenn beide Seiten des Snapshots die Bandgrenze erreichen. Unvollständige Zeilen bleiben in Aggregaten unberücksichtigt. |
| venues[].bands.0.5 | object | — | Band mit diesem Abstand vom Mittelkurs, in Prozent. |
| venues[].bands.0.5.bid_depth_usd | number | USD | Ruhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. |
| venues[].bands.0.5.ask_depth_usd | number | USD | Ruhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. |
| venues[].bands.0.5.complete | boolean | — | True, wenn beide Seiten des Snapshots die Bandgrenze erreichen. Unvollständige Zeilen bleiben in Aggregaten unberücksichtigt. |
| venues[].slippage | object | — | Slippage einer Market-Order; die Schlüssel `10000`, `100000` und `1000000` geben die Ordergröße in USD an. |
| venues[].slippage.10000 | object | — | Market-Order dieser Größe in USD. |
| venues[].slippage.10000.buy_bps | number | bp | Durchschnittlicher Ausführungspreis eines Market-Kaufs relativ zum Mittelkurs (enthält den halben Spread); `null`, wenn der Snapshot die Order nicht ausführen kann. |
| venues[].slippage.10000.sell_bps | number|null | bp | Durchschnittlicher Ausführungspreis eines Market-Verkaufs relativ zum Mittelkurs (enthält den halben Spread); `null`, wenn der Snapshot die Order nicht ausführen kann. |
| venues[].slippage.10000.buy_flag | null | — | `insufficient_book`, wenn die Order aus dem Snapshot nicht ausgeführt werden kann, `upper_bound`, wenn ein aggregierter Bucket verwendet wurde, andernfalls `null`. |
| venues[].slippage.10000.sell_flag | string|null | — | `insufficient_book`, wenn die Order aus dem Snapshot nicht ausgeführt werden kann, `upper_bound`, wenn ein aggregierter Bucket verwendet wurde, andernfalls `null`. |
| venues[].slippage.100000 | object | — | Market-Order dieser Größe in USD. |
| venues[].slippage.100000.buy_bps | number|null | bp | Durchschnittlicher Ausführungspreis eines Market-Kaufs relativ zum Mittelkurs (enthält den halben Spread); `null`, wenn der Snapshot die Order nicht ausführen kann. |
| venues[].slippage.100000.sell_bps | number|null | bp | Durchschnittlicher Ausführungspreis eines Market-Verkaufs relativ zum Mittelkurs (enthält den halben Spread); `null`, wenn der Snapshot die Order nicht ausführen kann. |
| venues[].slippage.100000.buy_flag | string|null | — | `insufficient_book`, wenn die Order aus dem Snapshot nicht ausgeführt werden kann, `upper_bound`, wenn ein aggregierter Bucket verwendet wurde, andernfalls `null`. |
| venues[].slippage.100000.sell_flag | string|null | — | `insufficient_book`, wenn die Order aus dem Snapshot nicht ausgeführt werden kann, `upper_bound`, wenn ein aggregierter Bucket verwendet wurde, andernfalls `null`. |
| venues[].slippage.1000000 | object | — | Market-Order dieser Größe in USD. |
| venues[].slippage.1000000.buy_bps | number|null | bp | Durchschnittlicher Ausführungspreis eines Market-Kaufs relativ zum Mittelkurs (enthält den halben Spread); `null`, wenn der Snapshot die Order nicht ausführen kann. |
| venues[].slippage.1000000.sell_bps | number|null | bp | Durchschnittlicher Ausführungspreis eines Market-Verkaufs relativ zum Mittelkurs (enthält den halben Spread); `null`, wenn der Snapshot die Order nicht ausführen kann. |
| venues[].slippage.1000000.buy_flag | string|null | — | `insufficient_book`, wenn die Order aus dem Snapshot nicht ausgeführt werden kann, `upper_bound`, wenn ein aggregierter Bucket verwendet wurde, andernfalls `null`. |
| venues[].slippage.1000000.sell_flag | string|null | — | `insufficient_book`, wenn die Order aus dem Snapshot nicht ausgeführt werden kann, `upper_bound`, wenn ein aggregierter Bucket verwendet wurde, andernfalls `null`. |
| venues[].book_bid_usd | number | USD | Nominalwert aller im Snapshot enthaltenen Bids. |
| venues[].book_ask_usd | number | USD | Nominalwert aller im Snapshot enthaltenen Asks. |
| venues[].agg_step_bps | number|null | bp | Breitester Preisaggregations-Bucket, der innerhalb von ±2 % verwendet wurde; `null`, wenn nur Rohniveaus verwendet wurden. |
| venues[].layers | number | — | Anzahl der Snapshots, die für diese Zeile zusammengefügt wurden. |
| venues[].observed_at | number|null | ms | Von der Quelle für die Daten angegebener Zeitstempel. |
| venues[].received_at | number | ms | Zeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat. |
| venues[].lag_ms | number|null | ms | Empfangszeit minus Orderbuch-Zeitstempel des Handelsplatzes; `null`, wenn der Handelsplatz keinen liefert. |
| venues[].age_s | number | s | Sekunden seit dem Empfang der Zeile. |
| venues[].fresh_window_s | number | s | Eine Zeile, die älter ist als dieser Wert, gilt als veraltet. |
| venues[].is_stale | boolean | — | True, wenn die Daten älter als ihr Aktualitätsfenster sind. |
| venues[].tier | string | — | Erhebungsstufe: `A` für die meistgehandelten Coins, `B` für die übrigen. |
| venues[].period_s | number | s | Erhebungsperiode der Zeile. |
| aggregate | object | — | Summen je Markttyp. Perpetual und Spot werden nie zusammengerechnet. |
| aggregate.perp | object | — | Aggregat über Perpetual-Orderbücher; `null`, wenn keine Zeile vorhanden ist. kann fehlen |
| aggregate.perp.n_rows | number | — | Gefundene Zeilen, einschließlich veralteter. kann fehlen |
| aggregate.perp.n_fresh | number | — | Aktuelle Zeilen. kann fehlen |
| aggregate.perp.mid_median | number | USD | Median des Mittelkurses der aktuellen Zeilen. kann fehlen |
| aggregate.perp.spread_bps_min | number | bp | Engster Spread unter den aktuellen Zeilen. kann fehlen |
| aggregate.perp.bands | object | — | Tiefe je Band; die Schlüssel `0.5`, `1` und `2` sind der Abstand vom Mittelkurs in Prozent. kann fehlen |
| aggregate.perp.bands.1 | object | — | Band mit diesem Abstand vom Mittelkurs, in Prozent. kann fehlen |
| aggregate.perp.bands.1.bid_depth_usd | number | USD | Ruhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.perp.bands.1.ask_depth_usd | number | USD | Ruhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.perp.bands.1.n_included | number | — | In die Tiefensumme einbezogene Zeilen: aktuell und für das Band vollständig. Zusammen mit dem Tiefenwert zu lesen. kann fehlen |
| aggregate.perp.bands.1.n_fresh | number | — | Aktuelle Zeilen. kann fehlen |
| aggregate.perp.bands.1.included_exchanges | array | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.perp.bands.1.included_exchanges[] | string | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.perp.bands.1.excluded_incomplete | array | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.perp.bands.1.excluded_incomplete[] | object | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.perp.bands.1.excluded_incomplete[].exchange | string | — | Börsenkennung (Kleinbuchstaben). kann fehlen |
| aggregate.perp.bands.1.excluded_incomplete[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. kann fehlen |
| aggregate.perp.bands.1.excluded_incomplete[].reach_bid_pct | number | % | Abstand vom Mittelkurs zum entferntesten Bid-Niveau im Snapshot. kann fehlen |
| aggregate.perp.bands.1.excluded_incomplete[].reach_ask_pct | number | % | Abstand vom Mittelkurs zum entferntesten Ask-Niveau im Snapshot. kann fehlen |
| aggregate.perp.bands.1.lower_bound_bid_usd | number | USD | Bid-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.perp.bands.1.lower_bound_ask_usd | number | USD | Ask-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.perp.bands.1.uses_aggregated_buckets | boolean | — | True, wenn eine einbezogene Zeile preisaggregierte Buckets verwendet hat, wodurch die Summe zu einer Untergrenze wird. kann fehlen |
| aggregate.perp.bands.2 | object | — | Band mit diesem Abstand vom Mittelkurs, in Prozent. kann fehlen |
| aggregate.perp.bands.2.bid_depth_usd | number | USD | Ruhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.perp.bands.2.ask_depth_usd | number | USD | Ruhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.perp.bands.2.n_included | number | — | In die Tiefensumme einbezogene Zeilen: aktuell und für das Band vollständig. Zusammen mit dem Tiefenwert zu lesen. kann fehlen |
| aggregate.perp.bands.2.n_fresh | number | — | Aktuelle Zeilen. kann fehlen |
| aggregate.perp.bands.2.included_exchanges | array | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.perp.bands.2.included_exchanges[] | string | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.perp.bands.2.excluded_incomplete | array | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.perp.bands.2.excluded_incomplete[] | object | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.perp.bands.2.excluded_incomplete[].exchange | string | — | Börsenkennung (Kleinbuchstaben). kann fehlen |
| aggregate.perp.bands.2.excluded_incomplete[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. kann fehlen |
| aggregate.perp.bands.2.excluded_incomplete[].reach_bid_pct | number | % | Abstand vom Mittelkurs zum entferntesten Bid-Niveau im Snapshot. kann fehlen |
| aggregate.perp.bands.2.excluded_incomplete[].reach_ask_pct | number | % | Abstand vom Mittelkurs zum entferntesten Ask-Niveau im Snapshot. kann fehlen |
| aggregate.perp.bands.2.lower_bound_bid_usd | number | USD | Bid-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.perp.bands.2.lower_bound_ask_usd | number | USD | Ask-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.perp.bands.2.uses_aggregated_buckets | boolean | — | True, wenn eine einbezogene Zeile preisaggregierte Buckets verwendet hat, wodurch die Summe zu einer Untergrenze wird. kann fehlen |
| aggregate.perp.bands.0.5 | object | — | Band mit diesem Abstand vom Mittelkurs, in Prozent. kann fehlen |
| aggregate.perp.bands.0.5.bid_depth_usd | number | USD | Ruhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.perp.bands.0.5.ask_depth_usd | number | USD | Ruhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.perp.bands.0.5.n_included | number | — | In die Tiefensumme einbezogene Zeilen: aktuell und für das Band vollständig. Zusammen mit dem Tiefenwert zu lesen. kann fehlen |
| aggregate.perp.bands.0.5.n_fresh | number | — | Aktuelle Zeilen. kann fehlen |
| aggregate.perp.bands.0.5.included_exchanges | array | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.perp.bands.0.5.included_exchanges[] | string | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.perp.bands.0.5.excluded_incomplete | array | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.perp.bands.0.5.excluded_incomplete[] | object | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.perp.bands.0.5.excluded_incomplete[].exchange | string | — | Börsenkennung (Kleinbuchstaben). kann fehlen |
| aggregate.perp.bands.0.5.excluded_incomplete[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. kann fehlen |
| aggregate.perp.bands.0.5.excluded_incomplete[].reach_bid_pct | number | % | Abstand vom Mittelkurs zum entferntesten Bid-Niveau im Snapshot. kann fehlen |
| aggregate.perp.bands.0.5.excluded_incomplete[].reach_ask_pct | number | % | Abstand vom Mittelkurs zum entferntesten Ask-Niveau im Snapshot. kann fehlen |
| aggregate.perp.bands.0.5.lower_bound_bid_usd | number | USD | Bid-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.perp.bands.0.5.lower_bound_ask_usd | number | USD | Ask-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.perp.bands.0.5.uses_aggregated_buckets | boolean | — | True, wenn eine einbezogene Zeile preisaggregierte Buckets verwendet hat, wodurch die Summe zu einer Untergrenze wird. kann fehlen |
| aggregate.spot | object | — | Aggregat über Spot-Orderbücher; `null`, wenn keine Zeile vorhanden ist. kann fehlen |
| aggregate.spot.n_rows | number | — | Gefundene Zeilen, einschließlich veralteter. kann fehlen |
| aggregate.spot.n_fresh | number | — | Aktuelle Zeilen. kann fehlen |
| aggregate.spot.mid_median | number | USD | Median des Mittelkurses der aktuellen Zeilen. kann fehlen |
| aggregate.spot.spread_bps_min | number | bp | Engster Spread unter den aktuellen Zeilen. kann fehlen |
| aggregate.spot.bands | object | — | Tiefe je Band; die Schlüssel `0.5`, `1` und `2` sind der Abstand vom Mittelkurs in Prozent. kann fehlen |
| aggregate.spot.bands.1 | object | — | Band mit diesem Abstand vom Mittelkurs, in Prozent. kann fehlen |
| aggregate.spot.bands.1.bid_depth_usd | number | USD | Ruhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.spot.bands.1.ask_depth_usd | number | USD | Ruhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.spot.bands.1.n_included | number | — | In die Tiefensumme einbezogene Zeilen: aktuell und für das Band vollständig. Zusammen mit dem Tiefenwert zu lesen. kann fehlen |
| aggregate.spot.bands.1.n_fresh | number | — | Aktuelle Zeilen. kann fehlen |
| aggregate.spot.bands.1.included_exchanges | array | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.spot.bands.1.included_exchanges[] | string | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.spot.bands.1.excluded_incomplete | array | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.spot.bands.1.excluded_incomplete[] | object | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.spot.bands.1.excluded_incomplete[].exchange | string | — | Börsenkennung (Kleinbuchstaben). kann fehlen |
| aggregate.spot.bands.1.excluded_incomplete[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. kann fehlen |
| aggregate.spot.bands.1.excluded_incomplete[].reach_bid_pct | number | % | Abstand vom Mittelkurs zum entferntesten Bid-Niveau im Snapshot. kann fehlen |
| aggregate.spot.bands.1.excluded_incomplete[].reach_ask_pct | number | % | Abstand vom Mittelkurs zum entferntesten Ask-Niveau im Snapshot. kann fehlen |
| aggregate.spot.bands.1.lower_bound_bid_usd | number | USD | Bid-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.spot.bands.1.lower_bound_ask_usd | number | USD | Ask-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.spot.bands.1.uses_aggregated_buckets | boolean | — | True, wenn eine einbezogene Zeile preisaggregierte Buckets verwendet hat, wodurch die Summe zu einer Untergrenze wird. kann fehlen |
| aggregate.spot.bands.2 | object | — | Band mit diesem Abstand vom Mittelkurs, in Prozent. kann fehlen |
| aggregate.spot.bands.2.bid_depth_usd | number | USD | Ruhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.spot.bands.2.ask_depth_usd | number | USD | Ruhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.spot.bands.2.n_included | number | — | In die Tiefensumme einbezogene Zeilen: aktuell und für das Band vollständig. Zusammen mit dem Tiefenwert zu lesen. kann fehlen |
| aggregate.spot.bands.2.n_fresh | number | — | Aktuelle Zeilen. kann fehlen |
| aggregate.spot.bands.2.included_exchanges | array | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.spot.bands.2.included_exchanges[] | string | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.spot.bands.2.excluded_incomplete | array | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.spot.bands.2.excluded_incomplete[] | object | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.spot.bands.2.excluded_incomplete[].exchange | string | — | Börsenkennung (Kleinbuchstaben). kann fehlen |
| aggregate.spot.bands.2.excluded_incomplete[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. kann fehlen |
| aggregate.spot.bands.2.excluded_incomplete[].reach_bid_pct | number | % | Abstand vom Mittelkurs zum entferntesten Bid-Niveau im Snapshot. kann fehlen |
| aggregate.spot.bands.2.excluded_incomplete[].reach_ask_pct | number | % | Abstand vom Mittelkurs zum entferntesten Ask-Niveau im Snapshot. kann fehlen |
| aggregate.spot.bands.2.lower_bound_bid_usd | number | USD | Bid-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.spot.bands.2.lower_bound_ask_usd | number | USD | Ask-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.spot.bands.2.uses_aggregated_buckets | boolean | — | True, wenn eine einbezogene Zeile preisaggregierte Buckets verwendet hat, wodurch die Summe zu einer Untergrenze wird. kann fehlen |
| aggregate.spot.bands.0.5 | object | — | Band mit diesem Abstand vom Mittelkurs, in Prozent. kann fehlen |
| aggregate.spot.bands.0.5.bid_depth_usd | number | USD | Ruhender Bid-Nominalwert zwischen Mittelkurs und unterer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.spot.bands.0.5.ask_depth_usd | number | USD | Ruhender Ask-Nominalwert zwischen Mittelkurs und oberer Bandgrenze. Eine Untergrenze, wenn `complete` false ist. kann fehlen |
| aggregate.spot.bands.0.5.n_included | number | — | In die Tiefensumme einbezogene Zeilen: aktuell und für das Band vollständig. Zusammen mit dem Tiefenwert zu lesen. kann fehlen |
| aggregate.spot.bands.0.5.n_fresh | number | — | Aktuelle Zeilen. kann fehlen |
| aggregate.spot.bands.0.5.included_exchanges | array | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.spot.bands.0.5.included_exchanges[] | string | — | Quellen, deren aktuelle Daten einbezogen sind. kann fehlen |
| aggregate.spot.bands.0.5.excluded_incomplete | array | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.spot.bands.0.5.excluded_incomplete[] | object | — | Aktuelle Zeilen, die im Band unberücksichtigt bleiben, weil ihr Snapshot die Bandgrenze nicht erreicht. kann fehlen |
| aggregate.spot.bands.0.5.excluded_incomplete[].exchange | string | — | Börsenkennung (Kleinbuchstaben). kann fehlen |
| aggregate.spot.bands.0.5.excluded_incomplete[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. kann fehlen |
| aggregate.spot.bands.0.5.excluded_incomplete[].reach_bid_pct | number | % | Abstand vom Mittelkurs zum entferntesten Bid-Niveau im Snapshot. kann fehlen |
| aggregate.spot.bands.0.5.excluded_incomplete[].reach_ask_pct | number | % | Abstand vom Mittelkurs zum entferntesten Ask-Niveau im Snapshot. kann fehlen |
| aggregate.spot.bands.0.5.lower_bound_bid_usd | number | USD | Bid-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.spot.bands.0.5.lower_bound_ask_usd | number | USD | Ask-Tiefe einschließlich des beobachteten Teils unvollständiger Zeilen. Ein Mindestwert, keine Schätzung. kann fehlen |
| aggregate.spot.bands.0.5.uses_aggregated_buckets | boolean | — | True, wenn eine einbezogene Zeile preisaggregierte Buckets verwendet hat, wodurch die Summe zu einer Untergrenze wird. kann fehlen |
| coverage | object | — | Was in den Zahlen enthalten ist und was nicht. Vergleichen Sie dies, bevor Sie Summen mit einer anderen Quelle vergleichen. |
| coverage.included_exchanges | array | — | Quellen, deren aktuelle Daten einbezogen sind. |
| coverage.included_exchanges[] | string | — | Quellen, deren aktuelle Daten einbezogen sind. |
| coverage.unavailable | array | — | 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_excluded | array | — | Zeilen, die unberücksichtigt bleiben, weil ihre letzte Aktualisierung außerhalb des Aktualitätsfensters liegt. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde |
| coverage.no_market | array | — | Paare aus Börse × Markt, die erhoben werden, aber keine Zeile für diesen Coin enthalten. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde |
| method | object | — | Klartextangabe der für diese Antwort verwendeten Formeln, ein Eintrag je Feld. |
| method.mid | string | — | Formelhinweis zu `mid`, Klartext. |
| method.spread_bps | string | — | Formelhinweis zu `spread_bps`, Klartext. |
| method.bid_depth_usd | string | — | Formelhinweis zu `bid_depth_usd`, Klartext. |
| method.ask_depth_usd | string | — | Formelhinweis zu `ask_depth_usd`, Klartext. |
| method.complete | string | — | Formelhinweis zu `complete`, Klartext. |
| method.reach_pct | string | — | Formelhinweis zu `reach_pct`, Klartext. |
| method.slippage_bps | string | — | Formelhinweis zu `slippage_bps`, Klartext. |
| method.agg_step_bps | string | — | Formelhinweis zu `agg_step_bps`, Klartext. |
| method.aggregate | string | — | Formelhinweis zu `aggregate`, Klartext. |
| method.fresh | string | — | Formelhinweis zu `fresh`, Klartext. |
| method.lag_ms | string | — | Formelhinweis zu `lag_ms`, Klartext. |
| method.no_market | string | — | Formelhinweis zu `no_market`, Klartext. |
| meta | object | — | Datenherkunft und Aktualität dieser Antwort. |
| meta.schema | string | — | Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert. |
| meta.source | array | — | Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden. |
| meta.source[] | object | — | Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden. |
| meta.source[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| meta.source[].market | string | — | `perp` oder `spot`. |
| meta.source[].endpoint | string | — | Öffentlicher Endpunkt der Quelle, den der Collector liest (zur Datenherkunft angegeben; Clients rufen ihn nie auf). |
| meta.observed_at | number | ms | Von der Quelle für die Daten angegebener Zeitstempel. |
| meta.received_at | number | ms | Zeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat. |
| meta.fetched_at | number | ms | Zeitpunkt, zu dem diese Antwort zusammengestellt wurde. |
| meta.window | string | — | Zeitfenster, das die Zahlen abdecken. |
| meta.quality | string | — | FRESH, PARTIAL, STALE, BROKEN oder UNAVAILABLE, beurteilt anhand der Datenzeitstempel und der Abdeckung. |
| meta.is_stale | boolean | — | True, wenn die Daten älter als ihr Aktualitätsfenster sind. |
| meta.cache_ttl_s | number | s | Cache-Lebensdauer dieser Antwort. |
| meta.fallback | string | — | Was der Endpunkt zurückgibt, wenn der Collector oder eine Quelle ausfällt. |
| meta.collector_heartbeat_age_s | number | s | Sekunden, seit der Collector zuletzt gemeldet hat, dass er läuft. |
Erzeugt 2026-11-11 23:28 UTC aus 4 echten Antworten.
Beispielantwort
/api/sd/liquidity?coin=BTC · Echte Antwort, erfasst 2026-11-13 03:58:06 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: venues hatte 39 Elemente; meta.source hatte 38 Elemente; coverage.included_exchanges hatte 24 Elemente; aggregate.perp.bands.1.included_exchanges hatte 19 Elemente; aggregate.perp.bands.2.included_exchanges hatte 16 Elemente; aggregate.spot.bands.1.included_exchanges hatte 14 Elemente.
- "success"true
- "schema""coinboss.sd.liquidity/1"
- "now"1794542286066
- "coin""BTC"
- "market""all"
- "venues"
- "aggregate"
- "perp"
- "spot"
- "coverage"
- "included_exchanges"
- "unavailable"
- "stale_excluded"
- "no_market"
- "method"
- "mid""(best_bid + best_ask) / 2 of the venue order book, normalised to the USD price of ONE coin (1000PEPE / kPEPE style contr…"
- "spread_bps""(best_ask - best_bid) / mid * 1e4"
- "bid_depth_usd""sum of resting bid notional with price >= mid * (1 - band%), in USD; notional = price * size * contract_value (inverse c…"
- "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;…"
- "reach_pct""distance in % between mid and the farthest price level contained in the snapshot on that side"
- "slippage_bps""market order of N USD walked through the book: buy = (avg_fill / mid - 1) * 1e4, sell = (1 - avg_fill / mid) * 1e4, meas…"
- "agg_step_bps""widest price-aggregation bucket (in bps of mid) used inside +-2% for venues whose REST only exposes a shallow raw book (…"
- "aggregate""per market and band: sum over rows that are fresh AND complete for that band; n_included / n_fresh is the denominator; l…"
- "fresh""a row is fresh when now - received_at <= max(3 * period_s, 300s); stale rows are listed in coverage.stale_excluded; rows…"
- "lag_ms""received_at - venue timestamp of the book (null when the venue gives none); Gate spot books deeper than 100 levels are v…"
- "no_market""covered venue/market pairs that are being collected but hold no row for this coin: not listed there, or the contract was…"
- "meta"
- "schema""coinboss.sd.liquidity/1"
- "source"
- "observed_at"1794542285214
- "received_at"1794542285776
- "fetched_at"1794542286066
- "window""latest"
- "quality""PARTIAL"
- "is_stale"false
- "cache_ttl_s"15
- "fallback""on collector failure the last stored row is served with is_stale=true and left out of the aggregate; rows older than 24h…"
- "collector_heartbeat_age_s"9
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.
| Parameter | HTTP | Latenz | Ergebnis |
|---|---|---|---|
| coin=ETH&market=spot | 200 | 3 ms | Bestanden PARTIAL |
| coin=PEPE&market=perp | 200 | 4 ms | Bestanden FRESH |
| coin=SOL | 200 | 4 ms | Bestanden PARTIAL |
| — | 400 | 1 ms | Bestanden 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
- 15s
- Edge-Micro-Cache
- 10s
- Aktualisierungsintervall
- Snapshots alle 120 Sekunden für die meistgehandelten Coins und alle 600 Sekunden für die übrigen (einige wenige Börsen: 300 / 1200 Sekunden). Eine Zeile gilt für drei Erhebungsperioden als aktuell, mindestens 300 Sekunden.
- 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; eine Zeile je Börse × Markt × Kontrakt.
- Sortierung
- Zuerst Perpetual-Zeilen, dann Spot; innerhalb davon absteigend nach Tiefe bei ±1 % (Bid + Ask).
- 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.
- Methode
- mid = (best bid + best ask) ÷ 2. Depth = Σ price × size of all levels between mid and mid ± x %. Slippage = (average fill price of a market order of N USD − mid) ÷ mid, in bp; `null` with flag `insufficient_book` when the snapshot cannot fill the order (no extrapolation), flag `upper_bound` when an aggregated price bucket was used.
- 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 03:58:06 UTCHTTP 2007 msSchema stimmt übereinNeuester Datenpunkt 0s alt
Der Endpunkt meldet die Datenqualität PARTIAL — Bei den liquidesten Coins reichen die öffentlichen Snapshots mehrerer großer Börsen nicht über das gesamte Band, daher werden diese Börsen aus dem Aggregat ausgeschlossen und das Aggregat weist die Gesamttiefe zu niedrig aus. Die Felder `lower_bound_*` ergänzen den beobachteten Teil. Lesen Sie `n_included` immer zusammen mit dem Tiefenwert.
Verfügbarkeit, letzte 30 Tage
100 % von 407 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
GET
/api/sd/liquidityTeilweiseParameter
string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.
string · Standard all — Market type. Perpetual and spot books are never added together.
Anfrage-URL
https://www.coinboss.com/api/sd/liquidity?coin=BTCWählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.
Mehr in dieser Kategorie
- Orderbuchtiefe und Slippage /api/sd/liquidity
- Historie der Orderbuchtiefe /api/sd/liquidity/history
- Coin-Ranking nach Orderbuchtiefe /api/sd/liquidity/rank
- Monitor für große ruhende Orders /api/indicators/large-orderbook