> 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/installation-hyperliquid.md).

# Installation de A à Z : Hyperliquid

Cette page vous accompagne **du tout début jusqu'à votre première stratégie automatisée sur Hyperliquid**. Chaque étape vous dit **où aller** et **quoi cliquer**, puis renvoie vers une page détaillée si vous voulez approfondir. Vous n'avez besoin d'aucune connaissance technique.

> Vous préférez trader sur Lighter ? Suivez plutôt [Installation de A à Z : Lighter](/docs/pour-demarrer/installation-pas-a-pas/installation-lighter.md). Les deux parcours sont équivalents : seul l'exchange change.

## Quelques mots avant de commencer

Deux services entrent en jeu, et il est utile de bien les distinguer :

* **Hyperliquid** : la plateforme de trading. C'est l'une des plus grandes places de marché décentralisées de **perpétuels** (des contrats qui suivent le prix d'un actif, sans date d'échéance), réputée pour sa liquidité et sa rapidité. C'est là que se trouve votre argent et que les ordres sont passés.
* **Botlyz** : le logiciel qui exécute automatiquement une **stratégie** (un ensemble de règles d'achat et de vente) sur votre compte Hyperliquid, en suivant exactement la configuration que vous avez validée.

> 👉 En résumé : votre argent reste chez **vous** et sur **Hyperliquid**. Botlyz place et annule des ordres selon vos règles, mais **ne peut jamais retirer vos fonds**.

Le parcours complet tient en **huit étapes**. Comptez environ 15 à 20 minutes la première fois.

## Étape 1 : Connecter votre wallet à Botlyz

Un **wallet** (portefeuille) est une petite application (souvent une extension de navigateur) qui détient votre identité sur la blockchain. Si vous n'en avez pas, nous recommandons **Rabby**.

1. Ouvrez **botlyz.com** et cliquez sur **« Se connecter »** (ou « Connect wallet »).
2. Sélectionnez votre wallet et **signez** le message qui s'affiche.
3. Cette signature est **gratuite**, **hors chaîne** (aucune transaction, aucun frais) et prouve simplement que ce wallet est bien le vôtre.

> **Important** : signer ce message ne donne à Botlyz **aucun accès** à votre argent. C'est juste une façon de vous identifier, sans email ni mot de passe.

✅ Pour le détail (choix du wallet, sécurité de la signature), voir [Connecter votre wallet](/docs/pour-demarrer/installation-pas-a-pas/connecter-votre-wallet.md).

## Étape 2 : Créer votre compte Hyperliquid

Vous avez maintenant besoin d'un compte sur la plateforme de trading Hyperliquid.

1. Ouvrez [app.hyperliquid.xyz](https://app.hyperliquid.xyz).
2. **Connectez votre wallet** (le même que celui utilisé pour Botlyz, de préférence) et signez pour confirmer.

Votre compte Hyperliquid est simplement votre wallet : il n'y a pas de compte séparé à créer, il s'active au premier dépôt.

## Étape 3 : Déposer des fonds

Votre capital de trading est en **USDC** (une monnaie stable adossée au dollar), et doit être disponible pour les **perpétuels**.

1. Sur Hyperliquid, cliquez sur **« Deposit »** et choisissez votre moyen : dépôt d'USDC depuis **Arbitrum** (le réseau le plus courant), ou depuis une plateforme d'échange.
2. Vérifiez que le montant apparaît bien dans votre solde **Perps** :
   * Si votre compte est en mode **standard** et que l'USDC est arrivé en **Spot**, utilisez le bouton **« Transfer »** pour le basculer vers **Perps**.
   * Si votre compte est en mode **« unified »**, votre USDC compte automatiquement comme marge de trading, rien à faire.

> **Important** : tant que votre solde Perps (ou unified) est à zéro, les stratégies ne pourront pas trader.

## Étape 4 : Créer votre clé API (agent) et la connecter à Botlyz

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. Ouvrez [app.hyperliquid.xyz/API](https://app.hyperliquid.xyz/API) (menu **More → API**).
2. Donnez un nom à votre agent (par exemple « botlyz ») puis cliquez sur **« Generate »**.
3. La **clé privée** de l'agent s'affiche à l'écran **une seule fois** : copiez-la immédiatement et gardez-la en lieu sûr. (Si vous fermez la page sans la copier, générez simplement un nouvel agent.)
4. Cliquez sur **« Authorize API Wallet »** et signez avec votre wallet.
5. Dans Botlyz, allez dans **Comptes**, cliquez sur **« + Connecter un compte »** (onglet **Hyperliquid**), et renseignez :
   * L'**adresse de votre wallet** (le compte maître, pré-remplie avec votre wallet connecté).
   * La **clé privée API (agent)** que vous venez de copier.
6. Botlyz vérifie en direct que l'agent est bien autorisé pour votre wallet, puis **chiffre** la clé (elle n'est jamais stockée en clair).

> **Important** : un API wallet Hyperliquid **ne peut que trader**, c'est ainsi par conception. **Aucun retrait, aucun transfert vers une adresse externe n'est possible.** Botlyz n'a jamais accès à votre wallet propriétaire.

✅ Pour le détail (modes de compte, expiration de l'agent, FAQ), voir [Connecter un compte Hyperliquid](/docs/pour-demarrer/installation-pas-a-pas/connecter-un-compte-hyperliquid.md).

## Étape 5 : Approuver les frais d'intégration

Avant de déployer votre première stratégie sur ce compte, Botlyz vous demande d'**approuver le frais d'intégration** : **0,10 %** (soit 10 points de base) prélevés automatiquement sur chaque ordre (c'est le plafond fixé par le protocole Hyperliquid, les « builder codes »).

1. Botlyz génère un **message à signer** (hors chaîne, gratuit) pour votre wallet maître.
2. Vous le **signez** avec votre wallet.
3. Hyperliquid enregistre votre approbation. C'est à faire **une seule fois par compte**, et c'est **révocable à tout moment** côté Hyperliquid.

> **Important** : approuver ces frais **ne déplace aucun fonds**. Il s'agit d'un frais du protocole, prélevé et reversé par la plateforme au fil des ordres, ce n'est **pas** une facture ni une commission sur vos gains.

✅ Pour le détail du modèle de frais, voir [Frais](/docs/fonctionnement/frais.md).

## Étape 6 : Choisir ou construire une stratégie, la configurer, la backtester

Vous êtes prêt à créer votre première stratégie. Deux chemins possibles :

* **Choisir au catalogue** : partez d'une stratégie prête à l'emploi. Voir [Vue d'ensemble des stratégies](/docs/strategies/vue-d-ensemble.md).
* **Construire dans le Builder** : assemblez vos propres règles, sans écrire de code, à l'aide d'indicateurs. Voir [Le Builder](/docs/strategies/le-builder.md).

Ensuite, **configurez** votre stratégie :

1. Sélectionnez **Hyperliquid** comme exchange, puis choisissez la **paire** à trader (par exemple BTC).
2. Réglez le **capital** alloué, le **levier** (l'effet multiplicateur, à manier avec prudence) et l'**allocation** (la part de votre capital engagée). Voir [Paramètres de risque](/docs/strategies/parametres-de-risque.md).
3. Lancez un **backtest** : Botlyz rejoue vos règles sur les données passées **d'Hyperliquid** pour vous montrer comment la stratégie se serait comportée. Voir [Backtest](/docs/strategies/backtest.md).

> **Important** : un backtest décrit le **passé**, jamais l'avenir. Il aide à comprendre le comportement d'une stratégie, il ne promet aucun résultat. Un **capital minimum tradable** est requis selon la paire et vos réglages (Hyperliquid impose un minimum d'environ 10 $ par ordre) ; Botlyz l'affiche avant le déploiement (voir la page [Déployer une stratégie](/docs/pour-demarrer/installation-pas-a-pas/deployer-une-strategie.md)).

## Étape 7 : Signer et déployer

Quand votre configuration vous convient, vous la **validez** de façon sécurisée.

1. Botlyz vous présente un récapitulatif de votre configuration (l'exchange choisi y figure).
2. Vous la **signez** (signature **EIP-712** : une signature lisible et détaillée, **hors chaîne** et gratuite, qui verrouille exactement vos paramètres).
3. Vous **cochez** les cases de reconnaissance des risques.
4. Vous cliquez sur **« Déployer »**. La stratégie devient active et commence à passer des ordres selon vos règles.

> **Important** : signer ne déplace aucun fonds. C'est votre approbation formelle et vérifiable de la configuration exacte que le logiciel exécutera.

✅ Pour le détail du déploiement (vérifications, parcours SIGMA et Builder), voir [Déployer une stratégie](/docs/pour-demarrer/installation-pas-a-pas/deployer-une-strategie.md). Pour comprendre la signature, voir [Signature et transparence](/docs/fonctionnement/signature-et-transparence.md).

## Étape 8 : Suivre au dashboard

Une fois déployée, votre stratégie se pilote depuis le **dashboard** (tableau de bord) de Botlyz.

* **Suivre** : positions ouvertes, solde et historique des trades s'affichent en direct.
* **Mettre en pause / reprendre** : vous gardez la main à tout moment.
* **Éditer** : modifiez les paramètres si besoin (une nouvelle signature vous sera demandée).

> 👉 De temps en temps, le **moteur** de Botlyz est mis à jour (améliorations, corrections). Quand cela arrive, il vous suffit de **re-signer** votre stratégie avec les **mêmes paramètres** : rien ne change dans votre configuration, c'est une simple confirmation de sécurité.

## Checklist récapitulative

✅ Wallet connecté à Botlyz (signature de connexion effectuée). ✅ Compte Hyperliquid actif (wallet connecté sur app.hyperliquid.xyz). ✅ USDC déposé et disponible en Perps (ou compte en mode unified). ✅ API wallet (agent) généré, autorisé et connecté à Botlyz. ✅ Frais d'intégration (0,10 %) approuvés une fois pour ce compte. ✅ Stratégie choisie ou construite, configurée et backtestée sur Hyperliquid. ✅ Configuration signée (EIP-712) et stratégie déployée. ✅ Suivi en place au dashboard (pause / reprise / édition maîtrisées).

## Questions fréquentes

**Q. Dois-je faire toutes ces étapes dans l'ordre ?**

Oui, l'ordre compte. En particulier, le **dépôt** (étape 3) est nécessaire pour que les stratégies puissent trader, et l'approbation des frais (étape 5) est demandée avant votre premier déploiement.

**Q. Botlyz peut-il retirer mon argent ?**

Non, jamais. L'API wallet (agent) que vous confiez à Botlyz **ne peut que trader** : aucun retrait ni transfert vers une adresse externe n'est possible, c'est une règle du protocole Hyperliquid lui-même.

**Q. Mon solde affiche 0 $ alors que j'ai déposé, pourquoi ?**

Votre USDC est probablement en **Spot** alors que votre compte est en mode standard : utilisez le bouton **« Transfer »** sur Hyperliquid pour le basculer vers **Perps**. (En mode « unified », ce basculement est automatique.)

**Q. La clé de l'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 un nouvel agent et mettez à jour la clé dans Botlyz.

**Q. Que se passe-t-il quand le moteur de Botlyz est mis à jour ?**

Votre stratégie vous demande de **re-signer** avec les mêmes paramètres. C'est une confirmation de sécurité : votre configuration reste identique, aucun fonds n'est déplacé.

**Q. Puis-je arrêter une stratégie à tout moment ?**

Oui. Depuis le dashboard, vous pouvez la mettre en pause, la reprendre, l'éditer ou la supprimer quand vous le souhaitez. Vous gardez le contrôle en permanence.


---

# 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/installation-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.