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

Uygulama

Dil ▾

₺ TRY ▾

/api/sd/liquidity/history

GETKısmiFRESH

Emir defteri derinliği geçmişi

Bir coin için tek bir bant içindeki toplu alış ve satış derinliğinin zaman serisi; kapsanan tüm borsalar ya da tek bir borsa için. Her nokta kaç sözleşme içerdiğini belirtir.

GET/api/sd/liquidity/history

Kısmi kapsam. Toplama 2026-11-11'de başladı; bu nedenle daha uzun aralıklar zamanla dolar. Eksik dilimler yer almaz, enterpolasyonla doldurulmaz; iki nokta arasında `n_included` değerinin değişmesi, katkıda bulunan sözleşme kümesinin değiştiği anlamına gelir.

İ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ı	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.
range	string	İsteğe bağlı	24h	24h, 7d, 30d	Geriye dönük aralık: 24h (30 dakikalık noktalar), 7d (2 saatlik noktalar) veya 30d (6 saatlik noktalar).
exchange	string	İsteğe bağlı	—	—	Bu piyasa için kapsanan tek bir borsa kimliği (örneğin `gate`). Varsayılan: tüm borsalar. Kapsanmayan bir borsa 400 döndürür.

Örnek istek

curl -s "https://www.coinboss.com/api/sd/liquidity/history?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`.
band_pct	number	%	Seçilen bant: orta fiyata olan uzaklık.
range	string	—	Uygulanan geriye dönük aralık.
exchange	string\|null	—	Borsa kimliği (küçük harf).
interval_s	number	s	Noktalar arasındaki aralık.
points	array	—	Seri noktaları, en eskiden başlayarak.
points[]	object	—	Seri noktaları, en eskiden başlayarak.
points[].t	number	ms	Zaman diliminin başlangıcı.
points[].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.
points[].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.
points[].n_included	number	—	Derinlik toplamına dahil edilen satırlar: güncel ve bant için eksiksiz olanlar. Derinlik değeriyle birlikte okuyun.
points[].n_rows	number	—	Eskimiş olanlar dahil bulunan satırlar.
points[].mid	number	USD	(en iyi alış + en iyi satış) ÷ 2, bir coinin fiyatı.
points[].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.
points_expected	number	—	Aralığın eksiksiz olduğunda içerdiği nokta sayısı.
first_t	number	ms	Döndürülen ilk noktanın zamanı.
last_t	number	ms	Döndürülen son noktanın zamanı.
exchange_points	object	—	Her borsanın yer aldığı nokta sayısı (anahtar, borsa kimliğidir). dinamik anahtarlar: deribit,aster,backpack,bitfinex,bitget,bitunix
exchange_points.{*}	number	—	Her borsanın yer aldığı nokta sayısı (anahtar, borsa kimliğidir).
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ş
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.history	string	—	`history` için formül notu, düz metin.
method.exchange_points	string	—	`exchange_points` 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	null	—	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/history?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 04:02:45 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: points: 48 öğe içeriyordu; meta.source: 19 öğe içeriyordu; exchange_points: 19 öğe içeriyordu; coverage.included_exchanges: 19 öğe içeriyordu.

{
- "success": true,
- "schema": "coinboss.sd.liquidity/1",
- "now": 1794542565889,
- "coin": "BTC",
- "market": "perp",
- "band_pct": 1,
- "range": "24h",
- "exchange": null,
- "interval_s": 1800,
- "points": [
  - { … 7 },
  - { … 7 }
  ],
- "points_expected": 48,
- "first_t": 1794457800000,
- "last_t": 1794542400000,
- "exchange_points": {
  - "deribit": 96,
  - "aster": 48
  },
- "coverage": {
  - "included_exchanges": [ … 8 ],
  - "unavailable": [],
  - "stale_excluded": []
  },
- "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…",
  - "history": "sd_book_hist keeps the first snapshot of every 15-minute bucket per contract; each returned point takes, per contract, the first stored snapshot inside the poin…",
  - "exchange_points": "number of returned points in which each exchange had a row that was complete for the band; a changing venue set moves the aggregate, so compare n_included acros…"
  },
- "meta": {
  - "schema": "coinboss.sd.liquidity/1",
  - "source": [ … 2 ],
  - "observed_at": null,
  - "received_at": 1794542400000,
  - "fetched_at": 1794542565889,
  - "window": "24h",
  - "quality": "FRESH",
  - "is_stale": false,
  - "cache_ttl_s": 120,
  - "fallback": "history is append-only (first snapshot of each 15-minute bucket per contract, 30-day retention); buckets the collector missed are simply absent, never interpola…",
  - "collector_heartbeat_age_s": 3
  }
}

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ç
band=2&coin=ETH&market=spot	200	6 ms	Başarılı FRESH
coin=SOL&exchange=gate	200	2 ms	Başarılı FRESH
band=3&coin=BTC	400	1 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: 2m
Edge mikro önbelleği: 10s
Güncelleme sıklığı: Sözleşme başına 15 dakikada bir anlık görüntü saklanır; her nokta kendi dilimindeki en erken anlık görüntüyü kullanır (ortalama değil, belirli bir andaki değer).
Pencere: 24h / 7d / 30d.
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; `range` nokta sayısını sınırlar (48 / 84 / 120).
Sıralama: Zaman, artan.
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:45 UTCHTTP 20012 msŞema eşleşiyorEn yeni veri noktası 3m öncesine ait

Toplama 2026-11-11'de başladı; bu nedenle daha uzun aralıklar zamanla dolar. Eksik dilimler yer almaz, enterpolasyonla doldurulmaz; iki nokta arasında `n_included` değerinin değişmesi, katkıda bulunan sözleşme kümesinin değiştiği anlamına gelir.

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/historyKısmi

Parametreler

coin Zorunlu

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

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.

range

string · varsayılan 24h — Look-back range: 24h (30-minute points), 7d (2-hour points) or 30d (6-hour points).

exchange

string — One exchange id covered for this market (for example `gate`). Default: all exchanges. An exchange that is not covered returns 400.

İstek URL'sihttps://www.coinboss.com/api/sd/liquidity/history?coin=BTC

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