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

Hyperliquid coin bazında balina pozisyonları sayfa verileri

Hyperliquid coin bazında balina pozisyonları sayfa verileri (sayfalı)

GET/api/hl/coin

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
symbolstringZorunlu——Coin sembolü (büyük harfe çevrilir); veri yoksa 404. Örnek: BTC
pageintegerİsteğe bağlı1≥ 1Sayfa numarası (1'den başlar). Örnek: 1
sizeintegerİsteğe bağlı12≥ 1 · ≤ 100Sayfa boyutu. Örnek: 12

Örnek istek

curl -s "https://www.coinboss.com/api/hl/coin?symbol=BTC&page=1&size=12"

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.
dataobject—Veri yükü.
data.symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
data.positionsnumber—Açık pozisyonlar.
data.total_value_usdnumberUSDBu coinde izlenen tüm balina pozisyonlarının en güncel anlık görüntülerindeki pozisyon değerlerinin (long + short) toplamı.
data.unrealized_pnl_usdnumberUSDBu coinde izlenen tüm balina pozisyonlarının gerçekleşmemiş PnL toplamı.
data.long_value_usdnumberUSDBu coinde izlenen long pozisyonların pozisyon değerlerinin toplamı.
data.short_value_usdnumberUSDBu coinde izlenen short pozisyonların pozisyon değerlerinin toplamı.
data.avg_leveragenumberxİzlenen pozisyonlardaki kaldıraç ayarının basit (ağırlıksız) ortalaması; bir ondalık basamağa yuvarlanır.
data.snapshot_atnumbermsAnlık görüntünün zamanı.
data.pagenumber—Geçerli sayfa (1'den başlar).
data.sizenumber—Sayfa boyutu.
data.total_pagesnumbercountİstenen `size` değerine göre mevcut sayfa sayısı.
data.top_positionsarray—İstenen sayfadaki pozisyonlar; pozisyon değeri en büyük olan başta.
data.top_positions[]object—İzlenen bir pozisyon (bu coinde bir adres).
data.top_positions[].addressstring—Zincir üstü adres.
data.top_positions[].address_fullstring—Tam hesap adresi; `address` kısaltılmış görüntülenen biçimdir.
data.top_positions[].sidestring—`long` / `short` veya `buy` / `sell`.
data.top_positions[].sizenumber—Sayfa boyutu.
data.top_positions[].entry_pxnumberUSDPozisyonun ortalama giriş fiyatı.
data.top_positions[].value_usdnumberUSDDeğer.
data.top_positions[].pnl_usdnumberUSDPozisyonun en güncel anlık görüntüsündeki gerçekleşmemiş PnL'si.
data.top_positions[].leveragenumber—Pozisyonun kaldıracı.
data.top_positions[].liq_pxnumber|nullUSDAnlık görüntü anında Hyperliquid'in bildirdiği likidasyon fiyatı; pozisyonun likidasyon fiyatı yoksa null.

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

Örnek yanıt

/api/hl/coin?symbol=BTC&page=1&size=12 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:26 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data.top_positions: 12 öğe içeriyordu.

  • {
    • "success": true,
    • "data": {
      • "symbol": "BTC",
      • "positions": 983,
      • "total_value_usd": 1748485942.46,
      • "unrealized_pnl_usd": 33759163.82,
      • "long_value_usd": 728625990.49,
      • "short_value_usd": 1019859951.97,
      • "avg_leverage": 28.1,
      • "snapshot_at": 1794542171335,
      • "page": 1,
      • "size": 12,
      • "total_pages": 82,
      • "top_positions": [ … 2 ]
      }
    }

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ç
page=1&size=12&symbol=ETH2006 msBaşarılı
page=1&size=12&symbol=SOL2005 msBaşarılı

Kontrol: 2026-11-13 03:28:24 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
2m
Edge mikro önbelleği
10s
Güncelleme sıklığı
pozisyonlar 5 dakikada bir; bellek içi önbellek 120 s
Pencere
en güncel pozisyon anlık görüntüsü
Veri kaynakları
Tek bir coinde izlenen Hyperliquid balina pozisyonları: long/short toplamları, ortalama kaldıraç ve likidasyon fiyatlarıyla birlikte en büyük pozisyonlar.
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
page + size (1-100, varsayılan 12); total_pages döndürülür
Sıralama
pozisyon değeri, azalan
Birimler
USD; size in coin units
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:52:57 UTCHTTP 2005 msŞema eşleşiyorEn yeni veri noktası 2m öncesine ait

Erişilebilirlik, son 30 gün

409 kontrolde başarı oranı: %99.76

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

string — Coin symbol (upper-cased); 404 when no data.

integer · varsayılan 1 · en az 1 — Page number (1-based).

integer · varsayılan 12 · en az 1 · en çok 100 — Page size.

İstek URL'sihttps://www.coinboss.com/api/hl/coin?symbol=BTC&page=1&size=12
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.