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

Hyperliquid tek balina ayrıntısı

Hyperliquid tek balina ayrıntısı (pozisyonlar ve hareketler)

GET/api/hl/whale/:addr
Adresin depolanan anlık görüntüsü 10 dakikadan eskiyse istek, yanıt vermeden önce onu Hyperliquid'in herkese açık API'sinden yeniler; bu nedenle ilk çağrı daha yavaş olabilir.

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
addr pathstringZorunlu——0x ön ekli 40 haneli onaltılık adres; biçim hatalıysa 400 (küçük harf). Örnek: 0x5b5d51203a0f9079f8aeb098a6523a13f298c060

“path” olarak işaretlenen parametreler URL'nin parçasıdır.

Örnek istek

curl -s "https://www.coinboss.com/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060"

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.
addressstring—Zincir üstü adres.
trackedboolean—Adres izlenen balina havuzundaysa true.
labelsarray—Etiketler.
labels[]object—Etiketler.
labels[].labelstring—Etiket.
labels[].typestring—Tür.
profileobject—Adresin havuz kaydı; izlenmiyorsa null.
profile.firstSeennumbermsAdresin büyük bir işlem gerçekleşmesinde ya da likidasyonda ilk kez kaydedildiği zaman.
profile.lastActivenumbermsAdresin büyük bir işlem gerçekleşmesinde ya da likidasyonda en son görüldüğü zaman.
profile.totalVolumeUsdnumberUSDAdresin `firstSeen` anından beri kaydedilen büyük gerçekleşmelerinin kümülatif nominal değeri; toplam işlem hacminin tamamı değildir.
profile.tradeCountnumbercountAdres için `firstSeen` anından beri kaydedilen büyük gerçekleşme sayısı.
profile.maxFillUsdnumberUSDAdres için kaydedilen en büyük tek gerçekleşme.
profile.liqCountnumbercountBu adresin, izlenmeye başlandığından beri Hyperliquid'de kaydedilen likidasyonları.
profile.sourcestring—Değerin nereden geldiği.
profile.accountValuenumberUSDHesap özkaynağı.
profile.totalUpnlnumberUSDToplam gerçekleşmemiş PnL.
profile.totalPosValuenumberUSDSon sorgulamadaki (`posPolledAt`) tüm açık pozisyonların pozisyon değerlerinin toplamı; hiç sorgulanmamışsa null.
profile.posPolledAtnumbermsPozisyonların en son sorgulandığı zaman.
positionsarray—Açık pozisyonlar.
positions[]object—Açık pozisyonlar.
positions[].coinstring—Coin sembolü, büyük harfle (örneğin BTC).
positions[].sidestring—`long` / `short` veya `buy` / `sell`.
positions[].szinumber—Coin cinsinden işaretli pozisyon büyüklüğü (negatif = short).
positions[].entryPxnumberUSDOrtalama giriş fiyatı.
positions[].positionValuenumberUSDPozisyonun nominal değeri.
positions[].unrealizedPnlnumberUSDGerçekleşmemiş kâr ve zarar.
positions[].roenumberfractionGerçekleşmemiş PnL'nin pozisyon marjına bölümü; Hyperliquid'in bildirdiği biçimde (0.13 = %13). Sıfırsa ya da eksikse null.
positions[].leveragenumber—Pozisyonun kaldıracı.
positions[].leverageTypestring—Pozisyonun marj modu: `cross` veya `isolated`.
positions[].marginUsednumberUSDPozisyonun kullandığı marj.
positions[].liquidationPxnumber|nullUSDTahmini likidasyon fiyatı.
positions[].snapshotTsnumbermsPozisyon anlık görüntüsünün zamanı.
recentLiquidationsarray—Bu adresin Hyperliquid'deki en son 50 likidasyonuna kadar, en yenisi başta; hiç kayıt yoksa boş. bu tabloyu üretmek için kullanılan örneklerde boş
statsobject—Adresin en son sürekli vadeli gerçekleşmelerinden (en çok 2.000) hesaplanan işlem istatistikleri; hesaplanana kadar null.
stats.windowDaysnumberdaysAnaliz edilen en eski ve en yeni işlem gerçekleşmesi arasındaki gün sayısı (en az 1).
stats.fillsAnalyzednumbercountAnaliz edilen işlem gerçekleşmesi sayısı: Hyperliquid'in adres için döndürdüğü en son gerçekleşmeler, en çok 2.000.
stats.closedTradesnumbercountAnaliz edilen sürekli vadeli gerçekleşmeleri arasındaki kapanış olayları (kapatılan PnL'si sıfırdan farklı gerçekleşmeler; işlem ve coine göre gruplanır).
stats.winsnumbercountKapatılan PnL'si pozitif olan kapanış olayları.
stats.winRatenumberfraction`wins` ÷ `closedTrades` (0.6 = %60); kapanış olayı yoksa null.
stats.realizedPnlnumberUSDAnaliz edilen gerçekleşmeler üzerinden kapatılan PnL toplamı, ücretlerden önce.
stats.feesPaidnumberUSDAnaliz edilen sürekli vadeli gerçekleşmeleri üzerinden işlem ücretleri toplamı.
stats.volumeUsdnumberUSDAnaliz edilen sürekli vadeli gerçekleşmeleri üzerinden fiyat × büyüklük toplamı.
stats.maxDrawdownnumberUSDAnaliz edilen gerçekleşmeler içinde kümülatif kapatılan PnL'nin tepeden dibe en büyük düşüşü; hiç düşüş olmadıysa null.
stats.roinumberfractionHyperliquid'in kendi sıralama tablosundan alınan, hesabın 30 günlük getirisi (0.1 = %10); adres bu sıralama tablosunda değilse null.
stats.topCoinsarray—En büyük coinler.
stats.topCoins[]string—En büyük coinler.
stats.computedAtnumbermsZaman damgası.

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

Örnek yanıt

/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:41 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: labels: 3 öğe içeriyordu; positions: 23 öğe içeriyordu.

  • {
    • "success": true,
    • "updated": 1794542321546,
    • "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
    • "tracked": true,
    • "labels": [
      • { … 2 },
      • { … 2 }
      ],
    • "profile": {
      • "firstSeen": 1784647213853,
      • "lastActive": 1794431032742,
      • "totalVolumeUsd": 1925599.62,
      • "tradeCount": 21,
      • "maxFillUsd": 207800.94,
      • "liqCount": 0,
      • "source": "bigfill",
      • "accountValue": 72162095.74,
      • "totalUpnl": 69508245.45,
      • "totalPosValue": 332670116.98,
      • "posPolledAt": 1794542171319
      },
    • "positions": [
      • { … 12 },
      • { … 12 }
      ],
    • "recentLiquidations": [],
    • "stats": {
      • "windowDays": 1,
      • "fillsAnalyzed": 2000,
      • "closedTrades": 1262,
      • "wins": 772,
      • "winRate": 0.6117,
      • "realizedPnl": 44221.53,
      • "feesPaid": 164.6835,
      • "volumeUsd": 1047900.19,
      • "maxDrawdown": 2774.11,
      • "roi": 0.812723,
      • "topCoins": [ … 5 ],
      • "computedAt": 1793024816450
      }
    }

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ığı
önde gelen adresler için pozisyonlar 5 dakikada bir, 10 dakikadan eskiyse istek anında yenilenir; API önbelleği 20 s
Pencere
en güncel pozisyonlar; depolandığı biçimiyle likidasyon geçmişi
Veri kaynakları
Tek bir Hyperliquid adresinin profili: pozisyonlar (resmî info API'sinden sorgulanır, eskimişse istek anında yenilenir), kendi düğümümüzden likidasyon geçmişi, istatistikler ve etiketler.
Borsa kapsamı
Herhangi bir adres; izlenen havuzda zaten bulunan adresler için daha zengin veri
Sayfalama
yok
Birimler
USD
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:41 UTCHTTP 2004 msŞema eşleşiyorEn yeni veri noktası 0s ö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/whale/:addrKullanılabilir
Parametreler

string — 0x-prefixed 40-hex address; 400 on bad format (lowercase).

İstek URL'sihttps://www.coinboss.com/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060
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.