/api/hl/vault/:addr
GETVerfügbar

Details zu einem Hyperliquid-Vault

Details zu einem Hyperliquid-Vault

GET/api/hl/vault/:addr

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
addr pathstringErforderlich——Adresse aus 40 Hex-Zeichen mit Präfix 0x; 400 bei ungültigem Format; 404, wenn der Vault unbekannt ist. Beispiel: 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303

Mit „path“ gekennzeichnete Parameter sind Teil der URL.

Beispielanfrage

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

Antwortfelder

Die Feldtabelle wird aus echten Antworten erzeugt und führt daher genau das auf, was der Endpunkt zurückgibt. In Pfaden steht a[] für Array-Elemente und {*} für Objekte, deren Schlüssel ein dynamischer Name ist, etwa ein Coin oder eine Börse.

FeldTypEinheitBeschreibung
successboolean—true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`.
updatednumbermsZeitpunkt der letzten Aktualisierung der Daten.
namestring—Name.
vaultAddressstring—Adresse des Vaults.
leaderstring—Adresse des Vault-Leaders.
descriptionstring—Vom Vault-Leader verfasster Beschreibungstext, wie von Hyperliquid veröffentlicht; leerer String, wenn keiner vorhanden ist.
aprnumber—Annualisierte Rendite des Vaults.
maxDistributablenumberUSDHöchstbetrag, den der Vault derzeit an Einleger auszahlen kann, wie von Hyperliquid gemeldet.
isClosedboolean—True, wenn der Vault geschlossen ist.
allowDepositsboolean—Nur dann false, wenn Hyperliquid meldet, dass der Vault keine Einzahlungen annimmt.
followerCountnumbercountAnzahl der Einleger-Datensätze, die Hyperliquid für den Vault zurückgibt (die Liste ist gedeckelt, große Vaults zeigen daher den Höchstwert); null, wenn nicht zurückgegeben.
portfolioobject—Historie von Kontowert und PnL des Vaults je Zeitfenster. dynamische Schlüssel: day,week,month,allTime,perpDay,perpWeek
portfolio.{*}object—Die Schlüssel sind die Zeitfenster `day`, `week`, `month`, `allTime` sowie die nur auf Perpetual-Kontrakte bezogenen `perpDay`, `perpWeek`, `perpMonth`, `perpAllTime`.
portfolio.{*}.accountValueHistoryarray—Kontowert des Vaults über das Zeitfenster, älteste zuerst.
portfolio.{*}.accountValueHistory[]array—Ein Punkt: `[timestamp, account value]`.
portfolio.{*}.accountValueHistory[][]number—Das erste Element ist der Zeitstempel in ms, das zweite der Kontowert in USD.
portfolio.{*}.pnlHistoryarray—Kumulierter PnL des Vaults seit Beginn des Zeitfensters, älteste zuerst.
portfolio.{*}.pnlHistory[]array—Ein Punkt: `[timestamp, cumulative PnL]`.
portfolio.{*}.pnlHistory[][]number—Das erste Element ist der Zeitstempel in ms, das zweite der kumulierte PnL in USD.
portfolio.{*}.vlmnumberUSDHandelsvolumen des Vaults im Zeitfenster, wie von Hyperliquid gemeldet.

Erzeugt 2026-11-11 23:00 UTC aus 1 echten Antworten.

Beispielantwort

/api/hl/vault/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303 · Echte Antwort, erfasst 2026-11-13 03:58:38 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: portfolio hatte 8 Elemente; portfolio.{*}.pnlHistory hatte 63 Elemente; portfolio.{*}.accountValueHistory hatte 63 Elemente.

  • {
    • "success": true,
    • "updated": 1794542319008,
    • "name": "Hyperliquidity Provider (HLP)",
    • "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    • "leader": "0x677d831aef5328190852e24f13c46cac05f984e7",
    • "description": "This community-owned vault provides liquidity to Hyperliquid through multiple market making strategies, performs liquidations, and accrues platform fees.",
    • "apr": 0.22667592086684252,
    • "maxDistributable": 10172508.94846,
    • "isClosed": false,
    • "allowDeposits": true,
    • "followerCount": 100,
    • "portfolio": {
      • "day": { … 3 },
      • "week": { … 3 }
      }
    }

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
60s
Edge-Micro-Cache
10s
Aktualisierungsintervall
bei Anfrage abgerufen; API-Cache 60 s
Zeitfenster
Portfolio-Reihen day / week / month / allTime, wie von der Upstream-Quelle bereitgestellt
Datenquellen
Vault-Details und Eigenkapital-/PnL-Kurven, durchgereicht aus der offiziellen Info-API von Hyperliquid.
Börsenabdeckung
Jede Hyperliquid-Vault-Adresse
Paginierung
keine
Einheiten
USD
Zeitstempel
Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat
json
Stabilität
Stabil

Live-Status

VerfügbarGeprüft 2026-11-13 03:58:38 UTCHTTP 200118 msSchema stimmt übereinNeuester Datenpunkt 0s alt

Verfügbarkeit, letzte 30 Tage

100 % von 409 Prüfungen bestanden

Fehler

Fehlgeschlagene Aufrufe haben auf jedem Endpunkt denselben Aufbau. Die vollständige Liste steht auf der Fehlerseite. Fehler und Rate-Limits →

CodeHTTPBedeutungEmpfohlene Reaktion
INVALID_PARAM400Ein erforderlicher Parameter fehlt oder ein Wert wird nicht akzeptiert. `param` nennt den Parameter, sofern er bekannt ist.Nicht unverändert wiederholen; die Anfrage korrigieren.
UNAUTHORIZED401Der Header `CB-API-KEY` wurde gesendet, der Schlüssel ist jedoch unbekannt oder widerrufen. Öffentliche Daten erfordern keinen Schlüssel – lassen Sie den Header weg oder verwenden Sie einen gültigen Schlüssel.Nicht unverändert wiederholen.
FORBIDDEN403Die Route gehört nicht zur öffentlichen API (intern oder nur für Konten).Nicht wiederholen.
NOT_FOUND404Unbekannte Route, oder der angefragte Coin / die Börse / der Fonds existiert nicht.Nicht wiederholen; Pfad und Kennungen mit dem Katalog abgleichen.
RATE_LIMITED429Mehr Anfragen, als das Limit pro Minute zulässt. `Retry-After` gibt die Wartezeit in Sekunden an.`Retry-After` abwarten, dann mit Backoff wiederholen.
INTERNAL500Unerwarteter Serverfehler. Die Meldung ist bewusst allgemein gehalten; geben Sie `request_id` an, wenn Sie den Fehler melden.Einmal nach einigen Sekunden wiederholen; wenn der Fehler bestehen bleibt, mit der Request-ID melden.
UPSTREAM_FAILED503Die Datenquelle hinter diesem Endpunkt hat nicht rechtzeitig geantwortet. Es werden ersatzweise keine veralteten oder stellvertretenden Zahlen zurückgegeben.Mit Backoff wiederholen; die Statusseite prüfen.
UNAVAILABLE501 / 503Der Datensatz ist vorübergehend nicht bereit (Cache wird aufgewärmt), oder der Endpunkt hat noch keine rechtmäßige öffentliche Quelle.Später wiederholen; der Katalog kennzeichnet Endpunkte, die konzeptbedingt nicht verfügbar sind.
REQUEST_FAILED200Einige ältere Endpunkte antworten mit HTTP 200 und `success: false`. Prüfen Sie immer `success`, nicht nur den HTTP-Status.Hängt von der Meldung ab; als fehlgeschlagene Anfrage behandeln.

Ausprobieren

GET/api/hl/vault/:addrVerfügbar
Parameter

string — 0x-prefixed 40-hex address; 400 on bad format; 404 if vault unknown.

Anfrage-URLhttps://www.coinboss.com/api/hl/vault/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303
Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.