/api/liquidations/tradfi-symbol
GETKullanılabilir

Tek TradFi sembolü için likidasyon özeti

Tek TradFi sembolü için likidasyon özeti

GET/api/liquidations/tradfi-symbol

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
symbolstringZorunlu——TradFi sembolü (takma adlar kabul edilir); çözümlenemiyorsa 400; likidasyon geçmişi yoksa 404. Örnek: SNDK

Örnek istek

curl -s "https://www.coinboss.com/api/liquidations/tradfi-symbol?symbol=SNDK"

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
successboolean—İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur.
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
is_alias_inputboolean—İstenen `symbol`, farklı bir kanonik sembole eşlenen bir takma adsa true.
canonical_symbolstring—Bu dayanak varlığın tüm takma adlarının altında toplandığı kanonik sembol; `symbol` ile aynı değerdir.
merged_fromarray—Bu satırda birleştirilen kaynaklar.
merged_from[]string—Bu satırda birleştirilen kaynaklar.
display_namestring—Görünen ad.
contract_namestring—Bu dayanak varlığın tokenize sözleşmesi için kayıtlı ad; bilinen bir ad yoksa boş dize.
contract_typestring—`perpetual` veya `delivery`.
asset_classstring—`stock`, `index`, `commodity` veya `forex`.
subclassesarray—Bu sembolün likidasyon kayıtlarında bulunan farklı varlık alt sınıfı etiketleri.
subclasses[]string—Bir varlık alt sınıfı etiketi; ör. `common_stock` veya `unspecified`.
exchangesarray—Borsalar.
exchanges[]string—Borsalar.
dexesarray—Merkeziyetsiz borsalar.
dexes[]string—Merkeziyetsiz borsalar.
first_tsnumbermsZaman damgası.
last_tsnumbermsZaman damgası.
cnt_30dnumbercountBu sembol için son 30 gündeki likidasyon kaydı sayısı.
tierstring—`cnt_30d` değerine göre etkinlik kademesi: `T1` ≥ 1000, `T2` 200–999, `T3` 50–199, `T4` 10–49, 10'un altında `none`.
min_cnt_30dnumbercountBir sembolün sembol dizininde listelenmesi için gereken minimum 30 günlük likidasyon sayısı (10).
overviewobject—Genel bakış bloğu. dinamik anahtarlar: 1h,4h,12h,24h,7d,30d
overview.{*}object—Genel bakış bloğu.
overview.{*}.long_usdnumberUSDLong taraf.
overview.{*}.short_usdnumberUSDShort taraf.
overview.{*}.total_usdnumberUSDToplam.
overview.{*}.cntnumber—Adet.
class_evidencearray—Sembolün varlık sınıfı atamasının dayandığı en sık 3 kanıta kadar, en sık görüleni başta.
class_evidence[]object—Bir kanıt kaydı: `source`, `evidence` dizesi ve bunu taşıyan kayıt sayısı (`cnt`).
class_evidence[].sourcestring—Değerin nereden geldiği.
class_evidence[].evidencestring—Likidasyonla birlikte kaydedilen ham sınıflandırma kanıtı dizesi; ör. `desc:common_stock`.
class_evidence[].cntnumber—Adet.

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

Örnek yanıt

/api/liquidations/tradfi-symbol?symbol=SNDK · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:43 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: overview: 6 öğe içeriyordu; exchanges: 9 öğe içeriyordu.

  • {
    • "success": true,
    • "now": 1794542323216,
    • "symbol": "SNDK",
    • "is_alias_input": false,
    • "canonical_symbol": "SNDK",
    • "merged_from": [
      • "SNDK"
      ],
    • "display_name": "Sandisk",
    • "contract_name": "Sandisk",
    • "contract_type": "stock",
    • "asset_class": "stock",
    • "subclasses": [
      • "common_stock",
      • "unspecified"
      ],
    • "exchanges": [
      • "aster",
      • "binance",
      • "bitget",
      • "bybit",
      • "gate",
      • "htx",
      • "hyperliquid",
      • "lighter"
      ],
    • "dexes": [
      • "io",
      • "xyz"
      ],
    • "first_ts": 1781766257143,
    • "last_ts": 1794542028089,
    • "cnt_30d": 55476,
    • "tier": "T1",
    • "min_cnt_30d": 10,
    • "overview": {
      • "1h": { … 4 },
      • "4h": { … 4 }
      },
    • "class_evidence": [
      • { … 3 }
      ]
    }

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
tek sembol için 1 saat, 4 saat, 12 saat, 24 saat, 7 gün, 30 günlük kayan pencereler
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
Birimler
USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated
Yöntem
per window: long_usd, short_usd, total_usd = SUM(value_usd), cnt; tier from the 30-day event count (T1 >= 1000, T2 200-999, T3 50-199, T4 10-49, none < 10)
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:58:43 UTCHTTP 200866 msŞema eşleşiyorEn yeni veri noktası 5m ö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/liquidations/tradfi-symbolKullanılabilir
Parametreler

string — TradFi symbol (aliases accepted); 400 if it cannot be resolved; 404 when no liquidation history.

İstek URL'sihttps://www.coinboss.com/api/liquidations/tradfi-symbol?symbol=SNDK
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.