Hyperliquid kasa profili
Hyperliquid kasa profili (pozisyonlar, performans)
/api/hl/vault-profile/:addrİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| addr path | string | Zorunlu | — | — | 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.
| Alan | Tür | Birim | Açıklama |
|---|---|---|---|
| success | boolean | — | İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur. |
| updated | number | ms | Verinin en son güncellendiği zaman. |
| address | string | — | Zincir üstü adres. |
| vault | object | — | Kasanın dizin kaydı, en güncel pozisyon toplamlarıyla birlikte; adres bilinen bir kasa değilse null. |
| vault.name | string | — | Ad. |
| vault.leader | string | — | Kasa liderinin adresi. |
| vault.tvl | number | USD | Kasadaki kilitli toplam değer. |
| vault.apr | number | — | Kasanın yıllıklandırılmış getirisi. |
| vault.isClosed | boolean | — | Hyperliquid kasayı kapalı olarak listeliyorsa true. |
| vault.relType | string | — | Hyperliquid'in kasa dizinindeki ilişki türü: `parent`, `child` veya `normal`. |
| vault.parentAddress | null | — | Bu bir alt kasaysa ana kasanın adresi; aksi hâlde null. |
| vault.createTime | number | ms | Zaman damgası. |
| vault.accountValue | number | USD | Hesap özkaynağı. |
| vault.positionValue | number | USD | Pozisyonun nominal değeri. |
| vault.longValue | number | USD | Long nominal değeri. |
| vault.shortValue | number | USD | Short nominal değeri. |
| vault.totalUpnl | number | USD | Toplam gerçekleşmemiş PnL. |
| vault.posPolledAt | number | ms | Pozisyonların en son sorgulandığı zaman. |
| vault.syncedAt | number | ms | Zaman damgası. |
| positions | array | — | Açık pozisyonlar. bu tabloyu üretmek için kullanılan örneklerde boş |
| style | null | — | 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. |
| topCoins | array | — | En büyük coinler. bu tabloyu üretmek için kullanılan örneklerde boş |
| daily | array | — | 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
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ı →
| Kod | HTTP | Anlamı | Ne yapmalı |
|---|---|---|---|
| INVALID_PARAM | 400 | Zorunlu 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. |
| UNAUTHORIZED | 401 | `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. |
| FORBIDDEN | 403 | Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel). | Yeniden denemeyin. |
| NOT_FOUND | 404 | Bilinmeyen rota ya da istenen coin / borsa / fon yok. | Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin. |
| RATE_LIMITED | 429 | Dakika 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. |
| INTERNAL | 500 | Beklenmeyen 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_FAILED | 503 | Bu 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. |
| UNAVAILABLE | 501 / 503 | Veri 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_FAILED | 200 | Bazı 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
/api/hl/vault-profile/:addrKısmistring — 0x-prefixed 40-hex address; 400 on bad format.
https://www.coinboss.com/api/hl/vault-profile/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303Bu kategoride daha fazlası
- Bir adres için Hyperliquid hesap durumu /api/hl/address/:addr
- Hyperliquid coin bazında balina pozisyonları sayfa verileri /api/hl/coin
- HYPE yakım özeti /api/hl/hype-burn
- HYPE yakım istatistikleri /api/hl/hype-burn-stats
- HYPE yakım / geri alım işlemleri /api/hl/hype-burn-txs
- Hyperliquid adres etiketleri /api/hl/labels/:addr
- Hyperliquid pozisyon büyüklüğü dağılımı /api/hl/margin-distribution
- Hyperliquid sürekli vadeli piyasa listesi /api/hl/markets
- Hyperliquid cüzdan PnL dağılımı /api/hl/pnl-distribution
- Hyperliquid pozisyon özeti /api/hl/position-summary
- Hyperliquid akıllı para sıralaması /api/hl/smart-money
- Hyperliquid kademe × coin ısı haritası /api/hl/symbol-heatmap
- Hyperliquid kademe ayrıntısı /api/hl/tier/:slug
- Bir Hyperliquid kademesindeki adresler /api/hl/tier/:slug/addresses
- Hyperliquid kasa işlem gerçekleşmeleri /api/hl/vault-fills
- Hyperliquid kasa yatırma / çekme akışları /api/hl/vault-flows
- Hyperliquid kasa profili /api/hl/vault-profile/:addr
- Hyperliquid kasa ayrıntısı /api/hl/vault/:addr
- Hyperliquid kasa listesi /api/hl/vaults
- Hyperliquid kasa özet tablosu /api/hl/vaults/overview
- Hyperliquid balina pozisyon açma / kapama hareketleri /api/hl/whale-actions
- Hyperliquid tek balina ayrıntısı /api/hl/whale/:addr
- Hyperliquid balina pozisyon listesi /api/hl/whales
- Hyperliquid balina long/short dağılımı /api/hl/whales/long-short
- Hyperliquid balina havuzu istatistikleri /api/hl/whales/stats