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

Tek coin için borsalara ve türlere göre long/short oranları

Tek coin için borsalara ve türlere göre long/short oranları

GET/api/ls/coin
Coinin katları cinsinden kote edilen sözleşmeler (örneğin `1000PEPE`) temel coinle eşleştirilir. Hiçbir borsanın long/short oranı yayımlamadığı coinler boş liste döndürür.

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
basestringZorunlu——Temel coin sembolü (büyük harf, ör. BTC). Örnek: BTC

Örnek istek

curl -s "https://www.coinboss.com/api/ls/coin?base=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.

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.
basestring—Temel varlık sembolü.
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
pricenumber—Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT).
exchange_countnumber—Borsa sayısı.
exchangesarray—Borsalar.
exchanges[]string—Borsalar.
typesarray—Türler.
types[]string—Türler.
accountobject—Hesap bazlı ölçü. dinamik anahtarlar: binance,okx,bybit,bitget,gate,kraken
account.{*}object—Hesap bazlı ölçü.
account.{*}.longnumber—Long payı.
account.{*}.shortnumber—Short payı.
account.{*}.rationumber—Long payının short payına bölümü (1 = dengeli).
topaccobject—Borsa bazında, hesap sayısına göre üst düzey trader long/short oranı; anahtarlar borsa kimlikleridir, her birinde `long` %, `short` % ve `ratio` (long ÷ short) bulunur. dinamik anahtarlar: binance,htx
topacc.{*}object—Bir borsa: üst düzey trader hesaplarının yüzde cinsinden `long` ve `short` payları ile `ratio` = long ÷ short; anahtar borsa kimliğidir.
topacc.{*}.longnumber—Long payı.
topacc.{*}.shortnumber—Short payı.
topacc.{*}.rationumber—Long payının short payına bölümü (1 = dengeli).
positionobject—Borsa bazında, pozisyon büyüklüğüne göre long/short oranı (Binance, Gate ve HTX'te üst düzey trader'ların pozisyonları); anahtarlar borsa kimlikleridir. dinamik anahtarlar: binance,bitget,gate,htx,okx
position.{*}object—Bir borsa: yüzde cinsinden `long` ve `short` payları ile `ratio` = long ÷ short; anahtar borsa kimliğidir.
position.{*}.longnumber—Long payı.
position.{*}.shortnumber—Short payı.
position.{*}.rationumber—Long payının short payına bölümü (1 = dengeli).
takerobject—Taker alış / satış ölçüsü. dinamik anahtarlar: binance,bitget,gate,okx
taker.{*}object—Taker alış / satış ölçüsü.
taker.{*}.longnumber—Long payı.
taker.{*}.shortnumber—Short payı.
taker.{*}.rationumber—Long payının short payına bölümü (1 = dengeli).
avg_rationumberratio`account` türünün borsa bazındaki `ratio` değerlerinin basit ortalaması; hiçbir borsa bildirmiyorsa null.
avg_longnumber%`account` içindeki borsalar üzerinden long hesap payının basit ortalaması.
avg_shortnumber%`account` içindeki borsalar üzerinden short hesap payının basit ortalaması.
last_updatenumbermsBu yanıtta kullanılan en yeni long/short kaydının zaman damgası (tüm türler); kayıt yoksa null.

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

Örnek yanıt

/api/ls/coin?base=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:51 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: taker: 4 öğe içeriyordu; account: 6 öğe içeriyordu; position: 5 öğe içeriyordu.

  • {
    • "success": true,
    • "base": "BTC",
    • "now": 1794542271045,
    • "price": 68907.3,
    • "exchange_count": 6,
    • "exchanges": [
      • "binance",
      • "okx",
      • "bybit",
      • "bitget",
      • "gate",
      • "kraken"
      ],
    • "types": [
      • "account",
      • "topacc",
      • "position",
      • "taker"
      ],
    • "account": {
      • "binance": { … 3 },
      • "okx": { … 3 }
      },
    • "topacc": {
      • "binance": { … 3 },
      • "htx": { … 3 }
      },
    • "position": {
      • "binance": { … 3 },
      • "bitget": { … 3 }
      },
    • "taker": {
      • "binance": { … 3 },
      • "bitget": { … 3 }
      },
    • "avg_ratio": 2.883,
    • "avg_long": 73.52,
    • "avg_short": 26.48,
    • "last_update": 1794542163797
    }

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ç
base=ETH20051 msBaşarılı
base=SOL20040 msBaşarılı
base=ARKM20034 msBaşarılı

Kontrol: 2026-11-13 03:57:51 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
30s
Edge mikro önbelleği
10s
Güncelleme sıklığı
5 dakikada bir (binance üst düzey trader hesap oranı ile okx taker / üst düzey trader pozisyon oranları saatlik; geri kalan semboller 30 dakikada bir)
Pencere
en güncel anlık görüntü; son 3 saat içinde güncellenen satırlar
Veri kaynakları
Kurum içi toplayıcıların 7 borsanın (binance, okx, bybit, bitget, gate, htx, kraken) herkese açık istatistik uç noktalarından sorguladığı long/short oranları.
Borsa kapsamı
hesap oranı: binance, okx, bybit, bitget, gate, kraken; üst düzey trader hesap oranı: binance, htx; pozisyon oranı: binance, okx, gate, htx, bitget; taker alış/satış oranı: binance, okx, bitget, gate; kaynak örnekleme dönemleri farklıdır (5 dk ile 1 saat arası); sembol kapsamı hacme göre ilk sıralardakilerden oluşan kayan bir listedir (binance hesap oranında yaklaşık 280 coin, diğer borsa / türlerde yaklaşık 20-60 coin)
Birimler
long / short as percentages of 100; ratio = long / short; price in USD
Yöntem
avg_ratio = simple mean of account ratios across exchanges; avg_long / avg_short = simple means of account long% / short%
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:57:51 UTCHTTP 20042 msŞema eşleşiyor

Erişilebilirlik, son 30 gün

410 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/ls/coinKullanılabilir
Parametreler

string — Base coin symbol (uppercase, e.g. BTC).

İstek URL'sihttps://www.coinboss.com/api/ls/coin?base=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.