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

Details zu einer Hyperliquid-Stufe

Details zu einer Hyperliquid-Stufe (Zusammenfassung, Coin-Positionen, Liquidationsrisiko, zuletzt eröffnete Positionen)

GET/api/hl/tier/:slug
Teilweise Abdeckung. `liqRisk` und `actions` können bei Stufen mit sehr wenigen Wallets leere Arrays sein.

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
slug pathstringErforderlich—stardust, meteor, asteroid, comet, planet, star, supernova, galaxySlug der Stufe; 404, wenn unbekannt. Beispiel: galaxy

Mit „path“ gekennzeichnete Parameter sind Teil der URL.

Beispielanfrage

curl -s "https://www.coinboss.com/api/hl/tier/galaxy"

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.
tierobject—Wallet-Größenstufe.
tier.bucketnumbermsBeginn des Zeit-Buckets.
tier.slugstring—Kennung der Stufe.
tier.minnumber—Minimum.
tier.maxnull—Maximum.
networkobject—Anzahl der Wallets im Gewinn / Verlust in dieser Stufe über alle Adressen auf dem Leaderboard von Hyperliquid, je PnL-Zeitfenster; null, wenn kein Snapshot existiert.
network.tsnumbermsZeitstempel.
network.windowsobject—Werte je Zeitfenster. dynamische Schlüssel: allTime,day,month,week
network.windows.{*}object—Werte je Zeitfenster.
network.windows.{*}.walletsnumber—Anzahl der Wallets.
network.windows.{*}.profitnumber—Gewinn.
network.windows.{*}.lossnumber—Verlust.
network.windows.{*}.flatnumber—Anzahl oder Wert der unveränderten Einträge.
network.windows.{*}.profitUsdnumberUSDSumme der Gewinne.
network.windows.{*}.lossUsdnumberUSDSumme der Verluste.
poolobject—Kennzahlen, die auf die erfassten Wal-Adressen beschränkt sind, deren Kontowert in diese Stufe fällt, nicht auf das gesamte Netzwerk bezogen.
pool.trackednumbercountErfasste Wal-Adressen, deren Kontowert in diese Stufe fällt.
pool.holdersnumbercountDavon Adressen mit mindestens einer offenen Position.
pool.longUsdnumberUSDLong-Nominalwert.
pool.shortUsdnumberUSDShort-Nominalwert.
pool.upnlWinAddrsnumbercountAdressen mit mindestens einer Position im unrealisierten Gewinn; eine Adresse kann zugleich in `upnlLoseAddrs` gezählt werden.
pool.upnlLoseAddrsnumbercountAdressen mit mindestens einer Position im unrealisierten Verlust; eine Adresse kann zugleich in `upnlWinAddrs` gezählt werden.
coinRankarray—Top 20 Coins nach gesamtem Positionswert, den die erfassten Adressen dieser Stufe halten.
coinRank[]object—Ein Coin mit seinem Long-, Short- und Gesamtpositionswert in USD.
coinRank[].coinstring—Coin-Symbol in Großbuchstaben (zum Beispiel BTC).
coinRank[].longUsdnumberUSDLong-Nominalwert.
coinRank[].shortUsdnumberUSDShort-Nominalwert.
coinRank[].totalUsdnumberUSDGesamtzahl.
liqRiskarray—Bis zu 15 nach Positionswert sortierte Coins, deren Mark-Preis höchstens 10 % vom Liquidationspreis entfernt ist; leer, wenn es keine gibt. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde
actionsarray—Die letzten 40 positionseröffnenden Fills (`open_long` / `open_short`) der erfassten Adressen dieser Stufe, neueste zuerst. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde

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

Beispielantwort

/api/hl/tier/galaxy · Echte Antwort, erfasst 2026-11-13 03:58:38 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: coinRank hatte 20 Elemente; network.windows hatte 4 Elemente.

  • {
    • "success": true,
    • "updated": 1794542318268,
    • "tier": {
      • "bucket": 7,
      • "slug": "galaxy",
      • "min": 100000000,
      • "max": null
      },
    • "network": {
      • "ts": 1794541537300,
      • "windows": { … 2 }
      },
    • "pool": {
      • "tracked": 1,
      • "holders": 1,
      • "longUsd": 844581.06,
      • "shortUsd": 273471757.4,
      • "upnlWinAddrs": 1,
      • "upnlLoseAddrs": 1
      },
    • "coinRank": [
      • { … 4 },
      • { … 4 }
      ],
    • "liqRisk": [],
    • "actions": []
    }

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
60s
Edge-Micro-Cache
10s
Aktualisierungsintervall
Leaderboard-Buckets alle 15 min; Positionen alle 5 min; Aktionen alle 15 s; API-Cache 60 s
Zeitfenster
letzte Snapshots; die letzten 40 Eröffnungsaktionen
Datenquellen
Profil einer Kontogrößen-Stufe auf Hyperliquid: Wallet-Anzahl und PnL aus dem offiziellen Leaderboard, dazu Bestände, Liquidationsrisiko und jüngste Eröffnungen der erfassten Wal-Adressen in dieser Stufe.
Börsenabdeckung
slug = stardust | meteor | asteroid | comet | planet | star | supernova | galaxy; Block network = Leaderboard-Wallets, Blöcke pool = nur der erfasste Wal-Pool
Paginierung
keine
Einheiten
USD; counts
Methode
liqRisk = notional of positions with |mark - liquidation price| / mark <= 10%
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 200220 msSchema stimmt übereinNeuester Datenpunkt 0s alt

`liqRisk` und `actions` können bei Stufen mit sehr wenigen Wallets leere Arrays 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/tier/:slugTeilweise
Parameter

string — Tier slug; 404 if unknown.

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