24h Volumen—Open Interest—24h Liquidationen$1.36B24h Long/Short—BTC-Dominanz—ETH-Dominanz—
App
Sprache ▾
€ EUR ▾
/api/hl/whale/:addr
GETVerfügbar

Details zu einem einzelnen Hyperliquid-Wal

Details zu einem einzelnen Hyperliquid-Wal (Positionen und Aktivität)

GET/api/hl/whale/:addr
Wenn der gespeicherte Snapshot der Adresse älter als 10 Minuten ist, aktualisiert die Anfrage ihn vor der Antwort über die öffentliche Hyperliquid-API, daher kann der erste Aufruf langsamer sein.

Anfrage

Query-Parameter

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

Mit „path“ gekennzeichnete Parameter sind Teil der URL.

Beispielanfrage

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

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.
trackedboolean—True, wenn die Adresse zum erfassten Wal-Pool gehört.
labelsarray—Labels.
labels[]object—Labels.
labels[].labelstring—Label.
labels[].typestring—Typ.
profileobject—Pool-Eintrag der Adresse; null, wenn sie nicht erfasst wird.
profile.firstSeennumbermsZeitpunkt, zu dem die Adresse erstmals in einem großen Fill oder einer Liquidation erfasst wurde.
profile.lastActivenumbermsZeitpunkt, zu dem die Adresse zuletzt in einem großen Fill oder einer Liquidation gesehen wurde.
profile.totalVolumeUsdnumberUSDKumulierter Nominalwert der großen Fills der Adresse, aufgezeichnet seit `firstSeen`; nicht ihr gesamtes Handelsvolumen.
profile.tradeCountnumbercountAnzahl der seit `firstSeen` für die Adresse aufgezeichneten großen Fills.
profile.maxFillUsdnumberUSDGrößter einzelner Fill, der für die Adresse aufgezeichnet wurde.
profile.liqCountnumbercountLiquidationen dieser Adresse auf Hyperliquid, aufgezeichnet seit Beginn ihrer Erfassung.
profile.sourcestring—Herkunft des Werts.
profile.accountValuenumberUSDEigenkapital des Kontos.
profile.totalUpnlnumberUSDGesamter nicht realisierter PnL.
profile.totalPosValuenumberUSDSumme der Positionswerte aller offenen Positionen bei der letzten Abfrage (`posPolledAt`); null, wenn noch nie abgefragt.
profile.posPolledAtnumbermsZeitpunkt der letzten Abfrage der Positionen.
positionsarray—Offene Positionen.
positions[]object—Offene Positionen.
positions[].coinstring—Coin-Symbol in Großbuchstaben (zum Beispiel BTC).
positions[].sidestring—`long` / `short` oder `buy` / `sell`.
positions[].szinumber—Positionsgröße mit Vorzeichen in Coins (negativ = Short).
positions[].entryPxnumberUSDDurchschnittlicher Einstiegspreis.
positions[].positionValuenumberUSDNominalwert der Position.
positions[].unrealizedPnlnumberUSDNicht realisierter Gewinn und Verlust.
positions[].roenumberfractionUnrealisierter PnL geteilt durch die Margin der Position, wie von Hyperliquid gemeldet (0.13 = 13 %); null, wenn der Wert 0 ist oder fehlt.
positions[].leveragenumber—Hebel der Position.
positions[].leverageTypestring—Margin-Modus der Position: `cross` oder `isolated`.
positions[].marginUsednumberUSDVon der Position genutzte Margin.
positions[].liquidationPxnumber|nullUSDGeschätzter Liquidationspreis.
positions[].snapshotTsnumbermsZeitpunkt des Positions-Snapshots.
recentLiquidationsarray—Bis zu 50 jüngste Liquidationen dieser Adresse auf Hyperliquid, neueste zuerst; leer, wenn keine aufgezeichnet sind. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde
statsobject—Handelsstatistiken, berechnet aus den jüngsten Perpetual-Fills der Adresse (höchstens 2.000); null, bis sie berechnet wurden.
stats.windowDaysnumberdaysTage zwischen dem ältesten und dem neuesten analysierten Fill (mindestens 1).
stats.fillsAnalyzednumbercountAnzahl der analysierten Fills: die jüngsten Fills, die Hyperliquid für die Adresse zurückgibt, höchstens 2.000.
stats.closedTradesnumbercountSchließungsereignisse unter den analysierten Perpetual-Fills (Fills mit geschlossenem PnL ungleich null, gruppiert nach Transaktion und Coin).
stats.winsnumbercountSchließungsereignisse mit positivem geschlossenem PnL.
stats.winRatenumberfraction`wins` ÷ `closedTrades` (0.6 = 60 %); null, wenn es keine Schließungsereignisse gibt.
stats.realizedPnlnumberUSDSumme des geschlossenen PnL über die analysierten Fills, vor Gebühren.
stats.feesPaidnumberUSDSumme der Handelsgebühren über die analysierten Perpetual-Fills.
stats.volumeUsdnumberUSDSumme aus Preis × Größe über die analysierten Perpetual-Fills.
stats.maxDrawdownnumberUSDGrößter Rückgang des kumulierten geschlossenen PnL vom Hoch zum Tief innerhalb der analysierten Fills; null, wenn es keinen Drawdown gab.
stats.roinumberfraction30-Tage-Rendite des Kontos aus dem Hyperliquid-eigenen Leaderboard (0.1 = 10 %); null, wenn die Adresse nicht auf diesem Leaderboard steht.
stats.topCoinsarray—Größte Coins.
stats.topCoins[]string—Größte Coins.
stats.computedAtnumbermsZeitstempel.

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

Beispielantwort

/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060 · Echte Antwort, erfasst 2026-11-13 03:58:41 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: labels hatte 3 Elemente; positions hatte 23 Elemente.

  • {
    • "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
      }
    }

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
20s
Edge-Micro-Cache
10s
Aktualisierungsintervall
Positionen alle 5 min für die Top-Adressen, bei Anfrage aktualisiert, wenn älter als 10 min; API-Cache 20 s
Zeitfenster
aktuellste Positionen; Liquidationshistorie wie gespeichert
Datenquellen
Profil einer Hyperliquid-Adresse: Positionen (aus der offiziellen Info-API abgefragt, bei Anfrage aktualisiert, wenn veraltet), Liquidationshistorie von unserem eigenen Node, Statistiken und Labels.
Börsenabdeckung
Jede Adresse; umfangreichere Daten für Adressen, die bereits im erfassten Pool sind
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:41 UTCHTTP 2004 msSchema stimmt übereinNeuester Datenpunkt 0s alt

Verfügbarkeit, letzte 30 Tage

99.76 % 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/whale/:addrVerfügbar
Parameter

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

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