> For the complete documentation index, see [llms.txt](https://botlyz.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://botlyz.gitbook.io/docs/pour-demarrer/installation-pas-a-pas/connecter-un-compte-hyperliquid.md).

# Connecter un compte Hyperliquid

Botlyz fonctionne aussi avec **Hyperliquid**, un exchange décentralisé de perpétuels parmi les plus liquides du marché. Le principe est le même que pour Lighter : vos fonds restent chez Hyperliquid, sous le contrôle de votre wallet, et Botlyz reçoit uniquement une **clé API limitée au trading** (aucun retrait possible).

> **Note** : le support Hyperliquid est disponible pour tous, en **beta**. Si vous rencontrez le moindre souci, contactez-nous via l'onglet Aide.

## 1. Créer votre compte Hyperliquid

1. Ouvrez [app.hyperliquid.xyz](https://app.hyperliquid.xyz) et connectez votre wallet (Rabby, MetaMask…).
2. Déposez des **USDC** : bouton **Deposit** (dépôt depuis Arbitrum, ou via un exchange). Les fonds doivent être disponibles pour les **perps** (l'onglet Transfer permet de basculer entre Spot et Perps si besoin ; en mode « unified », votre USDC compte automatiquement).

## 2. Créer une clé API (agent)

Sur Hyperliquid, la clé API s'appelle un **API wallet** (ou agent) : un wallet secondaire autorisé à trader **pour** votre compte, sans jamais pouvoir retirer.

1. Allez sur [app.hyperliquid.xyz/API](https://app.hyperliquid.xyz/API) (menu **More → API**).
2. Donnez un nom (par exemple « botlyz ») puis cliquez **Generate**.
3. La **clé privée** de l'agent s'affiche à l'écran : **copiez-la immédiatement** (elle n'est montrée qu'une seule fois) et gardez-la en lieu sûr.
4. Cliquez **Authorize API Wallet** et signez avec votre wallet.

> **Attention** : si vous fermez la page sans copier la clé privée, elle est perdue. Il suffit alors de générer un nouvel agent et de recommencer.

## 3. Connecter le compte à Botlyz

1. Dans Botlyz : **Comptes** puis **+ Connecter un compte**, onglet **Hyperliquid**.
2. Renseignez :
   * **Adresse du wallet (maître)** : l'adresse de votre compte Hyperliquid (pré-remplie avec votre wallet connecté).
   * **Clé privée API (agent)** : la clé copiée à l'étape 2.
3. Cliquez **Connecter**. Botlyz vérifie en direct que l'agent est bien autorisé pour votre wallet, puis chiffre la clé.

## 4. Approuver les frais builder (0,10 %)

Comme sur Lighter, le protocole applique des **frais de 0,10 % par ordre** (builder codes, le plafond fixé par Hyperliquid). Vous les approuvez **une fois**, par une signature gratuite de votre wallet maître : aucun fonds n'est déplacé, et l'approbation est **révocable à tout moment** côté Hyperliquid.

Une fois l'approbation signée, vous pouvez déployer vos stratégies sur Hyperliquid exactement comme sur Lighter : mêmes stratégies, même backtest (sur les données Hyperliquid), mêmes protections SL/TP.

## Questions fréquentes

**Q. La clé agent peut-elle retirer mes fonds ?**

Non. Un API wallet Hyperliquid ne peut **que trader** : aucun retrait, aucun transfert vers une adresse externe. C'est ainsi par conception.

**Q. Mon compte est en mode « unified » (UTA), c'est un problème ?**

Non. Botlyz gère les deux modes : en unified, votre USDC spot compte automatiquement comme marge de trading ; en mode standard, transférez simplement vos USDC vers les perps (bouton Transfer).

**Q. La clé agent expire-t-elle ?**

Oui, Hyperliquid limite la validité d'un agent dans le temps (environ 6 à 12 mois). Quand elle expire, générez-en une nouvelle et mettez à jour la clé dans Botlyz (bouton « Modifier la clé »).

**Q. Puis-je avoir un compte Lighter ET un compte Hyperliquid ?**

Oui. Chaque stratégie se déploie sur l'exchange de votre choix, et le tableau de bord agrège les deux.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://botlyz.gitbook.io/docs/pour-demarrer/installation-pas-a-pas/connecter-un-compte-hyperliquid.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.