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

Seitendaten zu Hyperliquid-Wal-Positionen je Coin

Seitendaten zu Hyperliquid-Wal-Positionen je Coin (paginiert)

GET/api/hl/coin

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
symbolstringErforderlich——Coin-Symbol (in Großbuchstaben umgewandelt); 404, wenn keine Daten vorliegen. Beispiel: BTC
pageintegerOptional1≥ 1Seitennummer (beginnend bei 1). Beispiel: 1
sizeintegerOptional12≥ 1 · ≤ 100Seitengröße. Beispiel: 12

Beispielanfrage

curl -s "https://www.coinboss.com/api/hl/coin?symbol=BTC&page=1&size=12"

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 }`.
dataobject—Nutzdaten.
data.symbolstring—Instrumentensymbol in der von CoinBoss normalisierten Form (zum Beispiel BTCUSDT).
data.positionsnumber—Offene Positionen.
data.total_value_usdnumberUSDSumme der Positionswerte (Long + Short) aller erfassten Wal-Positionen in diesem Coin in ihrem letzten Snapshot.
data.unrealized_pnl_usdnumberUSDSumme des unrealisierten PnL über alle erfassten Wal-Positionen in diesem Coin.
data.long_value_usdnumberUSDSumme der Positionswerte der erfassten Long-Positionen in diesem Coin.
data.short_value_usdnumberUSDSumme der Positionswerte der erfassten Short-Positionen in diesem Coin.
data.avg_leveragenumberxEinfacher (ungewichteter) Durchschnitt der Hebeleinstellung über die erfassten Positionen, auf eine Dezimalstelle gerundet.
data.snapshot_atnumbermsZeitpunkt des Snapshots.
data.pagenumber—Aktuelle Seite (beginnend bei 1).
data.sizenumber—Seitengröße.
data.total_pagesnumbercountAnzahl der Seiten, die bei der angefragten `size` verfügbar sind.
data.top_positionsarray—Positionen auf der angefragten Seite, größter Positionswert zuerst.
data.top_positions[]object—Eine erfasste Position (eine Adresse in diesem Coin).
data.top_positions[].addressstring—On-Chain-Adresse.
data.top_positions[].address_fullstring—Vollständige Kontoadresse; `address` ist die gekürzte Anzeigeform.
data.top_positions[].sidestring—`long` / `short` oder `buy` / `sell`.
data.top_positions[].sizenumber—Seitengröße.
data.top_positions[].entry_pxnumberUSDDurchschnittlicher Einstiegspreis der Position.
data.top_positions[].value_usdnumberUSDWert.
data.top_positions[].pnl_usdnumberUSDUnrealisierter PnL der Position in ihrem letzten Snapshot.
data.top_positions[].leveragenumber—Hebel der Position.
data.top_positions[].liq_pxnumber|nullUSDVon Hyperliquid zum Zeitpunkt des Snapshots gemeldeter Liquidationspreis; null, wenn die Position keinen hat.

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

Beispielantwort

/api/hl/coin?symbol=BTC&page=1&size=12 · Echte Antwort, erfasst 2026-11-13 01:42:54 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: data.top_positions hatte 12 Elemente.

  • {
    • "success": true,
    • "data": {
      • "symbol": "BTC",
      • "positions": 996,
      • "total_value_usd": 1894919576.6,
      • "unrealized_pnl_usd": 20505785.35,
      • "long_value_usd": 802100318.42,
      • "short_value_usd": 1092819258.18,
      • "avg_leverage": 28.1,
      • "snapshot_at": 1794534081426,
      • "page": 1,
      • "size": 12,
      • "total_pages": 83,
      • "top_positions": [ … 2 ]
      }
    }

Geprüfte Stichproben

Neben dem obigen Beispiel ruft die Prüfsonde diesen Endpunkt mit den folgenden Parametern auf und prüft jedes Mal das Schema.

ParameterHTTPLatenzErgebnis
page=1&size=12&symbol=ETH2005 msBestanden
page=1&size=12&symbol=SOL2005 msBestanden

Geprüft 2026-11-13 01:28:23 UTC

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
2m
Edge-Micro-Cache
10s
Aktualisierungsintervall
Positionen alle 5 min; In-Memory-Cache 120 s
Zeitfenster
letzter Positions-Snapshot
Datenquellen
Erfasste Hyperliquid-Wal-Positionen in einem Coin: Long/Short-Summen, durchschnittlicher Hebel und die größten Positionen mit Liquidationspreisen.
Börsenabdeckung
erfasster Wal-Pool (Adressen, die einen einzelnen Fill >= 50.000 USD ausgeführt haben, liquidiert wurden oder einen Vault betreiben); nicht das gesamte Netzwerk
Paginierung
page + size (1-100, Standard 12); total_pages wird zurückgegeben
Sortierung
Positionswert absteigend
Einheiten
USD; size in coin units
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 01:42:54 UTCHTTP 2005 msSchema stimmt übereinNeuester Datenpunkt 2m alt

Verfügbarkeit, letzte 30 Tage

99.74 % von 382 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/coinVerfügbar
Parameter

string — Coin symbol (upper-cased); 404 when no data.

integer · Standard 1 · min. 1 — Page number (1-based).

integer · Standard 12 · min. 1 · max. 100 — Page size.

Anfrage-URLhttps://www.coinboss.com/api/hl/coin?symbol=BTC&page=1&size=12
Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.