Volume 24h—Positions ouvertes—Liquidations 24h$1.36BLong/Short 24h—Dominance BTC—Dominance ETH—
App
Langue ▾
€ EUR ▾
/api/hl/whale/:addr
GETDisponible

Détail d'une baleine Hyperliquid

Détail d'une baleine Hyperliquid (positions et activité)

GET/api/hl/whale/:addr
Lorsque l'instantané stocké de l'adresse date de plus de 10 minutes, la requête l'actualise auprès de l'API publique de Hyperliquid avant de répondre : le premier appel peut donc être plus lent.

Requête

Paramètres de requête

NomTypeRequisPar défautValeurs autoriséesDescription
addr pathstringRequis——Adresse de 40 caractères hexadécimaux préfixée par 0x ; 400 en cas de format incorrect (en minuscules). Exemple: 0x5b5d51203a0f9079f8aeb098a6523a13f298c060

Les paramètres marqués « path » font partie de l'URL.

Exemple de requête

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

Champs de la réponse

Le tableau des champs est généré à partir de réponses réelles : il liste donc exactement ce que renvoie l'endpoint. Les chemins utilisent a[] pour les éléments d'un tableau et {*} pour les objets indexés par un nom dynamique, comme une crypto ou une plateforme.

ChampTypeUnitéDescription
successboolean—true lorsque la requête a abouti. En cas d'échec, le corps est `{ success: false, code, error, request_id }`.
updatednumbermsDate de dernière mise à jour des données.
addressstring—Adresse on-chain.
trackedboolean—True lorsque l'adresse fait partie du pool de baleines suivi.
labelsarray—Étiquettes.
labels[]object—Étiquettes.
labels[].labelstring—Étiquette.
labels[].typestring—Type.
profileobject—Fiche de l'adresse dans le pool ; null lorsqu'elle n'est pas suivie.
profile.firstSeennumbermsPremière fois que l'adresse a été enregistrée dans une exécution importante ou une liquidation.
profile.lastActivenumbermsDernière fois que l'adresse a été vue dans une exécution importante ou une liquidation.
profile.totalVolumeUsdnumberUSDNotionnel cumulé des exécutions importantes de l'adresse enregistrées depuis `firstSeen` ; il ne s'agit pas de son volume de trading total.
profile.tradeCountnumbercountNombre d'exécutions importantes enregistrées pour l'adresse depuis `firstSeen`.
profile.maxFillUsdnumberUSDPlus grosse exécution unique enregistrée pour l'adresse.
profile.liqCountnumbercountLiquidations de cette adresse sur Hyperliquid enregistrées depuis qu'elle est suivie.
profile.sourcestring—Provenance de la valeur.
profile.accountValuenumberUSDCapitaux propres du compte.
profile.totalUpnlnumberUSDPnL non réalisé total.
profile.totalPosValuenumberUSDSomme des valeurs de position de toutes les positions ouvertes lors du dernier relevé (`posPolledAt`) ; null lorsqu'aucun relevé n'a eu lieu.
profile.posPolledAtnumbermsDate de la dernière interrogation des positions.
positionsarray—Positions ouvertes.
positions[]object—Positions ouvertes.
positions[].coinstring—Symbole de la crypto, en majuscules (par exemple BTC).
positions[].sidestring—`long` / `short` ou `buy` / `sell`.
positions[].szinumber—Taille signée de la position en cryptos (négative = short).
positions[].entryPxnumberUSDPrix d'entrée moyen.
positions[].positionValuenumberUSDNotionnel de la position.
positions[].unrealizedPnlnumberUSDPnL non réalisé.
positions[].roenumberfractionPnL non réalisé divisé par la marge de la position, tel que le déclare Hyperliquid (0.13 = 13 %) ; null lorsqu'il est nul ou manquant.
positions[].leveragenumber—Effet de levier de la position.
positions[].leverageTypestring—Mode de marge de la position : `cross` ou `isolated`.
positions[].marginUsednumberUSDMarge utilisée par la position.
positions[].liquidationPxnumber|nullUSDPrix de liquidation estimé.
positions[].snapshotTsnumbermsHeure de l'instantané des positions.
recentLiquidationsarray—Les 50 liquidations les plus récentes au plus de cette adresse sur Hyperliquid, de la plus récente à la plus ancienne ; vide lorsqu'aucune n'est enregistrée. vide dans les échantillons ayant servi à générer ce tableau
statsobject—Statistiques de trading calculées à partir des exécutions de perpétuels les plus récentes de l'adresse (2 000 au plus) ; null tant qu'elles n'ont pas été calculées.
stats.windowDaysnumberdaysNombre de jours entre la plus ancienne et la plus récente des exécutions analysées (1 au minimum).
stats.fillsAnalyzednumbercountNombre d'exécutions analysées : les exécutions les plus récentes que Hyperliquid renvoie pour l'adresse, 2 000 au plus.
stats.closedTradesnumbercountÉvénements de clôture parmi les exécutions de perpétuels analysées (exécutions dont le PnL clôturé est non nul, regroupées par transaction et par crypto).
stats.winsnumbercountÉvénements de clôture dont le PnL clôturé est positif.
stats.winRatenumberfraction`wins` ÷ `closedTrades` (0.6 = 60 %) ; null lorsqu'il n'y a aucun événement de clôture.
stats.realizedPnlnumberUSDSomme du PnL clôturé sur les exécutions analysées, avant frais.
stats.feesPaidnumberUSDSomme des frais de trading sur les exécutions de perpétuels analysées.
stats.volumeUsdnumberUSDSomme des prix × taille sur les exécutions de perpétuels analysées.
stats.maxDrawdownnumberUSDPlus forte baisse, du pic au creux, du PnL clôturé cumulé sur les exécutions analysées ; null lorsqu'il n'y a eu aucun drawdown.
stats.roinumberfractionRendement du compte sur 30 jours d'après le classement de Hyperliquid lui-même (0.1 = 10 %) ; null lorsque l'adresse ne figure pas dans ce classement.
stats.topCoinsarray—Cryptos les plus importantes.
stats.topCoins[]string—Cryptos les plus importantes.
stats.computedAtnumbermsHorodatage.

Généré à partir de 1 réponses réelles (2026-11-11 23:00 UTC).

Exemple de réponse

/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060 · Réponse réelle (capture : 2026-11-13 04:03:10 UTC). Les tableaux et dictionnaires longs sont abrégés pour l'affichage : labels comptait 3 éléments; positions comptait 23 éléments.

  • {
    • "success": true,
    • "updated": 1794542590673,
    • "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": 71962896.59,
      • "totalUpnl": 70395642.16,
      • "totalPosValue": 331781859.18,
      • "posPolledAt": 1794542471343
      },
    • "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
      }
    }

Détails

Authentification
Aucune. Endpoint public.
Limite de requêtes
1200 requêtes par minute et par IP
Cache serveur
20s
Micro-cache en périphérie
10s
Fréquence de mise à jour
positions toutes les 5 min pour les principales adresses, actualisées à la demande lorsqu'elles datent de plus de 10 min ; cache API 20 s
Fenêtre
dernières positions ; historique des liquidations tel que stocké
Sources de données
Profil d'une adresse Hyperliquid : positions (interrogées auprès de l'API info officielle, actualisées à la demande si elles sont périmées), historique des liquidations issu de notre propre nœud, statistiques et étiquettes.
Couverture des plateformes
Toute adresse ; données plus riches pour les adresses déjà présentes dans le pool suivi
Pagination
aucun
Unités
USD
Horodatages
Millisecondes depuis l'epoch Unix (UTC), sauf indication contraire dans la description du champ
Format de réponse
json
Stabilité
Stable

Statut en direct

DisponibleVérifié : 2026-11-13 04:03:10 UTCHTTP 2003 msSchéma conformePoint de données le plus récent : il y a 0s

Disponibilité, 30 derniers jours

99.76 % des 410 contrôles réussis

Erreurs

Les appels en échec ont la même structure sur tous les endpoints. La liste complète figure sur la page des erreurs. Erreurs et limites de requêtes →

CodeHTTPSignificationQue faire
INVALID_PARAM400Un paramètre requis est manquant ou une valeur n'est pas acceptée. `param` indique le nom du paramètre lorsqu'il est connu.Ne réessayez pas à l'identique ; corrigez la requête.
UNAUTHORIZED401L'en-tête `CB-API-KEY` a été envoyé, mais la clé est inconnue ou révoquée. Les données publiques ne nécessitent aucune clé — supprimez l'en-tête ou utilisez une clé valide.Ne réessayez pas à l'identique.
FORBIDDEN403La route ne fait pas partie de l'API publique (interne ou réservée aux comptes).Ne réessayez pas.
NOT_FOUND404Route inconnue, ou la crypto / la plateforme / le fonds demandé n'existe pas.Ne réessayez pas ; vérifiez le chemin et les identifiants dans le catalogue.
RATE_LIMITED429Plus de requêtes que la limite par minute. `Retry-After` indique le nombre de secondes à attendre.Attendez la durée indiquée par `Retry-After`, puis réessayez avec backoff.
INTERNAL500Erreur serveur inattendue. Le message est volontairement générique ; citez `request_id` lorsque vous la signalez.Réessayez une fois après quelques secondes ; si l'erreur persiste, signalez-la avec l'ID de requête.
UPSTREAM_FAILED503La source de données derrière cet endpoint n'a pas répondu à temps. Aucun chiffre périmé ni de substitution n'est renvoyé à sa place.Réessayez avec backoff ; consultez la page de statut.
UNAVAILABLE501 / 503Le jeu de données n'est temporairement pas prêt (préchauffage du cache) ou l'endpoint n'a pas encore de source publique licite.Réessayez plus tard ; le catalogue signale les endpoints indisponibles par conception.
REQUEST_FAILED200Certains endpoints plus anciens répondent HTTP 200 avec `success: false`. Vérifiez toujours `success`, et pas seulement le statut HTTP.Dépend du message ; à traiter comme une requête en échec.

Essayer

GET/api/hl/whale/:addrDisponible
Paramètres

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

URL de la requêtehttps://www.coinboss.com/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060
Choisissez un endpoint et cliquez sur « Envoyer la requête ». La réponse, les en-têtes et le temps de réponse s'afficheront ici.