Likidasyon kümesi seviyeleri
Likidasyon kümesi seviyeleri
/api/liq-levelsİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| symbol | string | İsteğe bağlı | — | — | Coin sembolü; belirtilmezse tümü. |
| limit | integer | İsteğe bağlı | 100 | ≤ 200 | Döndürülecek satır sayısı. Örnek: 100 |
Örnek istek
curl -s "https://www.coinboss.com/api/liq-levels?limit=100"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. |
| count | number | — | Öğe sayısı. |
| data | array | — | Veri yükü. |
| data[] | object | — | Veri yükü. |
| data[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| data[].price | number | — | Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT). |
| data[].updatedAt | number | ms | Verinin en son güncellendiği zaman. |
| data[].tiers | object | — | Büyüklük kademeleri. dinamik anahtarlar: 10,25,50,100 |
| data[].tiers.{*} | object | — | Büyüklük kademeleri. |
| data[].tiers.{*}.longPrice | number | USD | Güncel `price` üzerinden bu kaldıraçla açılan bir long'un tahmini likidasyon fiyatı: `price` × (1 − 1 ÷ kaldıraç + 0.004); anahtarlar kaldıraç katlarıdır. |
| data[].tiers.{*}.longIntensity | number | USD | 1 günlük likidasyon haritasında `longPrice` değerinin ±0.6 % çevresindeki modellenmiş likidasyon nominal değeri; borsa verisi değil, model tahminidir. |
| data[].tiers.{*}.shortPrice | number | USD | Güncel `price` üzerinden bu kaldıraçla açılan bir short'un tahmini likidasyon fiyatı: `price` × (1 + 1 ÷ kaldıraç − 0.004); anahtarlar kaldıraç katlarıdır. |
| data[].tiers.{*}.shortIntensity | number | USD | 1 günlük likidasyon haritasında `shortPrice` değerinin ±0.6 % çevresindeki modellenmiş likidasyon nominal değeri; borsa verisi değil, model tahminidir. |
| data[].totalLong | number | — | Toplam long. |
| data[].totalShort | number | — | Toplam short. |
| data[].liqLong24h | number | USD | İzlenen tüm borsalarda son 24 saatte fiilen likide edilen long pozisyonların nominal değeri (kaydedilmiş likidasyon emirleri; model değeri değildir). |
| data[].liqShort24h | number | USD | İzlenen tüm borsalarda son 24 saatte fiilen likide edilen short pozisyonların nominal değeri (kaydedilmiş likidasyon emirleri; model değeri değildir). |
| data[].oiUsd | number | USD | Açık pozisyon. |
| data[].volUsd | number | USD | Hacim. |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/liq-levels?limit=100 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 01:47:45 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data: 100 öğe içeriyordu; data[].tiers: 4 öğe içeriyordu.
- "success"true
- "count"100
- "data"
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
- en güncel model anlık görüntüsü (likidasyon haritasından türetilir)
- 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
- Sayfalama
- limit (varsayılan 100, en çok 200)
- Sıralama
- vol_usd, azalan
- Birimler
- estimated liquidation notional in USD per price level; prices in USD; timestamps in Unix ms
- Yöntem
- per coin: estimated long / short liquidation notional per leverage tier and totals, derived from the liquidation-map book
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Kararlı
Canlı durum
Erişilebilirlik, son 30 gün
384 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
/api/liq-levelsKullanılabilirstring — Coin symbol; omitted = all.
integer · varsayılan 100 · en çok 200 — Number of rows to return.
https://www.coinboss.com/api/liq-levels?limit=100Bu kategoride daha fazlası
- Likidasyon ısı haritası (model 1) /api/heatmap
- Likidasyon ısı haritasının desteklediği semboller /api/heatmap/symbols
- Likidasyon ısı haritası (model 2 / 3) /api/liq-heatmap
- Likidasyon ısı haritası modelinin desteklediği semboller /api/liq-heatmap/symbols
- Likidasyon kümesi seviyeleri /api/liq-levels
- Likidasyon haritası /api/liq-map
- Likidasyon haritasının desteklediği semboller /api/liq-map/symbols
- Likidasyon maksimum acı seviyeleri /api/liq-maxpain