Oui, par l'API publique
Oui : Hyperliquid publie toute son interface de trading comme une API HTTP publique, celle-là même que l'interface web emploie. Les lectures ne demandent aucune clé, les écritures demandent une action signée, et un compte peut approuver un portefeuille d'API pour les signer à la place de sa propre clé.
| À quoi il sert | Où |
|---|---|
| Lectures : prix moyens, carnet L2, chandeliers, historique du funding, état d'un compte. Pas de clé, pas de signature. | POST https://api.hyperliquid.xyz/info |
Écritures : order, cancel, modify, updateLeverage, approveAgent, withdraw3 et les autres, chacune signée. | POST https://api.hyperliquid.xyz/exchange |
Flux en direct (allMids, l2Book, trades, candle, userFills), et une alternative à l'envoi par HTTP. | wss://api.hyperliquid.xyz/ws |
| Les mêmes trois chemins sur la place de test. | api.hyperliquid-testnet.xyz |
Trois adresses comptent, ci-dessous, et chaque chiffre de cette page est celui de la documentation au 5 octobre 2026.
Les SDK que la documentation liste
Vous n'avez pas à assembler des actions signées à la main. La documentation nomme un SDK Python officiel, hyperliquid-dex/hyperliquid-python-sdk, un SDK Rust communautaire, deux SDK TypeScript communautaires (nktkas/hyperliquid et nomeida/hyperliquid), et CCXT.
La signature est la partie qu'il vaut mieux emprunter que réécrire. Une action est sérialisée et signée dans une forme exacte, et une forme fausse d'un seul champ est refusée : l'ordre n'atteint jamais le carnet.
Portefeuilles d'API et nonces
Un compte maître peut approuver des portefeuilles d'API pour signer au nom du compte maître ou de l'un de ses sous-comptes. Ils ne font que signer : pour interroger les données d'un compte, vous devez passer l'adresse réelle de ce compte, et employer le portefeuille d'agent donne un résultat vide.
Les nonces sont plus stricts qu'ils n'en ont l'air. Hyperliquid garde les 100 nonces les plus élevés par adresse, et une nouvelle action a besoin d'un nonce supérieur au plus petit de cet ensemble, jamais employé avant, et à l'intérieur d'une fenêtre allant de T moins 2 jours à T plus 1 jour, où T est l'horodatage du bloc en millisecondes unix.
Un portefeuille d'API est élagué quand un nouveau portefeuille sans nom est enregistré, quand un nouveau portefeuille nommé reprend un nom existant, quand il expire, ou quand le compte qui l'a enregistré n'a plus de fonds. La documentation avertit qu'un agent désenregistré peut voir son état de nonces élagué, si bien que des actions signées auparavant peuvent être rejouées : générez un nouveau portefeuille d'agent plutôt que de ranimer un ancien.
Les limites de débit, telles que documentées
- Par IP. Les requêtes REST partagent une limite de poids agrégé de 1 200 par minute. Une action d'échange pèse
1 + floor(batch_length / 40), si bien qu'un lot est presque gratuit ; la plupart des requêtes d'information pèsent 20, une poignée pèsent 2, etuserRolepèse 60. - Par adresse. 1 requête par 1 USDC tradé cumulativement, après une réserve initiale de 10 000 requêtes, puis une requête toutes les 10 secondes. Les annulations ont une allocation plus large.
- Websocket. Au plus 10 connexions, 30 nouvelles connexions par minute, 1 000 abonnements, 2 000 messages envoyés par minute et 100 messages post simultanés en vol.
- Ordres ouverts. Une limite par défaut de 1 000, plus un de plus par 5 M d'USDC de volume, plafonnée à 5 000 au total.
La limite par adresse surprend un programme neuf : son allocation se gagne en tradant, et une boucle qui réessaie à l'aveugle la dépense pour rien.
Un script, un bot, un assistant
| Ce que c'est | Qui décide | Ce qu'il vous demande |
|---|---|---|
| Un script | Vous, au moment où vous l'avez écrit. Il déroule une séquence et ne choisit rien. | De le relire avant de le lancer. Ses limites sont les lignes que vous avez tapées. |
| Un bot | Une règle que vous avez écrite, chaque fois que ses conditions sont remplies, sans surveillance. | Des limites hors de la règle, et un moyen de l'arrêter en une commande. |
| Un assistant (un agent IA) | Un modèle propose ; du code vérifie la proposition contre des chiffres. | Des bornes qu'il ne peut pas élargir, et une clé qui ne peut pas retirer. |
L'API ne peut pas dire lequel des trois l'appelle, et applique les mêmes règles aux trois. Ils diffèrent par l'endroit où la décision est prise et par ce qui arrive quand elle est fausse : un script qui se trompe se trompe une fois, un bot toute la nuit.
Locker Protocol Agentic est du troisième genre : lpa pour une personne ou un agent IA, un serveur MCP avec les mêmes commandes comme outils, une politique locale vérifiée deux fois avant tout ordre, et un mandat signé par votre propre portefeuille. Il ne promet aucun résultat.