TradFi sürekli vadeli sözleşmeleri için likidasyon özeti
TradFi sürekli vadeli sözleşmeleri için likidasyon özeti (hisse / endeks / emtia / forex)
/api/liquidations/tradfiİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| range | string | İsteğe bağlı | 24h | 1h, 4h, 12h, 24h | Zaman penceresi. Örnek: 24h |
| class | string | İsteğe bağlı | stock | stock, index, commodity, forex | Varlık sınıfı; bilinmeyen değer 400 döndürür. Örnek: stock |
| limit | integer | İsteğe bağlı | 30 | ≤ 100 | Döndürülecek satır sayısı. |
Örnek istek
curl -s "https://www.coinboss.com/api/liquidations/tradfi?class=stock&range=24h"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. |
| range | string | — | İstenen pencere. |
| class | string | — | Varlık sınıfı. |
| overview | object | — | Genel bakış bloğu. |
| overview.long_usd | number | USD | Long taraf. |
| overview.short_usd | number | USD | Short taraf. |
| overview.total_usd | number | USD | Toplam. |
| overview.cnt | number | — | Adet. |
| byClass | object | — | İstenen `range` boyunca varlık sınıfı bazında likidasyon toplamları; `class` filtresinden bağımsız olarak kripto dışı tüm sınıfları kapsar. dinamik anahtarlar: stock,commodity,index,unknown,forex |
| byClass.{*} | object | — | Bir varlık sınıfının toplamları; anahtarlar sınıf adlarıdır (`stock`, `commodity`, `index`, `forex`, `unknown`), her birinde `total_usd` ve `cnt` bulunur. |
| byClass.{*}.total_usd | number | USD | Toplam. |
| byClass.{*}.cnt | number | — | Adet. |
| assets | array | — | Varlıklar. |
| assets[] | object | — | Varlıklar. |
| assets[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| assets[].dex | null | — | Merkeziyetsiz borsa (HIP-3 deployer'ı veya DEX kimliği). |
| assets[].dexes | array | — | Merkeziyetsiz borsalar. bu tabloyu üretmek için kullanılan örneklerde boş |
| assets[].dexes[] | string | — | Merkeziyetsiz borsalar. |
| assets[].merged_from | array | — | Bu satırda birleştirilen kaynaklar. |
| assets[].merged_from[] | string | — | Bu satırda birleştirilen kaynaklar. |
| assets[].display_name | string|null | — | Görünen ad. |
| assets[].long_usd | number | USD | Long taraf. |
| assets[].short_usd | number | USD | Short taraf. |
| assets[].total_usd | number | USD | Toplam. |
| assets[].cnt | number | — | Adet. |
| largest | array | — | En büyük kayıtlar. |
| largest[] | object | — | En büyük kayıtlar. |
| largest[].exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| largest[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| largest[].src_symbol | string | — | Kaynaktaki sembol. |
| largest[].raw_symbol | string | — | Borsanın yazdığı biçimiyle birebir sembol. |
| largest[].dex | string|null | — | Merkeziyetsiz borsa (HIP-3 deployer'ı veya DEX kimliği). |
| largest[].side | string | — | Likide edilen pozisyonun yönü (`long` = bir long pozisyon likide edildi). |
| largest[].price | string(decimal) | — | Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT). |
| largest[].qty | string(decimal) | — | Miktar. |
| largest[].value_usd | string(decimal) | USD | Likidasyonun nominal değeri. |
| largest[].timestamp | number | ms | Zaman damgası. |
| largest[].liq_user | string|null | — | Likide edilen hesabın adresi; yalnızca Hyperliquid zincir üstü likidasyonlarında mevcuttur, diğer borsalarda null. |
| chart | array | — | Grafik serisi. |
| chart[] | object | — | Grafik serisi. |
| chart[].bucket | number | ms | Zaman diliminin başlangıcı. |
| chart[].side | string | — | Likide edilen pozisyonun yönü (`long` = bir long pozisyon likide edildi). |
| chart[].total_usd | number | USD | Toplam. |
| sources | array | — | Veri kaynakları. |
| sources[] | object | — | Veri kaynakları. |
| sources[].exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| sources[].dex | string|null | — | Merkeziyetsiz borsa (HIP-3 deployer'ı veya DEX kimliği). |
| sources[].total_usd | number | USD | Toplam. |
| sources[].cnt | number | — | Adet. |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/liquidations/tradfi?class=stock&range=24h · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:53:13 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: chart: 50 öğe içeriyordu; assets: 30 öğe içeriyordu; byClass: 5 öğe içeriyordu; largest: 10 öğe içeriyordu; sources: 11 öğe içeriyordu.
- "success"true
- "range""24h"
- "class""stock"
- "overview"
- "long_usd"56679502.76
- "short_usd"35273566.23
- "total_usd"91953068.99
- "cnt"20168
- "byClass"
- "stock"
- "index"
- "assets"
- "largest"
- "chart"
- "sources"
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
- 20s
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- gerçek zamanlı (borsa WebSocket iletimi); REST sorgulaması: okx 15 s'de bir, gate 25 s'de bir, htx 5 dakikada bir; hyperliquid düğümünün işlem gerçekleşmesi yığınları 5 s'de bir alınır
- Pencere
- range parametresi: 1h | 4h | 12h | 24h (varsayılan 24h); grafik dilimi aralık <= 4 saat ise 15 dakika, aksi hâlde 1 saat
- Veri kaynakları
- Kripto dışı sürekli vadeli sözleşmelerin (tokenize hisseler, endeksler, emtialar, FX) likidasyonları; 10 borsadaki (ör. binance, okx, hyperliquid, gate, bybit, bitget) aynı kurum içi borsa likidasyon toplayıcılarınca yakalanır ve bir varlık sınıfı sınıflandırıcısıyla ayrılır.
- Borsa kapsamı
- son 30 günde gözlemlenen 10 borsa (binance, okx, hyperliquid, gate, bybit, bitget, lighter, aster, htx, bitfinex); varlık sınıfları stock / index / commodity / forex (küçük bir pay 'unknown' olarak sınıflandırılır); geçmiş 2026-06-17'de başlar
- Sayfalama
- varlık listesi için limit (varsayılan 30, en çok 100)
- Sıralama
- varlıklar total_usd'ye göre azalan
- Birimler
- USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated
- Yöntem
- overview / byClass / per-asset totals = SUM(value_usd) by side; 10 largest orders; per-source (exchange) totals
- 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
408 kontrolde başarı oranı: %99.75
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/liquidations/tradfiKullanılabilirstring · varsayılan 24h — Time window.
string · varsayılan stock — Asset class; unknown value returns 400.
integer · varsayılan 30 · en çok 100 — Number of rows to return.
https://www.coinboss.com/api/liquidations/tradfi?range=24h&class=stockBu kategoride daha fazlası
- TradFi sürekli vadeli sözleşmeleri için likidasyon özeti /api/liquidations/tradfi
- Pencerede likidasyonu olan TradFi sembollerinin listesi /api/liquidations/tradfi-asset-list
- TradFi sürekli vadeli sözleşmeleri için sembol bazında likidasyon sıralaması /api/liquidations/tradfi-assets
- TradFi sürekli vadeli sözleşmeleri için borsa bazında likidasyon dağılımı /api/liquidations/tradfi-exchanges
- TradFi sürekli vadeli sözleşmeleri için likidasyon akışı /api/liquidations/tradfi-feed
- TradFi sürekli vadeli sözleşmelerinde en büyük likidasyon emirleri /api/liquidations/tradfi-largest
- TradFi sürekli vadeli sözleşmeleri için çok pencereli likidasyon toplamları /api/liquidations/tradfi-overview
- Tek TradFi sembolü için likidasyon özeti /api/liquidations/tradfi-symbol
- Tek TradFi sembolü için likidasyon zaman serisi /api/liquidations/tradfi-symbol-chart
- Tek TradFi sembolü için borsa bazında likidasyon dağılımı /api/liquidations/tradfi-symbol-exchanges
- Tek TradFi sembolü için en büyük likidasyonlar /api/liquidations/tradfi-symbol-largest
- Likidasyon geçmişi olan TradFi sembolleri /api/liquidations/tradfi-symbols
- TradFi likidasyon tablosu /api/liquidations/tradfi-table
- TradFi sürekli vadeli sözleşmeleri için toplam likidasyon zaman serisi /api/liquidations/tradfi-total-chart
- Pre-IPO sözleşme kotasyonları /api/preipo/list
- Hisse dayanak varlık listesi /api/stock-detail-list
- Hisse dayanak varlık ayrıntısı /api/stock-detail/:underlying
- Hisse enstrüman listesi /api/stocks/list
- Borsalarda listelenen hisse sürekli vadeli sözleşmeleri / tokenize hisseler /api/tabs17/exchange-stocks
- Kriptoyla ilişkili hisse senedi kotasyonları /api/tabs17/stocks