GETParzialePARTIAL
Profondità del book degli ordini e slippage
Profondità del book degli ordini per exchange entro ±0.5 / 1 / 2 % dal prezzo mid, spread e slippage di un ordine a mercato da 10k / 100k / 1M USD, più un aggregato per tipo di mercato con il relativo denominatore.
GET
/api/sd/liquidityCopertura parziale. Per le monete più liquide, le istantanee pubbliche di diversi grandi exchange non raggiungono l'intera fascia, quindi tali exchange sono esclusi dall'aggregato e l'aggregato sottostima la profondità totale. I campi `lower_bound_*` aggiungono la parte osservata. Leggere sempre `n_included` insieme al valore di profondità.
Richiesta
Parametri di query
| Nome | Tipo | Obbligatorio | Predefinito | Valori ammessi | Descrizione |
|---|---|---|---|---|---|
| coin | string | Obbligatorio | — | — | Simbolo della moneta, senza distinzione tra maiuscole e minuscole (per esempio `BTC`). I valori mancanti o malformati restituiscono 400. Esempio: BTC |
| market | string | Facoltativo | all | perp, spot, all | Tipo di mercato. I book dei perpetui e quelli spot non vengono mai sommati. |
Richiesta di esempio
curl -s "https://www.coinboss.com/api/sd/liquidity?coin=BTC"Campi della risposta
La tabella dei campi è generata da risposte reali, quindi elenca esattamente ciò che l'endpoint restituisce. I percorsi usano a[] per gli elementi di un array e {*} per gli oggetti indicizzati da un nome dinamico, come una moneta o un exchange.
| Campo | Tipo | Unità | Descrizione |
|---|---|---|---|
| success | boolean | — | true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`. |
| schema | string | — | ID dello schema di questa risposta. Cambia solo quando un campo esistente cambia significato o tipo. |
| now | number | ms | Ora del server al momento della composizione della risposta. |
| coin | string | — | Simbolo della moneta (in maiuscolo). |
| market | string | — | `perp` o `spot`. |
| venues | array | — | Una riga per exchange × mercato × contratto. |
| venues[] | object | — | Una riga per exchange × mercato × contratto. |
| venues[].exchange | string | — | ID dell'exchange (in minuscolo). |
| venues[].market | string | — | `perp` o `spot`. |
| venues[].symbol | string | — | Simbolo del contratto nella forma di archiviazione di CoinBoss. |
| venues[].quote | string | — | Valuta di quotazione del mercato; USDT, USDC e USD sono conteggiati 1:1 come USD. |
| venues[].multiplier | number | — | Monete per unità quotata (1000 per i contratti del tipo `1000PEPE`). I prezzi sono già divisi per questo valore. |
| venues[].contract_value | number | — | Dimensione di un contratto: in monete per i contratti lineari, in USD per i contratti inversi. |
| venues[].inverse | boolean | — | True per i contratti con margine in coin quotati in USD per contratto. |
| venues[].mid | number | USD | (miglior bid + miglior ask) ÷ 2, prezzo di una moneta. |
| venues[].best_bid | number | USD | Miglior prezzo bid di una moneta. |
| venues[].best_ask | number | USD | Miglior prezzo ask di una moneta. |
| venues[].spread_bps | number | bp | (miglior ask − miglior bid) ÷ prezzo mid. |
| venues[].n_bids | number | — | Livelli di prezzo bid nell'istantanea. |
| venues[].n_asks | number | — | Livelli di prezzo ask nell'istantanea. |
| venues[].reach_bid_pct | number | % | Distanza dal prezzo mid al livello bid più lontano dell'istantanea. |
| venues[].reach_ask_pct | number | % | Distanza dal prezzo mid al livello ask più lontano dell'istantanea. |
| venues[].book_complete_bid | boolean | — | True quando è stato restituito l'intero lato bid del book. |
| venues[].book_complete_ask | boolean | — | True quando è stato restituito l'intero lato ask del book. |
| venues[].bands | object | — | Profondità per fascia; le chiavi `0.5`, `1` e `2` sono la distanza dal prezzo mid in percentuale. |
| venues[].bands.1 | object | — | Fascia a questa distanza dal prezzo mid, in percentuale. |
| venues[].bands.1.bid_depth_usd | number | USD | Nozionale degli ordini bid in attesa tra il prezzo mid e il bordo inferiore della fascia. Un limite inferiore quando `complete` è false. |
| venues[].bands.1.ask_depth_usd | number | USD | Nozionale degli ordini ask in attesa tra il prezzo mid e il bordo superiore della fascia. Un limite inferiore quando `complete` è false. |
| venues[].bands.1.complete | boolean | — | True quando entrambi i lati dell'istantanea raggiungono il bordo della fascia. Le righe incomplete sono escluse dagli aggregati. |
| venues[].bands.2 | object | — | Fascia a questa distanza dal prezzo mid, in percentuale. |
| venues[].bands.2.bid_depth_usd | number | USD | Nozionale degli ordini bid in attesa tra il prezzo mid e il bordo inferiore della fascia. Un limite inferiore quando `complete` è false. |
| venues[].bands.2.ask_depth_usd | number | USD | Nozionale degli ordini ask in attesa tra il prezzo mid e il bordo superiore della fascia. Un limite inferiore quando `complete` è false. |
| venues[].bands.2.complete | boolean | — | True quando entrambi i lati dell'istantanea raggiungono il bordo della fascia. Le righe incomplete sono escluse dagli aggregati. |
| venues[].bands.0.5 | object | — | Fascia a questa distanza dal prezzo mid, in percentuale. |
| venues[].bands.0.5.bid_depth_usd | number | USD | Nozionale degli ordini bid in attesa tra il prezzo mid e il bordo inferiore della fascia. Un limite inferiore quando `complete` è false. |
| venues[].bands.0.5.ask_depth_usd | number | USD | Nozionale degli ordini ask in attesa tra il prezzo mid e il bordo superiore della fascia. Un limite inferiore quando `complete` è false. |
| venues[].bands.0.5.complete | boolean | — | True quando entrambi i lati dell'istantanea raggiungono il bordo della fascia. Le righe incomplete sono escluse dagli aggregati. |
| venues[].slippage | object | — | Slippage di un ordine a mercato; le chiavi `10000`, `100000` e `1000000` indicano la dimensione dell'ordine in USD. |
| venues[].slippage.10000 | object | — | Ordine a mercato di questa dimensione in USD. |
| venues[].slippage.10000.buy_bps | number | bp | Prezzo medio di esecuzione di un acquisto a mercato rispetto al prezzo mid (include metà dello spread); `null` quando l'istantanea non consente di eseguire l'ordine. |
| venues[].slippage.10000.sell_bps | number|null | bp | Prezzo medio di esecuzione di una vendita a mercato rispetto al prezzo mid (include metà dello spread); `null` quando l'istantanea non consente di eseguire l'ordine. |
| venues[].slippage.10000.buy_flag | null | — | `insufficient_book` quando l'ordine non può essere eseguito con l'istantanea, `upper_bound` quando è stato usato un bucket aggregato, altrimenti `null`. |
| venues[].slippage.10000.sell_flag | string|null | — | `insufficient_book` quando l'ordine non può essere eseguito con l'istantanea, `upper_bound` quando è stato usato un bucket aggregato, altrimenti `null`. |
| venues[].slippage.100000 | object | — | Ordine a mercato di questa dimensione in USD. |
| venues[].slippage.100000.buy_bps | number|null | bp | Prezzo medio di esecuzione di un acquisto a mercato rispetto al prezzo mid (include metà dello spread); `null` quando l'istantanea non consente di eseguire l'ordine. |
| venues[].slippage.100000.sell_bps | number|null | bp | Prezzo medio di esecuzione di una vendita a mercato rispetto al prezzo mid (include metà dello spread); `null` quando l'istantanea non consente di eseguire l'ordine. |
| venues[].slippage.100000.buy_flag | string|null | — | `insufficient_book` quando l'ordine non può essere eseguito con l'istantanea, `upper_bound` quando è stato usato un bucket aggregato, altrimenti `null`. |
| venues[].slippage.100000.sell_flag | string|null | — | `insufficient_book` quando l'ordine non può essere eseguito con l'istantanea, `upper_bound` quando è stato usato un bucket aggregato, altrimenti `null`. |
| venues[].slippage.1000000 | object | — | Ordine a mercato di questa dimensione in USD. |
| venues[].slippage.1000000.buy_bps | number|null | bp | Prezzo medio di esecuzione di un acquisto a mercato rispetto al prezzo mid (include metà dello spread); `null` quando l'istantanea non consente di eseguire l'ordine. |
| venues[].slippage.1000000.sell_bps | number|null | bp | Prezzo medio di esecuzione di una vendita a mercato rispetto al prezzo mid (include metà dello spread); `null` quando l'istantanea non consente di eseguire l'ordine. |
| venues[].slippage.1000000.buy_flag | string|null | — | `insufficient_book` quando l'ordine non può essere eseguito con l'istantanea, `upper_bound` quando è stato usato un bucket aggregato, altrimenti `null`. |
| venues[].slippage.1000000.sell_flag | string|null | — | `insufficient_book` quando l'ordine non può essere eseguito con l'istantanea, `upper_bound` quando è stato usato un bucket aggregato, altrimenti `null`. |
| venues[].book_bid_usd | number | USD | Nozionale di tutti i bid contenuti nell'istantanea. |
| venues[].book_ask_usd | number | USD | Nozionale di tutti gli ask contenuti nell'istantanea. |
| venues[].agg_step_bps | number|null | bp | Bucket di aggregazione dei prezzi più ampio usato entro ±2 %; `null` quando sono stati usati solo livelli grezzi. |
| venues[].layers | number | — | Numero di istantanee unite per comporre questa riga. |
| venues[].observed_at | number|null | ms | Timestamp indicato dalla fonte per i dati. |
| venues[].received_at | number | ms | Ora in cui il collector di CoinBoss ha ricevuto i dati. |
| venues[].lag_ms | number|null | ms | Ora di ricezione meno il timestamp del book fornito dalla piattaforma; `null` quando la piattaforma non lo fornisce. |
| venues[].age_s | number | s | Secondi trascorsi dalla ricezione della riga. |
| venues[].fresh_window_s | number | s | Una riga più vecchia di questo valore è obsoleta. |
| venues[].is_stale | boolean | — | True quando i dati sono più vecchi della loro finestra di freschezza. |
| venues[].tier | string | — | Livello di raccolta: `A` per le monete più scambiate, `B` per le altre. |
| venues[].period_s | number | s | Periodo di raccolta della riga. |
| aggregate | object | — | Totali per tipo di mercato. Perpetui e spot non vengono mai sommati. |
| aggregate.perp | object | — | Aggregato sui book dei perpetui; `null` quando non c'è alcuna riga. può essere assente |
| aggregate.perp.n_rows | number | — | Righe trovate, comprese quelle obsolete. può essere assente |
| aggregate.perp.n_fresh | number | — | Righe aggiornate. può essere assente |
| aggregate.perp.mid_median | number | USD | Mediana del prezzo mid delle righe aggiornate. può essere assente |
| aggregate.perp.spread_bps_min | number | bp | Spread più stretto tra le righe aggiornate. può essere assente |
| aggregate.perp.bands | object | — | Profondità per fascia; le chiavi `0.5`, `1` e `2` sono la distanza dal prezzo mid in percentuale. può essere assente |
| aggregate.perp.bands.1 | object | — | Fascia a questa distanza dal prezzo mid, in percentuale. può essere assente |
| aggregate.perp.bands.1.bid_depth_usd | number | USD | Nozionale degli ordini bid in attesa tra il prezzo mid e il bordo inferiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.perp.bands.1.ask_depth_usd | number | USD | Nozionale degli ordini ask in attesa tra il prezzo mid e il bordo superiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.perp.bands.1.n_included | number | — | Righe incluse nella somma della profondità: aggiornate e complete per la fascia. Va letto insieme al valore di profondità. può essere assente |
| aggregate.perp.bands.1.n_fresh | number | — | Righe aggiornate. può essere assente |
| aggregate.perp.bands.1.included_exchanges | array | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.perp.bands.1.included_exchanges[] | string | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.perp.bands.1.excluded_incomplete | array | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.perp.bands.1.excluded_incomplete[] | object | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.perp.bands.1.excluded_incomplete[].exchange | string | — | ID dell'exchange (in minuscolo). può essere assente |
| aggregate.perp.bands.1.excluded_incomplete[].symbol | string | — | Simbolo del contratto nella forma di archiviazione di CoinBoss. può essere assente |
| aggregate.perp.bands.1.excluded_incomplete[].reach_bid_pct | number | % | Distanza dal prezzo mid al livello bid più lontano dell'istantanea. può essere assente |
| aggregate.perp.bands.1.excluded_incomplete[].reach_ask_pct | number | % | Distanza dal prezzo mid al livello ask più lontano dell'istantanea. può essere assente |
| aggregate.perp.bands.1.lower_bound_bid_usd | number | USD | Profondità bid comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.perp.bands.1.lower_bound_ask_usd | number | USD | Profondità ask comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.perp.bands.1.uses_aggregated_buckets | boolean | — | True quando una riga inclusa ha usato bucket aggregati per prezzo, il che rende la somma un limite inferiore. può essere assente |
| aggregate.perp.bands.2 | object | — | Fascia a questa distanza dal prezzo mid, in percentuale. può essere assente |
| aggregate.perp.bands.2.bid_depth_usd | number | USD | Nozionale degli ordini bid in attesa tra il prezzo mid e il bordo inferiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.perp.bands.2.ask_depth_usd | number | USD | Nozionale degli ordini ask in attesa tra il prezzo mid e il bordo superiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.perp.bands.2.n_included | number | — | Righe incluse nella somma della profondità: aggiornate e complete per la fascia. Va letto insieme al valore di profondità. può essere assente |
| aggregate.perp.bands.2.n_fresh | number | — | Righe aggiornate. può essere assente |
| aggregate.perp.bands.2.included_exchanges | array | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.perp.bands.2.included_exchanges[] | string | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.perp.bands.2.excluded_incomplete | array | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.perp.bands.2.excluded_incomplete[] | object | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.perp.bands.2.excluded_incomplete[].exchange | string | — | ID dell'exchange (in minuscolo). può essere assente |
| aggregate.perp.bands.2.excluded_incomplete[].symbol | string | — | Simbolo del contratto nella forma di archiviazione di CoinBoss. può essere assente |
| aggregate.perp.bands.2.excluded_incomplete[].reach_bid_pct | number | % | Distanza dal prezzo mid al livello bid più lontano dell'istantanea. può essere assente |
| aggregate.perp.bands.2.excluded_incomplete[].reach_ask_pct | number | % | Distanza dal prezzo mid al livello ask più lontano dell'istantanea. può essere assente |
| aggregate.perp.bands.2.lower_bound_bid_usd | number | USD | Profondità bid comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.perp.bands.2.lower_bound_ask_usd | number | USD | Profondità ask comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.perp.bands.2.uses_aggregated_buckets | boolean | — | True quando una riga inclusa ha usato bucket aggregati per prezzo, il che rende la somma un limite inferiore. può essere assente |
| aggregate.perp.bands.0.5 | object | — | Fascia a questa distanza dal prezzo mid, in percentuale. può essere assente |
| aggregate.perp.bands.0.5.bid_depth_usd | number | USD | Nozionale degli ordini bid in attesa tra il prezzo mid e il bordo inferiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.perp.bands.0.5.ask_depth_usd | number | USD | Nozionale degli ordini ask in attesa tra il prezzo mid e il bordo superiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.perp.bands.0.5.n_included | number | — | Righe incluse nella somma della profondità: aggiornate e complete per la fascia. Va letto insieme al valore di profondità. può essere assente |
| aggregate.perp.bands.0.5.n_fresh | number | — | Righe aggiornate. può essere assente |
| aggregate.perp.bands.0.5.included_exchanges | array | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.perp.bands.0.5.included_exchanges[] | string | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.perp.bands.0.5.excluded_incomplete | array | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.perp.bands.0.5.excluded_incomplete[] | object | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.perp.bands.0.5.excluded_incomplete[].exchange | string | — | ID dell'exchange (in minuscolo). può essere assente |
| aggregate.perp.bands.0.5.excluded_incomplete[].symbol | string | — | Simbolo del contratto nella forma di archiviazione di CoinBoss. può essere assente |
| aggregate.perp.bands.0.5.excluded_incomplete[].reach_bid_pct | number | % | Distanza dal prezzo mid al livello bid più lontano dell'istantanea. può essere assente |
| aggregate.perp.bands.0.5.excluded_incomplete[].reach_ask_pct | number | % | Distanza dal prezzo mid al livello ask più lontano dell'istantanea. può essere assente |
| aggregate.perp.bands.0.5.lower_bound_bid_usd | number | USD | Profondità bid comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.perp.bands.0.5.lower_bound_ask_usd | number | USD | Profondità ask comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.perp.bands.0.5.uses_aggregated_buckets | boolean | — | True quando una riga inclusa ha usato bucket aggregati per prezzo, il che rende la somma un limite inferiore. può essere assente |
| aggregate.spot | object | — | Aggregato sui book spot; `null` quando non c'è alcuna riga. può essere assente |
| aggregate.spot.n_rows | number | — | Righe trovate, comprese quelle obsolete. può essere assente |
| aggregate.spot.n_fresh | number | — | Righe aggiornate. può essere assente |
| aggregate.spot.mid_median | number | USD | Mediana del prezzo mid delle righe aggiornate. può essere assente |
| aggregate.spot.spread_bps_min | number | bp | Spread più stretto tra le righe aggiornate. può essere assente |
| aggregate.spot.bands | object | — | Profondità per fascia; le chiavi `0.5`, `1` e `2` sono la distanza dal prezzo mid in percentuale. può essere assente |
| aggregate.spot.bands.1 | object | — | Fascia a questa distanza dal prezzo mid, in percentuale. può essere assente |
| aggregate.spot.bands.1.bid_depth_usd | number | USD | Nozionale degli ordini bid in attesa tra il prezzo mid e il bordo inferiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.spot.bands.1.ask_depth_usd | number | USD | Nozionale degli ordini ask in attesa tra il prezzo mid e il bordo superiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.spot.bands.1.n_included | number | — | Righe incluse nella somma della profondità: aggiornate e complete per la fascia. Va letto insieme al valore di profondità. può essere assente |
| aggregate.spot.bands.1.n_fresh | number | — | Righe aggiornate. può essere assente |
| aggregate.spot.bands.1.included_exchanges | array | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.spot.bands.1.included_exchanges[] | string | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.spot.bands.1.excluded_incomplete | array | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.spot.bands.1.excluded_incomplete[] | object | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.spot.bands.1.excluded_incomplete[].exchange | string | — | ID dell'exchange (in minuscolo). può essere assente |
| aggregate.spot.bands.1.excluded_incomplete[].symbol | string | — | Simbolo del contratto nella forma di archiviazione di CoinBoss. può essere assente |
| aggregate.spot.bands.1.excluded_incomplete[].reach_bid_pct | number | % | Distanza dal prezzo mid al livello bid più lontano dell'istantanea. può essere assente |
| aggregate.spot.bands.1.excluded_incomplete[].reach_ask_pct | number | % | Distanza dal prezzo mid al livello ask più lontano dell'istantanea. può essere assente |
| aggregate.spot.bands.1.lower_bound_bid_usd | number | USD | Profondità bid comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.spot.bands.1.lower_bound_ask_usd | number | USD | Profondità ask comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.spot.bands.1.uses_aggregated_buckets | boolean | — | True quando una riga inclusa ha usato bucket aggregati per prezzo, il che rende la somma un limite inferiore. può essere assente |
| aggregate.spot.bands.2 | object | — | Fascia a questa distanza dal prezzo mid, in percentuale. può essere assente |
| aggregate.spot.bands.2.bid_depth_usd | number | USD | Nozionale degli ordini bid in attesa tra il prezzo mid e il bordo inferiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.spot.bands.2.ask_depth_usd | number | USD | Nozionale degli ordini ask in attesa tra il prezzo mid e il bordo superiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.spot.bands.2.n_included | number | — | Righe incluse nella somma della profondità: aggiornate e complete per la fascia. Va letto insieme al valore di profondità. può essere assente |
| aggregate.spot.bands.2.n_fresh | number | — | Righe aggiornate. può essere assente |
| aggregate.spot.bands.2.included_exchanges | array | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.spot.bands.2.included_exchanges[] | string | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.spot.bands.2.excluded_incomplete | array | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.spot.bands.2.excluded_incomplete[] | object | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.spot.bands.2.excluded_incomplete[].exchange | string | — | ID dell'exchange (in minuscolo). può essere assente |
| aggregate.spot.bands.2.excluded_incomplete[].symbol | string | — | Simbolo del contratto nella forma di archiviazione di CoinBoss. può essere assente |
| aggregate.spot.bands.2.excluded_incomplete[].reach_bid_pct | number | % | Distanza dal prezzo mid al livello bid più lontano dell'istantanea. può essere assente |
| aggregate.spot.bands.2.excluded_incomplete[].reach_ask_pct | number | % | Distanza dal prezzo mid al livello ask più lontano dell'istantanea. può essere assente |
| aggregate.spot.bands.2.lower_bound_bid_usd | number | USD | Profondità bid comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.spot.bands.2.lower_bound_ask_usd | number | USD | Profondità ask comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.spot.bands.2.uses_aggregated_buckets | boolean | — | True quando una riga inclusa ha usato bucket aggregati per prezzo, il che rende la somma un limite inferiore. può essere assente |
| aggregate.spot.bands.0.5 | object | — | Fascia a questa distanza dal prezzo mid, in percentuale. può essere assente |
| aggregate.spot.bands.0.5.bid_depth_usd | number | USD | Nozionale degli ordini bid in attesa tra il prezzo mid e il bordo inferiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.spot.bands.0.5.ask_depth_usd | number | USD | Nozionale degli ordini ask in attesa tra il prezzo mid e il bordo superiore della fascia. Un limite inferiore quando `complete` è false. può essere assente |
| aggregate.spot.bands.0.5.n_included | number | — | Righe incluse nella somma della profondità: aggiornate e complete per la fascia. Va letto insieme al valore di profondità. può essere assente |
| aggregate.spot.bands.0.5.n_fresh | number | — | Righe aggiornate. può essere assente |
| aggregate.spot.bands.0.5.included_exchanges | array | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.spot.bands.0.5.included_exchanges[] | string | — | Fonti i cui dati aggiornati sono inclusi. può essere assente |
| aggregate.spot.bands.0.5.excluded_incomplete | array | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.spot.bands.0.5.excluded_incomplete[] | object | — | Righe aggiornate escluse dalla fascia perché la loro istantanea non raggiunge il bordo della fascia. può essere assente |
| aggregate.spot.bands.0.5.excluded_incomplete[].exchange | string | — | ID dell'exchange (in minuscolo). può essere assente |
| aggregate.spot.bands.0.5.excluded_incomplete[].symbol | string | — | Simbolo del contratto nella forma di archiviazione di CoinBoss. può essere assente |
| aggregate.spot.bands.0.5.excluded_incomplete[].reach_bid_pct | number | % | Distanza dal prezzo mid al livello bid più lontano dell'istantanea. può essere assente |
| aggregate.spot.bands.0.5.excluded_incomplete[].reach_ask_pct | number | % | Distanza dal prezzo mid al livello ask più lontano dell'istantanea. può essere assente |
| aggregate.spot.bands.0.5.lower_bound_bid_usd | number | USD | Profondità bid comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.spot.bands.0.5.lower_bound_ask_usd | number | USD | Profondità ask comprensiva della parte osservata delle righe incomplete. Un valore minimo, non una stima. può essere assente |
| aggregate.spot.bands.0.5.uses_aggregated_buckets | boolean | — | True quando una riga inclusa ha usato bucket aggregati per prezzo, il che rende la somma un limite inferiore. può essere assente |
| coverage | object | — | Che cosa è incluso e che cosa non è incluso nei numeri. Confrontare questo dato prima di confrontare i totali con un'altra fonte. |
| coverage.included_exchanges | array | — | Fonti i cui dati aggiornati sono inclusi. |
| coverage.included_exchanges[] | string | — | Fonti i cui dati aggiornati sono inclusi. |
| coverage.unavailable | array | — | Fonti che non è stato possibile includere, ciascuna con il motivo. Non vengono mai conteggiate come 0. vuoto nei campioni usati per generare questa tabella |
| coverage.stale_excluded | array | — | Righe escluse perché il loro ultimo aggiornamento è fuori dalla finestra di freschezza. vuoto nei campioni usati per generare questa tabella |
| coverage.no_market | array | — | Coppie exchange × mercato che vengono raccolte ma non hanno alcuna riga per questa moneta. vuoto nei campioni usati per generare questa tabella |
| method | object | — | Enunciato in testo semplice delle formule usate per questa risposta, una voce per campo. |
| method.mid | string | — | Nota sulla formula di `mid`, in testo semplice. |
| method.spread_bps | string | — | Nota sulla formula di `spread_bps`, in testo semplice. |
| method.bid_depth_usd | string | — | Nota sulla formula di `bid_depth_usd`, in testo semplice. |
| method.ask_depth_usd | string | — | Nota sulla formula di `ask_depth_usd`, in testo semplice. |
| method.complete | string | — | Nota sulla formula di `complete`, in testo semplice. |
| method.reach_pct | string | — | Nota sulla formula di `reach_pct`, in testo semplice. |
| method.slippage_bps | string | — | Nota sulla formula di `slippage_bps`, in testo semplice. |
| method.agg_step_bps | string | — | Nota sulla formula di `agg_step_bps`, in testo semplice. |
| method.aggregate | string | — | Nota sulla formula di `aggregate`, in testo semplice. |
| method.fresh | string | — | Nota sulla formula di `fresh`, in testo semplice. |
| method.lag_ms | string | — | Nota sulla formula di `lag_ms`, in testo semplice. |
| method.no_market | string | — | Nota sulla formula di `no_market`, in testo semplice. |
| meta | object | — | Provenienza e freschezza di questa risposta. |
| meta.schema | string | — | ID dello schema di questa risposta. Cambia solo quando un campo esistente cambia significato o tipo. |
| meta.source | array | — | Endpoint pubblici a monte da cui sono stati raccolti i dati. |
| meta.source[] | object | — | Endpoint pubblici a monte da cui sono stati raccolti i dati. |
| meta.source[].exchange | string | — | ID dell'exchange (in minuscolo). |
| meta.source[].market | string | — | `perp` o `spot`. |
| meta.source[].endpoint | string | — | Endpoint pubblico della fonte letto dal collector (mostrato a scopo di provenienza; i client non lo chiamano mai). |
| meta.observed_at | number | ms | Timestamp indicato dalla fonte per i dati. |
| meta.received_at | number | ms | Ora in cui il collector di CoinBoss ha ricevuto i dati. |
| meta.fetched_at | number | ms | Ora in cui questa risposta è stata composta. |
| meta.window | string | — | Finestra temporale coperta dai numeri. |
| meta.quality | string | — | FRESH, PARTIAL, STALE, BROKEN o UNAVAILABLE, valutato dai timestamp dei dati e dalla copertura. |
| meta.is_stale | boolean | — | True quando i dati sono più vecchi della loro finestra di freschezza. |
| meta.cache_ttl_s | number | s | Durata in cache di questa risposta. |
| meta.fallback | string | — | Che cosa restituisce l'endpoint quando il collector o una fonte non funziona. |
| meta.collector_heartbeat_age_s | number | s | Secondi trascorsi dall'ultima volta in cui il collector ha segnalato di essere in esecuzione. |
Generata 2026-11-11 23:28 UTC da 4 risposte reali.
Risposta di esempio
/api/sd/liquidity?coin=BTC · Risposta reale acquisita 2026-11-13 03:58:06 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: venues conteneva 39 elementi; meta.source conteneva 38 elementi; coverage.included_exchanges conteneva 24 elementi; aggregate.perp.bands.1.included_exchanges conteneva 19 elementi; aggregate.perp.bands.2.included_exchanges conteneva 16 elementi; aggregate.spot.bands.1.included_exchanges conteneva 14 elementi.
- "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
Campioni verificati
Oltre all'esempio qui sopra, la sonda chiama questo endpoint con i parametri seguenti e ogni volta ne verifica lo schema.
| Parametri | HTTP | Latenza | Risultato |
|---|---|---|---|
| coin=ETH&market=spot | 200 | 3 ms | Superato PARTIAL |
| coin=PEPE&market=perp | 200 | 4 ms | Superato FRESH |
| coin=SOL | 200 | 4 ms | Superato PARTIAL |
| — | 400 | 1 ms | Superato restituisce l'errore previsto |
Verificato 2026-11-13 03:58:06 UTC
Dettagli
- Autenticazione
- Nessuna. Endpoint pubblico.
- Limite di richieste
- 1200 richieste al minuto per IP
- Cache del server
- 15s
- Micro-cache edge
- 10s
- Frequenza di aggiornamento
- Istantanee ogni 120 secondi per le monete più scambiate e ogni 600 secondi per le restanti (alcuni exchange: 300 / 1200 secondi). Una riga è aggiornata per tre periodi di raccolta, almeno 300 secondi.
- Finestra
- Ultima istantanea per contratto.
- Fonti dei dati
- Istantanee REST pubbliche del book degli ordini di 24 exchange (mercati perpetui e spot), raccolte e archiviate da CoinBoss (sd_book_latest, sd_book_hist). Profondità e slippage sono calcolati da CoinBoss a partire dai livelli di prezzo grezzi.
- Copertura degli exchange
- 24 exchange, 38 combinazioni exchange × mercato. Quando un'istantanea pubblica non raggiunge ±0.5 / 1 / 2 % dal prezzo mid (limite di livelli dell'exchange), quella fascia è contrassegnata con `complete: false`, il suo valore è un limite inferiore ed è esclusa dall'aggregato; `n_included` / `n_fresh` indicano il denominatore e `excluded_incomplete` elenca ciò che è stato escluso.
- Paginazione
- Nessuna paginazione; una riga per exchange × mercato × contratto.
- Ordinamento
- Prima le righe dei perpetui, poi quelle spot; all'interno di ciascun gruppo per profondità a ±1 % (bid + ask) decrescente.
- Unità
- 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.
- Metodo
- 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.
- Timestamp
- Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
- Formato della risposta
- json
- Stabilità
- Stabile
- Disponibile dal
- 2026-11-11
Stato in tempo reale
ParzialeVerificato 2026-11-13 03:58:06 UTCHTTP 2007 msSchema conformeDato più recente risalente a 0s fa
L'endpoint segnala una qualità dei dati PARTIAL — Per le monete più liquide, le istantanee pubbliche di diversi grandi exchange non raggiungono l'intera fascia, quindi tali exchange sono esclusi dall'aggregato e l'aggregato sottostima la profondità totale. I campi `lower_bound_*` aggiungono la parte osservata. Leggere sempre `n_included` insieme al valore di profondità.
Disponibilità, ultimi 30 giorni
100% di 407 verifiche superate
Errori
Le chiamate non riuscite hanno la stessa struttura su tutti gli endpoint. L'elenco completo è nella pagina degli errori. Errori e limiti di richieste →
| Codice | HTTP | Significato | Che cosa fare |
|---|---|---|---|
| INVALID_PARAM | 400 | Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto. | Non riprovare senza modifiche; correggere la richiesta. |
| UNAUTHORIZED | 401 | L'header `CB-API-KEY` è stato inviato ma la chiave è sconosciuta o revocata. I dati pubblici non richiedono alcuna chiave: rimuovere l'header o usare una chiave valida. | Non riprovare senza modifiche. |
| FORBIDDEN | 403 | La route non fa parte dell'API pubblica (interna o riservata agli account). | Non riprovare. |
| NOT_FOUND | 404 | Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste. | Non riprovare; verificare il percorso e gli identificatori nel catalogo. |
| RATE_LIMITED | 429 | Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere. | Attendere `Retry-After`, poi riprovare con backoff. |
| INTERNAL | 500 | Errore imprevisto del server. Il messaggio è volutamente generico; citare `request_id` quando lo si segnala. | Riprovare una volta dopo qualche secondo; se persiste, segnalarlo con l'ID della richiesta. |
| UPSTREAM_FAILED | 503 | La fonte di dati alla base di questo endpoint non ha risposto in tempo. Al suo posto non vengono restituiti numeri obsoleti o sostitutivi. | Riprovare con backoff; controllare la pagina di stato. |
| UNAVAILABLE | 501 / 503 | Il dataset è temporaneamente non pronto (riscaldamento della cache) oppure l'endpoint non ha ancora una fonte pubblica lecita. | Riprovare più tardi; il catalogo contrassegna gli endpoint non disponibili per scelta progettuale. |
| REQUEST_FAILED | 200 | Alcuni endpoint meno recenti rispondono HTTP 200 con `success: false`. Controllare sempre `success`, non solo lo stato HTTP. | Dipende dal messaggio; trattare come una richiesta non riuscita. |
Prova
GET
/api/sd/liquidityParzialeParametri
string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.
string · predefinito all — Market type. Perpetual and spot books are never added together.
URL della richiesta
https://www.coinboss.com/api/sd/liquidity?coin=BTCScegliere un endpoint e premere «Invia richiesta». La risposta, gli header e i tempi compariranno qui.
Altro in questa categoria
- Profondità del book degli ordini e slippage /api/sd/liquidity
- Storico della profondità del book degli ordini /api/sd/liquidity/history
- Monete classificate per profondità del book degli ordini /api/sd/liquidity/rank
- Monitor dei grandi ordini in attesa /api/indicators/large-orderbook