GETKısmiPARTIAL
Emir defteri derinliği ve kayma
Borsa bazında orta fiyatın ±0.5 / 1 / 2 % çevresindeki emir defteri derinliği, spread ve 10k / 100k / 1M USD'lik bir piyasa emrinin kayması; ayrıca her piyasa türü için paydasıyla birlikte bir toplu değer.
GET
/api/sd/liquidityKısmi kapsam. En likit coinlerde birkaç büyük borsanın herkese açık anlık görüntüleri bandın tamamına ulaşmaz; bu yüzden söz konusu borsalar toplu değerin dışında bırakılır ve toplu değer toplam derinliği olduğundan düşük gösterir. `lower_bound_*` alanları gözlemlenen kısmı ekler. `n_included` değerini her zaman derinlik değeriyle birlikte okuyun.
İstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| coin | string | Zorunlu | — | — | Coin sembolü, büyük/küçük harfe duyarsız (örneğin `BTC`). Eksik veya hatalı biçimli değerler 400 döndürür. Örnek: BTC |
| market | string | İsteğe bağlı | all | perp, spot, all | Piyasa türü. Sürekli vadeli ve spot emir defterleri hiçbir zaman birbirine eklenmez. |
Örnek istek
curl -s "https://www.coinboss.com/api/sd/liquidity?coin=BTC"Yanıt alanları
Alan tablosu gerçek yanıtlardan üretilir; dolayısıyla uç noktanın tam olarak ne döndürdüğünü listeler. Yollarda a[] dizi öğelerini, {*} ise coin veya borsa gibi dinamik bir adla anahtarlanan nesneleri gösterir.
| Alan | Tür | Birim | Açıklama |
|---|---|---|---|
| success | boolean | — | İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur. |
| schema | string | — | Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir. |
| now | number | ms | Yanıtın oluşturulduğu andaki sunucu zamanı. |
| coin | string | — | Coin sembolü (büyük harf). |
| market | string | — | `perp` veya `spot`. |
| venues | array | — | Her borsa × piyasa × sözleşme için bir satır. |
| venues[] | object | — | Her borsa × piyasa × sözleşme için bir satır. |
| venues[].exchange | string | — | Borsa kimliği (küçük harf). |
| venues[].market | string | — | `perp` veya `spot`. |
| venues[].symbol | string | — | CoinBoss'un depolama biçimindeki sözleşme sembolü. |
| venues[].quote | string | — | Piyasanın kotasyon para birimi; USDT, USDC ve USD 1:1 oranında USD olarak sayılır. |
| venues[].multiplier | number | — | Kote edilen birim başına coin sayısı (`1000PEPE` türü sözleşmelerde 1000). Fiyatlar zaten bu değere bölünmüştür. |
| venues[].contract_value | number | — | Bir sözleşmenin büyüklüğü: doğrusal sözleşmelerde coin, ters sözleşmelerde USD cinsinden. |
| venues[].inverse | boolean | — | Sözleşme başına USD cinsinden kote edilen coin teminatlı sözleşmeler için true. |
| venues[].mid | number | USD | (en iyi alış + en iyi satış) ÷ 2, bir coinin fiyatı. |
| venues[].best_bid | number | USD | Bir coinin en iyi alış fiyatı. |
| venues[].best_ask | number | USD | Bir coinin en iyi satış fiyatı. |
| venues[].spread_bps | number | bp | (en iyi satış − en iyi alış) ÷ orta fiyat. |
| venues[].n_bids | number | — | Anlık görüntüdeki alış fiyat seviyeleri. |
| venues[].n_asks | number | — | Anlık görüntüdeki satış fiyat seviyeleri. |
| venues[].reach_bid_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak alış seviyesi arasındaki uzaklık. |
| venues[].reach_ask_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak satış seviyesi arasındaki uzaklık. |
| venues[].book_complete_bid | boolean | — | Emir defterinin alış tarafının tamamı döndürüldüğünde true. |
| venues[].book_complete_ask | boolean | — | Emir defterinin satış tarafının tamamı döndürüldüğünde true. |
| venues[].bands | object | — | Bant bazında derinlik; `0.5`, `1` ve `2` anahtarları orta fiyata olan uzaklığın yüzde cinsinden değeridir. |
| venues[].bands.1 | object | — | Orta fiyata bu uzaklıktaki bant, yüzde cinsinden. |
| venues[].bands.1.bid_depth_usd | number | USD | Orta fiyat ile alt bant kenarı arasında bekleyen alış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. |
| venues[].bands.1.ask_depth_usd | number | USD | Orta fiyat ile üst bant kenarı arasında bekleyen satış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. |
| venues[].bands.1.complete | boolean | — | Anlık görüntünün her iki tarafı da bant kenarına ulaşıyorsa true. Eksik satırlar toplu değerlerin dışında bırakılır. |
| venues[].bands.2 | object | — | Orta fiyata bu uzaklıktaki bant, yüzde cinsinden. |
| venues[].bands.2.bid_depth_usd | number | USD | Orta fiyat ile alt bant kenarı arasında bekleyen alış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. |
| venues[].bands.2.ask_depth_usd | number | USD | Orta fiyat ile üst bant kenarı arasında bekleyen satış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. |
| venues[].bands.2.complete | boolean | — | Anlık görüntünün her iki tarafı da bant kenarına ulaşıyorsa true. Eksik satırlar toplu değerlerin dışında bırakılır. |
| venues[].bands.0.5 | object | — | Orta fiyata bu uzaklıktaki bant, yüzde cinsinden. |
| venues[].bands.0.5.bid_depth_usd | number | USD | Orta fiyat ile alt bant kenarı arasında bekleyen alış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. |
| venues[].bands.0.5.ask_depth_usd | number | USD | Orta fiyat ile üst bant kenarı arasında bekleyen satış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. |
| venues[].bands.0.5.complete | boolean | — | Anlık görüntünün her iki tarafı da bant kenarına ulaşıyorsa true. Eksik satırlar toplu değerlerin dışında bırakılır. |
| venues[].slippage | object | — | Bir piyasa emrinin kayması; `10000`, `100000` ve `1000000` anahtarları USD cinsinden emir büyüklüğüdür. |
| venues[].slippage.10000 | object | — | USD cinsinden bu büyüklükteki piyasa emri. |
| venues[].slippage.10000.buy_bps | number | bp | Bir piyasa alış emrinin orta fiyata göre ortalama gerçekleşme fiyatı (spread'in yarısını içerir); anlık görüntü emri karşılayamıyorsa `null`. |
| venues[].slippage.10000.sell_bps | number|null | bp | Bir piyasa satış emrinin orta fiyata göre ortalama gerçekleşme fiyatı (spread'in yarısını içerir); anlık görüntü emri karşılayamıyorsa `null`. |
| venues[].slippage.10000.buy_flag | null | — | Emir anlık görüntüden karşılanamıyorsa `insufficient_book`, birleştirilmiş bir dilim kullanıldıysa `upper_bound`, aksi hâlde `null`. |
| venues[].slippage.10000.sell_flag | string|null | — | Emir anlık görüntüden karşılanamıyorsa `insufficient_book`, birleştirilmiş bir dilim kullanıldıysa `upper_bound`, aksi hâlde `null`. |
| venues[].slippage.100000 | object | — | USD cinsinden bu büyüklükteki piyasa emri. |
| venues[].slippage.100000.buy_bps | number|null | bp | Bir piyasa alış emrinin orta fiyata göre ortalama gerçekleşme fiyatı (spread'in yarısını içerir); anlık görüntü emri karşılayamıyorsa `null`. |
| venues[].slippage.100000.sell_bps | number|null | bp | Bir piyasa satış emrinin orta fiyata göre ortalama gerçekleşme fiyatı (spread'in yarısını içerir); anlık görüntü emri karşılayamıyorsa `null`. |
| venues[].slippage.100000.buy_flag | string|null | — | Emir anlık görüntüden karşılanamıyorsa `insufficient_book`, birleştirilmiş bir dilim kullanıldıysa `upper_bound`, aksi hâlde `null`. |
| venues[].slippage.100000.sell_flag | string|null | — | Emir anlık görüntüden karşılanamıyorsa `insufficient_book`, birleştirilmiş bir dilim kullanıldıysa `upper_bound`, aksi hâlde `null`. |
| venues[].slippage.1000000 | object | — | USD cinsinden bu büyüklükteki piyasa emri. |
| venues[].slippage.1000000.buy_bps | number|null | bp | Bir piyasa alış emrinin orta fiyata göre ortalama gerçekleşme fiyatı (spread'in yarısını içerir); anlık görüntü emri karşılayamıyorsa `null`. |
| venues[].slippage.1000000.sell_bps | number|null | bp | Bir piyasa satış emrinin orta fiyata göre ortalama gerçekleşme fiyatı (spread'in yarısını içerir); anlık görüntü emri karşılayamıyorsa `null`. |
| venues[].slippage.1000000.buy_flag | string|null | — | Emir anlık görüntüden karşılanamıyorsa `insufficient_book`, birleştirilmiş bir dilim kullanıldıysa `upper_bound`, aksi hâlde `null`. |
| venues[].slippage.1000000.sell_flag | string|null | — | Emir anlık görüntüden karşılanamıyorsa `insufficient_book`, birleştirilmiş bir dilim kullanıldıysa `upper_bound`, aksi hâlde `null`. |
| venues[].book_bid_usd | number | USD | Anlık görüntüde yer alan tüm alış emirlerinin nominal değeri. |
| venues[].book_ask_usd | number | USD | Anlık görüntüde yer alan tüm satış emirlerinin nominal değeri. |
| venues[].agg_step_bps | number|null | bp | ±2 % içinde kullanılan en geniş fiyat birleştirme dilimi; yalnızca ham seviyeler kullanıldıysa `null`. |
| venues[].layers | number | — | Bu satır için birbirine eklenen anlık görüntü sayısı. |
| venues[].observed_at | number|null | ms | Kaynağın veri için verdiği zaman damgası. |
| venues[].received_at | number | ms | CoinBoss toplayıcısının veriyi aldığı zaman. |
| venues[].lag_ms | number|null | ms | Alınma zamanı eksi borsanın emir defteri zaman damgası; borsa zaman damgası vermiyorsa `null`. |
| venues[].age_s | number | s | Satırın alınmasından bu yana geçen saniye. |
| venues[].fresh_window_s | number | s | Bundan daha eski bir satır eskimiş sayılır. |
| venues[].is_stale | boolean | — | Veri güncellik penceresinden eskiyse true. |
| venues[].tier | string | — | Toplama kademesi: en çok işlem gören coinler için `A`, geri kalanlar için `B`. |
| venues[].period_s | number | s | Satırın toplama periyodu. |
| aggregate | object | — | Piyasa türü bazında toplamlar. Sürekli vadeli ve spot hiçbir zaman birbirine eklenmez. |
| aggregate.perp | object | — | Sürekli vadeli emir defterleri üzerinden toplu değer; satır yoksa `null`. bulunmayabilir |
| aggregate.perp.n_rows | number | — | Eskimiş olanlar dahil bulunan satırlar. bulunmayabilir |
| aggregate.perp.n_fresh | number | — | Güncel satırlar. bulunmayabilir |
| aggregate.perp.mid_median | number | USD | Güncel satırların medyan orta fiyatı. bulunmayabilir |
| aggregate.perp.spread_bps_min | number | bp | Güncel satırlar arasındaki en dar spread. bulunmayabilir |
| aggregate.perp.bands | object | — | Bant bazında derinlik; `0.5`, `1` ve `2` anahtarları orta fiyata olan uzaklığın yüzde cinsinden değeridir. bulunmayabilir |
| aggregate.perp.bands.1 | object | — | Orta fiyata bu uzaklıktaki bant, yüzde cinsinden. bulunmayabilir |
| aggregate.perp.bands.1.bid_depth_usd | number | USD | Orta fiyat ile alt bant kenarı arasında bekleyen alış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.perp.bands.1.ask_depth_usd | number | USD | Orta fiyat ile üst bant kenarı arasında bekleyen satış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.perp.bands.1.n_included | number | — | Derinlik toplamına dahil edilen satırlar: güncel ve bant için eksiksiz olanlar. Derinlik değeriyle birlikte okuyun. bulunmayabilir |
| aggregate.perp.bands.1.n_fresh | number | — | Güncel satırlar. bulunmayabilir |
| aggregate.perp.bands.1.included_exchanges | array | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.perp.bands.1.included_exchanges[] | string | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.perp.bands.1.excluded_incomplete | array | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.perp.bands.1.excluded_incomplete[] | object | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.perp.bands.1.excluded_incomplete[].exchange | string | — | Borsa kimliği (küçük harf). bulunmayabilir |
| aggregate.perp.bands.1.excluded_incomplete[].symbol | string | — | CoinBoss'un depolama biçimindeki sözleşme sembolü. bulunmayabilir |
| aggregate.perp.bands.1.excluded_incomplete[].reach_bid_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak alış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.perp.bands.1.excluded_incomplete[].reach_ask_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak satış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.perp.bands.1.lower_bound_bid_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren alış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.perp.bands.1.lower_bound_ask_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren satış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.perp.bands.1.uses_aggregated_buckets | boolean | — | Dahil edilen bir satır fiyata göre birleştirilmiş dilimler kullandıysa true; bu durumda toplam bir alt sınır olur. bulunmayabilir |
| aggregate.perp.bands.2 | object | — | Orta fiyata bu uzaklıktaki bant, yüzde cinsinden. bulunmayabilir |
| aggregate.perp.bands.2.bid_depth_usd | number | USD | Orta fiyat ile alt bant kenarı arasında bekleyen alış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.perp.bands.2.ask_depth_usd | number | USD | Orta fiyat ile üst bant kenarı arasında bekleyen satış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.perp.bands.2.n_included | number | — | Derinlik toplamına dahil edilen satırlar: güncel ve bant için eksiksiz olanlar. Derinlik değeriyle birlikte okuyun. bulunmayabilir |
| aggregate.perp.bands.2.n_fresh | number | — | Güncel satırlar. bulunmayabilir |
| aggregate.perp.bands.2.included_exchanges | array | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.perp.bands.2.included_exchanges[] | string | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.perp.bands.2.excluded_incomplete | array | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.perp.bands.2.excluded_incomplete[] | object | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.perp.bands.2.excluded_incomplete[].exchange | string | — | Borsa kimliği (küçük harf). bulunmayabilir |
| aggregate.perp.bands.2.excluded_incomplete[].symbol | string | — | CoinBoss'un depolama biçimindeki sözleşme sembolü. bulunmayabilir |
| aggregate.perp.bands.2.excluded_incomplete[].reach_bid_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak alış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.perp.bands.2.excluded_incomplete[].reach_ask_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak satış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.perp.bands.2.lower_bound_bid_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren alış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.perp.bands.2.lower_bound_ask_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren satış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.perp.bands.2.uses_aggregated_buckets | boolean | — | Dahil edilen bir satır fiyata göre birleştirilmiş dilimler kullandıysa true; bu durumda toplam bir alt sınır olur. bulunmayabilir |
| aggregate.perp.bands.0.5 | object | — | Orta fiyata bu uzaklıktaki bant, yüzde cinsinden. bulunmayabilir |
| aggregate.perp.bands.0.5.bid_depth_usd | number | USD | Orta fiyat ile alt bant kenarı arasında bekleyen alış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.perp.bands.0.5.ask_depth_usd | number | USD | Orta fiyat ile üst bant kenarı arasında bekleyen satış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.perp.bands.0.5.n_included | number | — | Derinlik toplamına dahil edilen satırlar: güncel ve bant için eksiksiz olanlar. Derinlik değeriyle birlikte okuyun. bulunmayabilir |
| aggregate.perp.bands.0.5.n_fresh | number | — | Güncel satırlar. bulunmayabilir |
| aggregate.perp.bands.0.5.included_exchanges | array | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.perp.bands.0.5.included_exchanges[] | string | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.perp.bands.0.5.excluded_incomplete | array | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.perp.bands.0.5.excluded_incomplete[] | object | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.perp.bands.0.5.excluded_incomplete[].exchange | string | — | Borsa kimliği (küçük harf). bulunmayabilir |
| aggregate.perp.bands.0.5.excluded_incomplete[].symbol | string | — | CoinBoss'un depolama biçimindeki sözleşme sembolü. bulunmayabilir |
| aggregate.perp.bands.0.5.excluded_incomplete[].reach_bid_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak alış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.perp.bands.0.5.excluded_incomplete[].reach_ask_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak satış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.perp.bands.0.5.lower_bound_bid_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren alış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.perp.bands.0.5.lower_bound_ask_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren satış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.perp.bands.0.5.uses_aggregated_buckets | boolean | — | Dahil edilen bir satır fiyata göre birleştirilmiş dilimler kullandıysa true; bu durumda toplam bir alt sınır olur. bulunmayabilir |
| aggregate.spot | object | — | Spot emir defterleri üzerinden toplu değer; satır yoksa `null`. bulunmayabilir |
| aggregate.spot.n_rows | number | — | Eskimiş olanlar dahil bulunan satırlar. bulunmayabilir |
| aggregate.spot.n_fresh | number | — | Güncel satırlar. bulunmayabilir |
| aggregate.spot.mid_median | number | USD | Güncel satırların medyan orta fiyatı. bulunmayabilir |
| aggregate.spot.spread_bps_min | number | bp | Güncel satırlar arasındaki en dar spread. bulunmayabilir |
| aggregate.spot.bands | object | — | Bant bazında derinlik; `0.5`, `1` ve `2` anahtarları orta fiyata olan uzaklığın yüzde cinsinden değeridir. bulunmayabilir |
| aggregate.spot.bands.1 | object | — | Orta fiyata bu uzaklıktaki bant, yüzde cinsinden. bulunmayabilir |
| aggregate.spot.bands.1.bid_depth_usd | number | USD | Orta fiyat ile alt bant kenarı arasında bekleyen alış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.spot.bands.1.ask_depth_usd | number | USD | Orta fiyat ile üst bant kenarı arasında bekleyen satış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.spot.bands.1.n_included | number | — | Derinlik toplamına dahil edilen satırlar: güncel ve bant için eksiksiz olanlar. Derinlik değeriyle birlikte okuyun. bulunmayabilir |
| aggregate.spot.bands.1.n_fresh | number | — | Güncel satırlar. bulunmayabilir |
| aggregate.spot.bands.1.included_exchanges | array | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.spot.bands.1.included_exchanges[] | string | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.spot.bands.1.excluded_incomplete | array | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.spot.bands.1.excluded_incomplete[] | object | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.spot.bands.1.excluded_incomplete[].exchange | string | — | Borsa kimliği (küçük harf). bulunmayabilir |
| aggregate.spot.bands.1.excluded_incomplete[].symbol | string | — | CoinBoss'un depolama biçimindeki sözleşme sembolü. bulunmayabilir |
| aggregate.spot.bands.1.excluded_incomplete[].reach_bid_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak alış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.spot.bands.1.excluded_incomplete[].reach_ask_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak satış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.spot.bands.1.lower_bound_bid_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren alış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.spot.bands.1.lower_bound_ask_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren satış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.spot.bands.1.uses_aggregated_buckets | boolean | — | Dahil edilen bir satır fiyata göre birleştirilmiş dilimler kullandıysa true; bu durumda toplam bir alt sınır olur. bulunmayabilir |
| aggregate.spot.bands.2 | object | — | Orta fiyata bu uzaklıktaki bant, yüzde cinsinden. bulunmayabilir |
| aggregate.spot.bands.2.bid_depth_usd | number | USD | Orta fiyat ile alt bant kenarı arasında bekleyen alış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.spot.bands.2.ask_depth_usd | number | USD | Orta fiyat ile üst bant kenarı arasında bekleyen satış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.spot.bands.2.n_included | number | — | Derinlik toplamına dahil edilen satırlar: güncel ve bant için eksiksiz olanlar. Derinlik değeriyle birlikte okuyun. bulunmayabilir |
| aggregate.spot.bands.2.n_fresh | number | — | Güncel satırlar. bulunmayabilir |
| aggregate.spot.bands.2.included_exchanges | array | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.spot.bands.2.included_exchanges[] | string | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.spot.bands.2.excluded_incomplete | array | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.spot.bands.2.excluded_incomplete[] | object | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.spot.bands.2.excluded_incomplete[].exchange | string | — | Borsa kimliği (küçük harf). bulunmayabilir |
| aggregate.spot.bands.2.excluded_incomplete[].symbol | string | — | CoinBoss'un depolama biçimindeki sözleşme sembolü. bulunmayabilir |
| aggregate.spot.bands.2.excluded_incomplete[].reach_bid_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak alış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.spot.bands.2.excluded_incomplete[].reach_ask_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak satış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.spot.bands.2.lower_bound_bid_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren alış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.spot.bands.2.lower_bound_ask_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren satış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.spot.bands.2.uses_aggregated_buckets | boolean | — | Dahil edilen bir satır fiyata göre birleştirilmiş dilimler kullandıysa true; bu durumda toplam bir alt sınır olur. bulunmayabilir |
| aggregate.spot.bands.0.5 | object | — | Orta fiyata bu uzaklıktaki bant, yüzde cinsinden. bulunmayabilir |
| aggregate.spot.bands.0.5.bid_depth_usd | number | USD | Orta fiyat ile alt bant kenarı arasında bekleyen alış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.spot.bands.0.5.ask_depth_usd | number | USD | Orta fiyat ile üst bant kenarı arasında bekleyen satış emirlerinin nominal değeri. `complete` false olduğunda bir alt sınırdır. bulunmayabilir |
| aggregate.spot.bands.0.5.n_included | number | — | Derinlik toplamına dahil edilen satırlar: güncel ve bant için eksiksiz olanlar. Derinlik değeriyle birlikte okuyun. bulunmayabilir |
| aggregate.spot.bands.0.5.n_fresh | number | — | Güncel satırlar. bulunmayabilir |
| aggregate.spot.bands.0.5.included_exchanges | array | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.spot.bands.0.5.included_exchanges[] | string | — | Güncel verisi dahil edilen kaynaklar. bulunmayabilir |
| aggregate.spot.bands.0.5.excluded_incomplete | array | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.spot.bands.0.5.excluded_incomplete[] | object | — | Anlık görüntüsü bant kenarına ulaşmadığı için bandın dışında bırakılan güncel satırlar. bulunmayabilir |
| aggregate.spot.bands.0.5.excluded_incomplete[].exchange | string | — | Borsa kimliği (küçük harf). bulunmayabilir |
| aggregate.spot.bands.0.5.excluded_incomplete[].symbol | string | — | CoinBoss'un depolama biçimindeki sözleşme sembolü. bulunmayabilir |
| aggregate.spot.bands.0.5.excluded_incomplete[].reach_bid_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak alış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.spot.bands.0.5.excluded_incomplete[].reach_ask_pct | number | % | Orta fiyat ile anlık görüntüdeki en uzak satış seviyesi arasındaki uzaklık. bulunmayabilir |
| aggregate.spot.bands.0.5.lower_bound_bid_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren alış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.spot.bands.0.5.lower_bound_ask_usd | number | USD | Eksik satırların gözlemlenen kısmını da içeren satış derinliği. Bir tahmin değil, bir tabandır. bulunmayabilir |
| aggregate.spot.bands.0.5.uses_aggregated_buckets | boolean | — | Dahil edilen bir satır fiyata göre birleştirilmiş dilimler kullandıysa true; bu durumda toplam bir alt sınır olur. bulunmayabilir |
| coverage | object | — | Sayılara nelerin dahil olduğu ve nelerin olmadığı. Toplamları başka bir kaynakla karşılaştırmadan önce bunu karşılaştırın. |
| coverage.included_exchanges | array | — | Güncel verisi dahil edilen kaynaklar. |
| coverage.included_exchanges[] | string | — | Güncel verisi dahil edilen kaynaklar. |
| coverage.unavailable | array | — | Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar. bu tabloyu üretmek için kullanılan örneklerde boş |
| coverage.stale_excluded | array | — | Son güncellemesi güncellik penceresinin dışında kaldığı için hariç bırakılan satırlar. bu tabloyu üretmek için kullanılan örneklerde boş |
| coverage.no_market | array | — | Verisi toplanan ama bu coin için satırı bulunmayan borsa × piyasa çiftleri. bu tabloyu üretmek için kullanılan örneklerde boş |
| method | object | — | Bu yanıtta kullanılan formüllerin düz metin açıklaması; alan başına bir girdi. |
| method.mid | string | — | `mid` için formül notu, düz metin. |
| method.spread_bps | string | — | `spread_bps` için formül notu, düz metin. |
| method.bid_depth_usd | string | — | `bid_depth_usd` için formül notu, düz metin. |
| method.ask_depth_usd | string | — | `ask_depth_usd` için formül notu, düz metin. |
| method.complete | string | — | `complete` için formül notu, düz metin. |
| method.reach_pct | string | — | `reach_pct` için formül notu, düz metin. |
| method.slippage_bps | string | — | `slippage_bps` için formül notu, düz metin. |
| method.agg_step_bps | string | — | `agg_step_bps` için formül notu, düz metin. |
| method.aggregate | string | — | `aggregate` için formül notu, düz metin. |
| method.fresh | string | — | `fresh` için formül notu, düz metin. |
| method.lag_ms | string | — | `lag_ms` için formül notu, düz metin. |
| method.no_market | string | — | `no_market` için formül notu, düz metin. |
| meta | object | — | Bu yanıtın veri kökeni ve güncelliği. |
| meta.schema | string | — | Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir. |
| meta.source | array | — | Verinin toplandığı herkese açık kaynak uç noktaları. |
| meta.source[] | object | — | Verinin toplandığı herkese açık kaynak uç noktaları. |
| meta.source[].exchange | string | — | Borsa kimliği (küçük harf). |
| meta.source[].market | string | — | `perp` veya `spot`. |
| meta.source[].endpoint | string | — | Toplayıcının okuduğu kaynağın herkese açık uç noktası (veri kökeni için gösterilir; istemciler bunu hiçbir zaman çağırmaz). |
| meta.observed_at | number | ms | Kaynağın veri için verdiği zaman damgası. |
| meta.received_at | number | ms | CoinBoss toplayıcısının veriyi aldığı zaman. |
| meta.fetched_at | number | ms | Bu yanıtın oluşturulduğu zaman. |
| meta.window | string | — | Sayıların kapsadığı zaman penceresi. |
| meta.quality | string | — | Veri zaman damgalarına ve kapsama göre değerlendirilen FRESH, PARTIAL, STALE, BROKEN veya UNAVAILABLE. |
| meta.is_stale | boolean | — | Veri güncellik penceresinden eskiyse true. |
| meta.cache_ttl_s | number | s | Bu yanıtın önbellek ömrü. |
| meta.fallback | string | — | Toplayıcı veya bir kaynak başarısız olduğunda uç noktanın ne döndürdüğü. |
| meta.collector_heartbeat_age_s | number | s | Toplayıcının çalıştığını en son bildirmesinden bu yana geçen saniye. |
Üretilme zamanı: 2026-11-11 23:28 UTC; kaynak: 4 gerçek yanıt.
Örnek yanıt
/api/sd/liquidity?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 01:42:45 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: venues: 39 öğe içeriyordu; meta.source: 38 öğe içeriyordu; coverage.included_exchanges: 24 öğe içeriyordu; aggregate.perp.bands.1.included_exchanges: 18 öğe içeriyordu; aggregate.perp.bands.2.included_exchanges: 15 öğe içeriyordu; aggregate.spot.bands.1.included_exchanges: 12 öğe içeriyordu.
- "success"true
- "schema""coinboss.sd.liquidity/1"
- "now"1794534165206
- "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"1794534139451
- "received_at"1794534140026
- "fetched_at"1794534165206
- "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"5
Doğrulanmış örnekler
Yoklama, yukarıdaki örneğin yanı sıra bu uç noktayı aşağıdaki parametrelerle de çağırır ve her seferinde şemayı kontrol eder.
| Parametreler | HTTP | Yanıt süresi | Sonuç |
|---|---|---|---|
| coin=ETH&market=spot | 200 | 3 ms | Başarılı PARTIAL |
| coin=PEPE&market=perp | 200 | 3 ms | Başarılı FRESH |
| coin=SOL | 200 | 4 ms | Başarılı PARTIAL |
| — | 400 | 1 ms | Başarılı beklenen hatayı döndürür |
Kontrol: 2026-11-13 01:28:03 UTC
Ayrıntılar
- Kimlik doğrulama
- Yok. Herkese açık uç nokta.
- İstek sınırı
- IP başına dakikada 1200 istek
- Sunucu önbelleği
- 15s
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- En çok işlem gören coinler için 120 saniyede bir, geri kalanlar için 600 saniyede bir anlık görüntü alınır (birkaç borsada: 300 / 1200 saniye). Bir satır üç toplama dönemi boyunca, en az 300 saniye güncel sayılır.
- Pencere
- Sözleşme başına en güncel anlık görüntü.
- Veri kaynakları
- 24 borsanın (sürekli vadeli ve spot piyasalar) herkese açık REST emir defteri anlık görüntüleri; CoinBoss tarafından toplanır ve saklanır (sd_book_latest, sd_book_hist). Derinlik ve kayma, ham fiyat seviyelerinden CoinBoss tarafından hesaplanır.
- Borsa kapsamı
- 24 borsa, 38 borsa × piyasa hattı. Herkese açık bir anlık görüntü orta fiyatın ±0.5 / 1 / 2 % uzağına ulaşmıyorsa (borsanın seviye sınırı), o bant `complete: false` olarak işaretlenir, değeri bir alt sınırdır ve toplu değerin dışında bırakılır; `n_included` / `n_fresh` paydayı verir, `excluded_incomplete` ise dışarıda bırakılanları listeler.
- Sayfalama
- Sayfalama yok; her borsa × piyasa × sözleşme için bir satır.
- Sıralama
- Önce sürekli vadeli satırları, ardından spot; her birinin içinde ±1 % derinliğe (alış + satış) göre azalan.
- Birimler
- 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.
- Yöntem
- 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.
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Kararlı
- Kullanıma sunulma
- 2026-11-11
Canlı durum
KısmiKontrol: 2026-11-13 01:42:45 UTCHTTP 2005 msŞema eşleşiyorEn yeni veri noktası 25s öncesine ait
Uç nokta veri kalitesini PARTIAL olarak bildiriyor — En likit coinlerde birkaç büyük borsanın herkese açık anlık görüntüleri bandın tamamına ulaşmaz; bu yüzden söz konusu borsalar toplu değerin dışında bırakılır ve toplu değer toplam derinliği olduğundan düşük gösterir. `lower_bound_*` alanları gözlemlenen kısmı ekler. `n_included` değerini her zaman derinlik değeriyle birlikte okuyun.
Erişilebilirlik, son 30 gün
380 kontrolde başarı oranı: %100
Hatalar
Başarısız çağrılar tüm uç noktalarda aynı yapıyı paylaşır. Tam liste hatalar sayfasındadır. Hatalar ve istek sınırları →
| Kod | HTTP | Anlamı | Ne yapmalı |
|---|---|---|---|
| INVALID_PARAM | 400 | Zorunlu bir parametre eksik ya da bir değer kabul edilmiyor. Biliniyorsa `param` parametrenin adını verir. | Değiştirmeden yeniden denemeyin; isteği düzeltin. |
| UNAUTHORIZED | 401 | `CB-API-KEY` başlığı gönderildi, ancak anahtar bilinmiyor veya iptal edilmiş. Herkese açık veriler anahtar gerektirmez; başlığı kaldırın veya geçerli bir anahtar kullanın. | Değiştirmeden yeniden denemeyin. |
| FORBIDDEN | 403 | Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel). | Yeniden denemeyin. |
| NOT_FOUND | 404 | Bilinmeyen rota ya da istenen coin / borsa / fon yok. | Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin. |
| RATE_LIMITED | 429 | Dakika başına sınırdan fazla istek gönderildi. `Retry-After`, beklenecek saniye sayısını verir. | `Retry-After` süresi kadar bekleyin, ardından artan beklemeyle yeniden deneyin. |
| INTERNAL | 500 | Beklenmeyen sunucu hatası. Mesaj bilinçli olarak geneldir; hatayı bildirirken `request_id` değerini belirtin. | Birkaç saniye sonra bir kez yeniden deneyin; sorun sürerse istek kimliğiyle birlikte bildirin. |
| UPSTREAM_FAILED | 503 | Bu uç noktanın arkasındaki veri kaynağı zamanında yanıt vermedi. Yerine eskimiş veya ikame rakamlar döndürülmez. | Artan beklemeyle yeniden deneyin; durum sayfasını kontrol edin. |
| UNAVAILABLE | 501 / 503 | Veri kümesi geçici olarak hazır değil (önbellek ısınıyor) ya da uç noktanın henüz yasal bir herkese açık kaynağı yok. | Daha sonra yeniden deneyin; katalog, tasarım gereği mevcut olmayan uç noktaları işaretler. |
| REQUEST_FAILED | 200 | Bazı eski uç noktalar HTTP 200 ile `success: false` yanıtı verir. Yalnızca HTTP durumunu değil, her zaman `success` değerini de kontrol edin. | Mesaja bağlıdır; başarısız bir istek olarak ele alın. |
Deneyin
GET
/api/sd/liquidityKısmiParametreler
string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.
string · varsayılan all — Market type. Perpetual and spot books are never added together.
İstek URL'si
https://www.coinboss.com/api/sd/liquidity?coin=BTCBir uç nokta seçip “İstek gönder” düğmesine basın. Yanıt, başlıklar ve süre bilgisi burada görünür.
Bu kategoride daha fazlası
- Emir defteri derinliği ve kayma /api/sd/liquidity
- Emir defteri derinliği geçmişi /api/sd/liquidity/history
- Emir defteri derinliğine göre coin sıralaması /api/sd/liquidity/rank
- Bekleyen büyük emir izleme /api/indicators/large-orderbook