24s Hacim—Açık pozisyon—24s Likidasyon$1.36B24s Long/Short—BTC Hakimiyeti—ETH Hakimiyeti—
Uygulama
Dil ▾
₺ TRY ▾
/api/liq-map
GETKullanılabilir

Likidasyon haritası

Likidasyon haritası (fiyat seviyesi ve kaldıraca göre tahmini likidasyon büyüklüğü)

GET/api/liq-map

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
symbolstringİsteğe bağlıBTC—Coin sembolü; veri yoksa 404. Örnek: BTC
rangestringİsteğe bağlı1d1d, 7dZaman penceresi. Örnek: 1d

Örnek istek

curl -s "https://www.coinboss.com/api/liq-map?symbol=BTC&range=1d"

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.

AlanTürBirimAçıklama
symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
rangestring—İstenen pencere.
updatedAtnumbermsVerinin en son güncellendiği zaman.
currentPricenumber—Güncel fiyat.
binWidthnumberUSDBir fiyat diliminin genişliği: eksen `currentPrice` çevresinde ±10 % (`1d`) veya ±18 % (`7d`) aralığını kapsar ve 200 dilime bölünür.
leveragesarray—Modelin pozisyonları dağıttığı kaldıraç kademeleri, artan sırada (10, 25, 50, 100).
leverages[]numberxBir kademenin kaldıraç katı; `bins[].tiers` içinde anahtar olarak kullanılır.
binsarray—Haritanın artan fiyat sırasındaki 200 fiyat dilimi; borsa verisi değil, model tahminidir.
bins[]object—Bir fiyat dilimi: orta `price`, `side` (güncel fiyatın altında `long`, güncel fiyatta veya üstünde `short`), kaldıraç bazında `tiers` ve bunların `total` değeri.
bins[].pricenumber—Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT).
bins[].sidestring—`long` / `short` veya `buy` / `sell`.
bins[].tiersobject—Büyüklük kademeleri.
bins[].tiers.10numberUSDBu fiyat diliminde 10x kaldıraçla açılan pozisyonlardan kaynaklanan modellenmiş likidasyon nominal değeri; tutar sıfırsa anahtar bulunmaz. bulunmayabilir
bins[].totalnumber—Toplam.
bins[].tiers.25numberUSDBu fiyat diliminde 25x kaldıraçla açılan pozisyonlardan kaynaklanan modellenmiş likidasyon nominal değeri; tutar sıfırsa anahtar bulunmaz. bulunmayabilir
cumarray—`bins` ile indeks indeks hizalanmış kümülatif eğri.
cum[]numberUSDGüncel fiyattan bu dilime kadar biriken modellenmiş likidasyon nominal değeri (alttaki dilimler için aşağı doğru, üstteki dilimler için yukarı doğru).
maxBinnumberUSDHaritadaki en büyük `bins[].total` değeri; grafik eksenini ölçeklemek için kullanılabilir.
totalLongnumber—Toplam long.
totalShortnumber—Toplam short.
actualLiq24hnumberUSDCoinde son 24 saatte fiilen likide edilen nominal değer (long + short, kaydedilmiş likidasyon emirleri); modelle karşılaştırma içindir.

Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 3 gerçek yanıt.

Örnek yanıt

/api/liq-map?symbol=BTC&range=1d · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:52:47 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: cum: 200 öğe içeriyordu; bins: 200 öğe içeriyordu.

  • {
    • "symbol": "BTC",
    • "range": "1d",
    • "updatedAt": 1794541891278,
    • "currentPrice": 69059.1,
    • "binWidth": 69.0591,
    • "leverages": [
      • 10,
      • 25,
      • 50,
      • 100
      ],
    • "bins": [
      • { … 4 },
      • { … 4 }
      ],
    • "cum": [
      • 181751104,
      • 181751104,
      • 181751104,
      • 181751104,
      • 165607035,
      • 165607035,
      • 165607035,
      • 165607035
      ],
    • "maxBin": 22547138,
    • "totalLong": 181751104,
    • "totalShort": 232458129,
    • "actualLiq24h": 745954159
    }

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.

ParametrelerHTTPYanıt süresiSonuç
range=1d&symbol=ETH2001 msBaşarılı
range=1d&symbol=SOL2001 msBaşarılı

Kontrol: 2026-11-13 03:28:04 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
60s
Edge mikro önbelleği
10s
Güncelleme sıklığı
ilk 100 coin için 5 dakikada bir; 101-300. sıralardaki coinler kademeli 5 grup hâlinde yenilenir (yaklaşık 25 dakikada bir)
Pencere
range parametresi: 1d | 7d (pozisyonların son 1 veya 7 günde açıldığı varsayılır); en güncel model anlık görüntüsü
Veri kaynakları
CoinBoss'un kendi saatlik vadeli mum verilerinden (binance, yedek okx), toplam açık pozisyon geçmişinden ve toplanan likidasyonlardan kurum içinde hesaplanan model tahmini.
Borsa kapsamı
vadeli nominal hacme göre sıralanan en çok 300 kripto coin; son 7 günde >= 30 likidasyon olayı gerekir; tokenize hisseler, emtialar, FX ve endeksler hariç tutulur; tahminler model çıktısıdır, borsanın bildirdiği likidasyon seviyeleri değildir
Birimler
estimated liquidation notional in USD per price level; prices in USD; timestamps in Unix ms
Yöntem
each 1 h candle opens notional proportional to volume x close (boosted by OI increase), spread over leverage tiers; long liq price ~ P x (1 - 1/L + MMR), short ~ P x (1 + 1/L - MMR); levels swept by later candles are cleared; output = cumulative long/short liquidation notional by price and leverage tier
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı

Canlı durum

KullanılabilirKontrol: 2026-11-13 03:52:47 UTCHTTP 2002 msŞema eşleşiyorEn yeni veri noktası 76s öncesine ait

Erişilebilirlik, son 30 gün

409 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ı →

KodHTTPAnlamıNe yapmalı
INVALID_PARAM400Zorunlu 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.
UNAUTHORIZED401`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.
FORBIDDEN403Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel).Yeniden denemeyin.
NOT_FOUND404Bilinmeyen rota ya da istenen coin / borsa / fon yok.Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin.
RATE_LIMITED429Dakika 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.
INTERNAL500Beklenmeyen 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_FAILED503Bu 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.
UNAVAILABLE501 / 503Veri 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_FAILED200Bazı 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/liq-mapKullanılabilir
Parametreler

string · varsayılan BTC — Coin symbol; 404 when no data.

string · varsayılan 1d — Time window.

İstek URL'sihttps://www.coinboss.com/api/liq-map?symbol=BTC&range=1d
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.