24h Volumen—Open Interest—24h Liquidationen$1.36B24h Long/Short—BTC-Dominanz—ETH-Dominanz—
App
Sprache ▾
€ EUR ▾
/api/hl/vault-profile/:addr
GETTeilweise

Profil eines Hyperliquid-Vaults

Profil eines Hyperliquid-Vaults (Positionen, Performance)

GET/api/hl/vault-profile/:addr
Teilweise Abdeckung. Übergeordnete Vaults (wie HLP) halten Positionen in untergeordneten Vaults, daher können `positions`, `topCoins` und `daily` bei ihnen leer sein.

Anfrage

Query-Parameter

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

Mit „path“ gekennzeichnete Parameter sind Teil der URL.

Beispielanfrage

curl -s "https://www.coinboss.com/api/hl/vault-profile/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.
addressstring—On-Chain-Adresse.
vaultobject—Verzeichniseintrag des Vaults mit seinen letzten Positionssummen; null, wenn die Adresse kein bekannter Vault ist.
vault.namestring—Name.
vault.leaderstring—Adresse des Vault-Leaders.
vault.tvlnumberUSDGesamtwert der im Vault gesperrten Vermögenswerte.
vault.aprnumber—Annualisierte Rendite des Vaults.
vault.isClosedboolean—True, wenn Hyperliquid den Vault als geschlossen führt.
vault.relTypestring—Beziehungstyp aus dem Vault-Verzeichnis von Hyperliquid: `parent`, `child` oder `normal`.
vault.parentAddressnull—Adresse des übergeordneten Vaults, wenn dies ein untergeordneter Vault ist; andernfalls null.
vault.createTimenumbermsZeitstempel.
vault.accountValuenumberUSDEigenkapital des Kontos.
vault.positionValuenumberUSDNominalwert der Position.
vault.longValuenumberUSDLong-Nominalwert.
vault.shortValuenumberUSDShort-Nominalwert.
vault.totalUpnlnumberUSDGesamter nicht realisierter PnL.
vault.posPolledAtnumbermsZeitpunkt der letzten Abfrage der Positionen.
vault.syncedAtnumbermsZeitstempel.
positionsarray—Offene Positionen. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde
stylenull—Profil des Handelsstils, gebildet aus den Fills des Vaults an den Tagen mit Daten in den letzten 30 Tagen (Volumen, Taker-Anteil, Umschlag); null, wenn keine Fills aufgezeichnet sind.
topCoinsarray—Größte Coins. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde
dailyarray—Tageswerte. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde

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

Beispielantwort

/api/hl/vault-profile/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303 · Echte Antwort, erfasst 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": []
    }

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
30s
Edge-Micro-Cache
10s
Aktualisierungsintervall
Verzeichnis alle 30 min; Positionen alle 5 min; Fills alle 10 s; API-Cache 30 s
Zeitfenster
30 Tage an Tagesaggregaten; Top-Coins aus den gespeicherten Fills
Datenquellen
Vault-Profil: Verzeichnisinformationen, aktuelle Positionen mit Abstand zur Liquidation, Kennzahlen zum Handelsstil und 30-Tage-Tagesaggregate aus den Vault-Fills, die von unserem eigenen Node gelesen werden.
Börsenabdeckung
Jeder Vault im offiziellen Verzeichnis; Positionen nur für Vaults mit TVL >= 10.000 USD
Paginierung
keine
Einheiten
USD; ratios as decimals
Methode
takerRatio = taker notional / total notional; dailyTurnover = volume / days / TVL; liqDistance = |mark - liqPx| / mark with mark = positionValue / |size|
Zeitstempel
Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat
json
Stabilität
Stabil

Live-Status

TeilweiseGeprüft 2026-11-13 03:58:38 UTCHTTP 2003 msSchema stimmt übereinNeuester Datenpunkt 0s alt

Übergeordnete Vaults (wie HLP) halten Positionen in untergeordneten Vaults, daher können `positions`, `topCoins` und `daily` bei ihnen leer sein.

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-profile/:addrTeilweise
Parameter

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

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