Connecter Hyperliquid

Hyperliquid est un exchange on-chain : vous vous connectez avec un portefeuille crypto ou une adresse e-mail, et votre compte est lié à une adresse de portefeuille. Bybot trade sur votre compte Hyperliquid via un API Wallet – une clé distincte qui peut placer et annuler des ordres pour votre portefeuille. Votre argent reste sur votre compte Hyperliquid, et l’API Wallet ne peut ni retirer ni transférer de fonds. La configuration prend environ 10 minutes.

Dans Bybot, vous ajoutez deux éléments : l’adresse de votre portefeuille principal et la clé privée de l’API Wallet. Ne collez jamais la clé privée ni la phrase de récupération (seed phrase) de votre portefeuille principal – Bybot n’en a pas besoin et la refuse.

1. Connectez-vous à Hyperliquid

Ouvrez app.hyperliquid.xyz et cliquez sur “Connect”. Connectez-vous avec un portefeuille crypto ou avec une adresse e-mail. Si vous utilisez un portefeuille, cliquez ensuite sur “Enable Trading” et signez la demande dans le portefeuille – cela ne coûte pas de gas.

2. Déposez des USDC

Cliquez sur “Deposit”, choisissez USDC on Arbitrum et suivez les instructions à l’écran.

3. Rendez les USDC disponibles pour le spot

Bybot trade sur le marché spot d’Hyperliquid. Faites l’une des deux choses suivantes :

• passez votre compte en “Unified account” – un seul solde USDC sert alors au spot et aux contrats perpétuels, et aucun transfert n’est nécessaire ;
• ou, en mode standard, transférez des USDC de “Perps” vers “Spot” : dans ce mode, les dépôts arrivent sur le solde Perps.

Le mode “Portfolio margin” n’est pas pris en charge : dans ce mode, Hyperliquid emprunte automatiquement quand le solde est insuffisant, si bien que le bot pourrait acheter à crédit. Bybot refuse de fonctionner avec un tel compte.

4. Ouvrez la page API

Dans le menu du haut, ouvrez “More” et sélectionnez “API”.

5. Créez un API Wallet nommé

1. Saisissez un nom pour l’API Wallet, par exemple bybot, et cliquez sur “Generate”.
2. Cliquez sur “Authorize API Wallet”.

3. Dans la fenêtre “Authorize API Wallet”, cliquez sur “MAX” dans le champ “Days Valid” – l’API Wallet fonctionnera pendant la durée maximale, jusqu’à 180 jours.
4. Copiez la “Private Key” avec le bouton de copie et conservez-la en lieu sûr.
5. Cliquez sur “Authorize”. Si vous vous êtes connecté avec un portefeuille, confirmez dans celui-ci.

6. Copiez l’adresse de votre portefeuille

Cliquez sur le bouton de votre compte en haut à droite et copiez l’adresse avec le bouton de copie. C’est l’adresse de votre portefeuille principal – celle dont Bybot a besoin. N’utilisez pas l’adresse de l’API Wallet de l’étape 5.

7. Ajoutez la clé dans Bybot

Dans Bybot, ouvrez Paramètres (“Settings”) → Clés API (“API Keys”) et cliquez sur Ajouter une clé (“Add key”). Sélectionnez HYPERLIQUID et remplissez deux champs :

Cliquez sur Enregistrer (“Save”). Bybot vérifie la clé à partir des données publiques d’Hyperliquid : l’API Wallet doit appartenir à ce portefeuille et avoir un nom, et le mode du compte doit être pris en charge.

8. Vérifiez la clé

Dans la liste des clés, cliquez sur ”⋯” sur la carte Hyperliquid et sélectionnez Vérifier la clé (“Check key”). Bybot confirme que l’API Wallet est toujours lié à votre portefeuille. La colonne Expiration de l’API Wallet (“API Wallet expiry”) indique quand il expire.

9. Avant de créer un bot

• Bybot trade 6 paires contre USDC : BTC, ETH, SOL, ZEC, HYPE et NEAR. Sur Hyperliquid, BTC, ETH, SOL et ZEC sont des tokens wrappés par Unit (UBTC, UETH, USOL, UZEC) ; NEAR se trade sous la forme du token ONEAR.
• Sur Hyperliquid, vous pouvez faire tourner un bot DCA par paire.
• L’ordre minimum est de 10 USDC.

Suivez ensuite le guide Créer un bot.

Durée de vie de l’API Wallet

Vous choisissez la durée de fonctionnement de l’API Wallet lors de sa création, jusqu’à 180 jours. Bybot vous prévient avant son expiration. À l’expiration, le bot cesse de trader. Pour continuer, créez un nouvel API Wallet nommé sur Hyperliquid, puis supprimez l’ancienne clé dans Bybot et ajoutez la nouvelle.

Limite d’actions d’Hyperliquid

Hyperliquid limite le nombre d’actions – placement et annulation d’ordres – par portefeuille : 10,000 au départ, plus 1 action pour chaque $1 de volume de trading du portefeuille. Quand la limite est épuisée, le trading ne s’arrête pas, mais il ralentit.

Bybot ne peut pas acheter d’actions supplémentaires : Hyperliquid n’accepte cet achat qu’avec la signature de votre portefeuille principal et le facture à ce portefeuille. Si la limite est épuisée, attendez que votre volume de trading augmente ou achetez vous-même des actions supplémentaires depuis votre portefeuille principal.

Commissions et reliquats

• La commission spot d’Hyperliquid est de 0.07% pour les ordres taker et de 0.04% pour les ordres maker au niveau de base.
• Lors d’un achat, la commission est prélevée dans la crypto achetée (pour BTC, en UBTC) ; lors d’une vente, en USDC. Vous recevez donc un peu moins de crypto que vous n’en avez acheté.
• Un reliquat d’une valeur inférieure à l’ordre minimum de 10 USDC ne peut pas être vendu et reste sur le compte sous forme de poussière (dust).

Trading manuel sur le même portefeuille

Ne tradez pas manuellement sur une paire où le bot travaille. Hyperliquid ne permet pas à un portefeuille de trader avec lui-même : quand votre ordre manuel rencontre l’ordre du bot, Hyperliquid annule l’ordre qui était déjà dans le carnet d’ordres – souvent celui du bot. Le bot y voit une annulation.

Sécurité de la clé

• Les retraits sont impossibles. Un API Wallet peut placer et annuler des ordres, mais ne peut ni retirer ni transférer de fonds – Hyperliquid refuse ces demandes même si la clé a fuité.
• Ne collez jamais la clé privée ni la phrase de récupération de votre portefeuille principal. Bybot n’a besoin que de la clé de l’API Wallet et ne vous demandera jamais votre phrase de récupération.
• Utilisez un portefeuille distinct pour le bot. L’API Wallet peut trader sur l’ensemble de votre compte Hyperliquid, y compris les contrats perpétuels.
• Un portefeuille – un compte Bybot. Une adresse de portefeuille ne peut être connectée qu’à un seul compte Bybot.
• Si vous n’utilisez plus le bot, arrêtez vos bots Hyperliquid, supprimez la clé dans Bybot, puis révoquez l’API Wallet sur app.hyperliquid.xyz → “API”. Tant que vous ne l’avez pas révoqué, l’API Wallet peut toujours trader sur votre compte.

Problèmes fréquents

“Hyperliquid did not confirm the key” (Hyperliquid n’a pas confirmé la clé). Vérifiez l’adresse du portefeuille et la clé privée de l’API Wallet, ainsi que l’absence d’expiration de l’API Wallet.

“This is your main wallet private key” (c’est la clé privée de votre portefeuille principal). Vous avez collé la clé du portefeuille principal. Créez un API Wallet nommé (étape 5) et collez sa clé privée.

“The API Wallet must be a named one” (l’API Wallet doit avoir un nom). Créez un API Wallet avec un nom sur la page API et collez sa clé.

“This Hyperliquid account mode is not supported” (ce mode de compte Hyperliquid n’est pas pris en charge). Le compte est en Portfolio margin. Passez en Unified account ou en mode standard.

“This Hyperliquid wallet is already connected to another account” (ce portefeuille Hyperliquid est déjà connecté à un autre compte). Un portefeuille ne peut être connecté qu’à un seul compte Bybot.

Impossible de supprimer la clé. Arrêtez d’abord vos bots Hyperliquid, puis supprimez la clé.

Le bot n’achète pas alors que vous avez déposé des USDC. En mode standard, le dépôt arrive sur le solde Perps. Transférez les USDC vers Spot ou passez en Unified account.

Le bot est devenu lent. Le portefeuille a peut-être épuisé sa limite d’actions Hyperliquid – voir « Limite d’actions d’Hyperliquid » plus haut.

Documentation officielle de l’exchange : Hyperliquid Docs.