/api/hl/vault-profile/:addr
GETKısmi

Hyperliquid kasa profili

Hyperliquid kasa profili (pozisyonlar, performans)

GET/api/hl/vault-profile/:addr
Kısmi kapsam. Ana kasalar (HLP gibi) pozisyonlarını alt kasalarda tutar; bu nedenle onlar için `positions`, `topCoins` ve `daily` boş 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. Örnek: 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303

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

Örnek istek

curl -s "https://www.coinboss.com/api/hl/vault-profile/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"

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.
vaultobject—Kasanın dizin kaydı, en güncel pozisyon toplamlarıyla birlikte; adres bilinen bir kasa değilse null.
vault.namestring—Ad.
vault.leaderstring—Kasa liderinin adresi.
vault.tvlnumberUSDKasadaki kilitli toplam değer.
vault.aprnumber—Kasanın yıllıklandırılmış getirisi.
vault.isClosedboolean—Hyperliquid kasayı kapalı olarak listeliyorsa true.
vault.relTypestring—Hyperliquid'in kasa dizinindeki ilişki türü: `parent`, `child` veya `normal`.
vault.parentAddressnull—Bu bir alt kasaysa ana kasanın adresi; aksi hâlde null.
vault.createTimenumbermsZaman damgası.
vault.accountValuenumberUSDHesap özkaynağı.
vault.positionValuenumberUSDPozisyonun nominal değeri.
vault.longValuenumberUSDLong nominal değeri.
vault.shortValuenumberUSDShort nominal değeri.
vault.totalUpnlnumberUSDToplam gerçekleşmemiş PnL.
vault.posPolledAtnumbermsPozisyonların en son sorgulandığı zaman.
vault.syncedAtnumbermsZaman damgası.
positionsarray—Açık pozisyonlar. bu tabloyu üretmek için kullanılan örneklerde boş
stylenull—Kasanın son 30 günde verisi olan günlerdeki işlem gerçekleşmelerinden oluşturulan işlem tarzı profili (hacim, taker payı, devir hızı); hiç gerçekleşme kaydedilmemişse null.
topCoinsarray—En büyük coinler. bu tabloyu üretmek için kullanılan örneklerde boş
dailyarray—Günlük değerler. bu tabloyu üretmek için kullanılan örneklerde boş

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

Örnek yanıt

/api/hl/vault-profile/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:38 UTC.

  • {
    • "success": true,
    • "updated": 1794542318769,
    • "address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    • "vault": {
      • "name": "Hyperliquidity Provider (HLP)",
      • "leader": "0x677d831aef5328190852e24f13c46cac05f984e7",
      • "tvl": 150199834.32,
      • "apr": 0.226572,
      • "isClosed": false,
      • "relType": "parent",
      • "parentAddress": null,
      • "createTime": 1683243596849,
      • "accountValue": 10173298.97,
      • "positionValue": 0,
      • "longValue": 0,
      • "shortValue": 0,
      • "totalUpnl": 0,
      • "posPolledAt": 1794542171335,
      • "syncedAt": 1794542172182
      },
    • "positions": [],
    • "style": null,
    • "topCoins": [],
    • "daily": []
    }

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ığı
dizin 30 dakikada bir; pozisyonlar 5 dakikada bir; işlem gerçekleşmeleri 10 s'de bir; API önbelleği 30 s
Pencere
30 günlük günlük toplu veriler; başlıca coinler depolanan işlem gerçekleşmelerinden
Veri kaynakları
Kasa profili: dizin bilgileri, likidasyon mesafesiyle birlikte güncel pozisyonlar, işlem tarzı metrikleri ve kendi düğümümüzden okunan kasa işlem gerçekleşmelerinden oluşturulan 30 günlük günlük toplu veriler.
Borsa kapsamı
Resmî dizindeki her kasa; pozisyonlar yalnızca TVL >= 10.000 USD olan kasalar için
Sayfalama
yok
Birimler
USD; ratios as decimals
Yöntem
takerRatio = taker notional / total notional; dailyTurnover = volume / days / TVL; liqDistance = |mark - liqPx| / mark with mark = positionValue / |size|
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı

Canlı durum

KısmiKontrol: 2026-11-13 03:58:38 UTCHTTP 2003 msŞema eşleşiyorEn yeni veri noktası 0s öncesine ait

Ana kasalar (HLP gibi) pozisyonlarını alt kasalarda tutar; bu nedenle onlar için `positions`, `topCoins` ve `daily` boş olabilir.

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/hl/vault-profile/:addrKısmi
Parametreler

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

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