24s Hacim—Açık pozisyon—24s Likidasyon$1.36B 24s Long/Short—BTC Hakimiyeti—ETH Hakimiyeti—

Uygulama

Dil ▾

₺ TRY ▾

/api/sd/liquidity/rank

GETKısmiPARTIAL

Emir defteri derinliğine göre coin sıralaması

Tek bir bant içindeki toplu emir defteri derinliğine (alış + satış) göre sıralanmış coinler; dahil edilen sözleşme sayısı ve en dar spread ile birlikte.

GET/api/sd/liquidity/rank

İstek

Sorgu parametreleri

Ad	Tür	Zorunlu	Varsayılan	İzin verilen değerler	Açıklama
market	string	İsteğe bağlı	perp	perp, spot	Piyasa türü. Sürekli vadeli ve spot emir defterleri hiçbir zaman birbirine eklenmez.
band	string	İsteğe bağlı	1	0.5, 1, 2	Orta fiyata olan uzaklık, yüzde cinsinden.
limit	integer	İsteğe bağlı	50	≥ 1 · ≤ 200	Satır sayısı.

Örnek istek

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

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ı.
market	string	—	`perp` veya `spot`.
band_pct	number	%	Seçilen bant: orta fiyata olan uzaklık.
limit	number	—	Uygulanan satır sınırı.
total_coins	number	—	En az bir emir defteri satırı olan coinler.
rows	array	—	Coin başına bir satır.
rows[]	object	—	Coin başına bir satır.
rows[].coin	string	—	Coin sembolü (büyük harf).
rows[].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.
rows[].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.
rows[].total_depth_usd	number	USD	Bandın alış derinliği + satış derinliği; yalnızca sıralama anahtarı olarak kullanılır.
rows[].n_included	number	—	Derinlik toplamına dahil edilen satırlar: güncel ve bant için eksiksiz olanlar. Derinlik değeriyle birlikte okuyun.
rows[].n_fresh	number	—	Güncel satırlar.
rows[].n_rows	number	—	Eskimiş olanlar dahil bulunan satırlar.
rows[].mid_median	number	USD	Güncel satırların medyan orta fiyatı.
rows[].spread_bps_min	number	bp	Güncel satırlar arasındaki en dar spread.
rows[].included_exchanges	array	—	Güncel verisi dahil edilen kaynaklar.
rows[].included_exchanges[]	string	—	Güncel verisi dahil edilen kaynaklar.
rows[].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.
rows[].rank	number	—	Sıralamadaki konum; satırın sıralanacak bir değeri yoksa `null`.
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.
coverage.stale_excluded[]	object	—	Son güncellemesi güncellik penceresinin dışında kaldığı için hariç bırakılan satırlar.
coverage.stale_excluded[].exchange	string	—	Borsa kimliği (küçük harf).
coverage.stale_excluded[].age_s	number	s	Satırın alınmasından bu yana geçen saniye.
coverage.n_fresh_rows	number	—	Tüm coinlerdeki güncel satırlar.
coverage.n_stale_rows	number	—	Tüm coinlerdeki eskimiş satırlar.
coverage.n_incomplete_rows	number	—	Anlık görüntüsü bant kenarına ulaşmayan güncel satırlar.
method	object	—	Bu yanıtta kullanılan formüllerin düz metin açıklaması; alan başına bir girdi.
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.aggregate	string	—	`aggregate` için formül notu, düz metin.
method.fresh	string	—	`fresh` için formül notu, düz metin.
method.rank	string	—	`rank` 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:00 UTC; kaynak: 3 gerçek yanıt.

Örnek yanıt

/api/sd/liquidity/rank · Gerçek yanıt, yakalanma zamanı: 2026-11-13 04:02:46 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: rows: 50 öğe içeriyordu; meta.source: 23 öğe içeriyordu; coverage.stale_excluded: 23 öğe içeriyordu; rows[].included_exchanges: 19 öğe içeriyordu; coverage.included_exchanges: 23 öğe içeriyordu.

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

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ç
market=spot	200	5 ms	Başarılı PARTIAL
band=0.5&limit=10	200	7 ms	Başarılı PARTIAL
limit=0	400	2 ms	Başarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 03:58:06 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: 30s
Edge mikro önbelleği: 10s
Güncelleme sıklığı: `/api/sd/liquidity` ile aynı toplama döngüsü.
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; `limit` satır sayısını sınırlar (en çok 200).
Sıralama: `total_depth_usd`, azalan; eksiksiz ve güncel hiçbir satırı olmayan coinler `rank: null` ile en sonda gelir.
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.
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 04:02:46 UTCHTTP 2009 msŞema eşleşiyorEn yeni veri noktası 0s öncesine ait

Uç nokta veri kalitesini PARTIAL olarak bildiriyor

Erişilebilirlik, son 30 gün

408 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/liquidity/rankKısmi

Parametreler

market

string · varsayılan perp — Market type. Perpetual and spot books are never added together.

band

string · varsayılan 1 — Distance from mid price in percent.

limit

integer · varsayılan 50 · en az 1 · en çok 200 — Number of rows.

İstek URL'sihttps://www.coinboss.com/api/sd/liquidity/rank

Bir 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.

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