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

Hyperliquid pozisyon özeti

Hyperliquid pozisyon özeti (balina havuzu kapsamında)

GET/api/hl/position-summary

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
scopestringİsteğe bağlıwhale_poolwhale_pool, all_networkKapsam. Örnek: whale_pool

Örnek istek

curl -s "https://www.coinboss.com/api/hl/position-summary?scope=whale_pool"

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.
updatednumbermsVerinin en son güncellendiği zaman.
scopestring—Özetin adres evreni: `whale_pool` (izlenen balina adresleri). `all_network` kabul edilir, ancak şu anda anlık görüntü döndürmez.
snapshotobject—İzlenen tüm balina pozisyonlarının en güncel toplu değeri (5 dakikada bir anlık görüntü saklanır); hiç yoksa null.
snapshot.tsnumbermsZaman damgası.
snapshot.addrCountnumbercountEn az bir açık pozisyonu olan farklı izlenen adres sayısı.
snapshot.longAddrsnumber—Long olan adres sayısı.
snapshot.shortAddrsnumber—Short olan adres sayısı.
snapshot.longValuenumberUSDLong nominal değeri.
snapshot.shortValuenumberUSDShort nominal değeri.
snapshot.longMarginnumberUSDLong pozisyonların kullandığı marj.
snapshot.shortMarginnumberUSDShort pozisyonların kullandığı marj.
snapshot.longUpnlnumberUSDLong pozisyonların gerçekleşmemiş PnL toplamı.
snapshot.shortUpnlnumberUSDShort pozisyonların gerçekleşmemiş PnL toplamı.
snapshot.longFundingnumberUSDLong pozisyonların açılıştan itibaren fonlama toplamı; Hyperliquid'in işaret kuralıyla (pozitif = ödenen, negatif = alınan).
snapshot.shortFundingnumberUSDShort pozisyonların açılıştan itibaren fonlama toplamı; Hyperliquid'in işaret kuralıyla (pozitif = ödenen, negatif = alınan).
prev24hobject—Karşılaştırma için, `snapshot` değerinden en az 24 saat daha eski olan en yeni depolanmış anlık görüntü; hiç yoksa null.
prev24h.tsnumbermsZaman damgası.
prev24h.addrCountnumbercountÖnceki anlık görüntüde en az bir açık pozisyonu olan farklı izlenen adres sayısı.
prev24h.longAddrsnumber—Long olan adres sayısı.
prev24h.shortAddrsnumber—Short olan adres sayısı.
prev24h.longValuenumberUSDLong nominal değeri.
prev24h.shortValuenumberUSDShort nominal değeri.
prev24h.longMarginnumberUSDÖnceki anlık görüntüde long pozisyonların kullandığı marj.
prev24h.shortMarginnumberUSDÖnceki anlık görüntüde short pozisyonların kullandığı marj.
prev24h.longUpnlnumberUSDÖnceki anlık görüntüde long pozisyonların gerçekleşmemiş PnL toplamı.
prev24h.shortUpnlnumberUSDÖnceki anlık görüntüde short pozisyonların gerçekleşmemiş PnL toplamı.
prev24h.longFundingnumberUSDÖnceki anlık görüntüde long pozisyonların açılıştan itibaren fonlama toplamı (pozitif = ödenen).
prev24h.shortFundingnumberUSDÖnceki anlık görüntüde short pozisyonların açılıştan itibaren fonlama toplamı (pozitif = ödenen).

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

Örnek yanıt

/api/hl/position-summary?scope=whale_pool · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:53:08 UTC.

  • {
    • "success": true,
    • "updated": 1794541988572,
    • "scope": "whale_pool",
    • "snapshot": {
      • "ts": 1794541833226,
      • "addrCount": 1707,
      • "longAddrs": 1250,
      • "shortAddrs": 761,
      • "longValue": 2317647288.5,
      • "shortValue": 2668492906.07,
      • "longMargin": 266041962.88,
      • "shortMargin": 344054602.74,
      • "longUpnl": -225343054.98,
      • "shortUpnl": 319405247.39,
      • "longFunding": 41171557.592659,
      • "shortFunding": -92766854.054105
      },
    • "prev24h": {
      • "ts": 1794455433182,
      • "addrCount": 1731,
      • "longAddrs": 1282,
      • "shortAddrs": 754,
      • "longValue": 2508207564.38,
      • "shortValue": 2900101148.16,
      • "longMargin": 290106695.23,
      • "shortMargin": 372506105.81,
      • "longUpnl": -199152142.42,
      • "shortUpnl": 256448952.11,
      • "longFunding": 41667716.017602,
      • "shortFunding": -92718942.253169
      }
    }

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ığı
5 dakikada bir (90 gün saklanır); API önbelleği 60 s
Pencere
en güncel anlık görüntü ile 24h önceki anlık görüntünün karşılaştırması
Veri kaynakları
İzlenen Hyperliquid balina havuzunun toplam long/short maruziyeti; anlık görüntüleri kurum içinde alınır.
Borsa kapsamı
izlenen balina havuzu (>= 50.000 USD'lik tek bir işlem gerçekleşmesi olan, likide edilmiş veya bir kasa işleten adresler); ağın tamamı değildir
Sayfalama
yok
Birimler
USD; counts
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:53:08 UTCHTTP 2004 msŞema eşleşiyorEn yeni veri noktası 0s öncesine ait

Erişilebilirlik, son 30 gün

408 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/hl/position-summaryKullanılabilir
Parametreler

string · varsayılan whale_pool — Scope.

İstek URL'sihttps://www.coinboss.com/api/hl/position-summary?scope=whale_pool
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.