> 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-lighter.md).

# Installation de A à Z : Lighter

Cette page vous accompagne **du tout début jusqu'à votre première stratégie automatisée sur Lighter**. 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 Hyperliquid ? Suivez plutôt [Installation de A à Z : Hyperliquid](/docs/pour-demarrer/installation-pas-a-pas/installation-hyperliquid.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 :

* **Lighter** : la plateforme de trading. C'est une place de marché de **perpétuels** (des contrats qui suivent le prix d'un actif, sans date d'échéance), construite sur une **surcouche** rapide et peu coûteuse au-dessus d'Ethereum. 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 Lighter, en suivant exactement la configuration que vous avez validée.

> 👉 En résumé : votre argent reste chez **vous** et sur **Lighter**. 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 Lighter

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

1. Ouvrez notre lien de création de compte : [app.lighter.xyz/?referral=BOTLYZ](https://app.lighter.xyz/?referral=BOTLYZ).
2. **Connectez votre wallet** (le même que celui utilisé pour Botlyz, de préférence) et **signez** pour confirmer.

> **Important** : à ce stade, votre **compte de trading n'existe pas encore**. Sur Lighter, votre wallet est le « propriétaire » (la couche du dessus) ; le **sous-compte de trading** dédié, lui, ne sera créé qu'au **premier dépôt** (voir l'étape suivante). C'est normal si vous ne voyez pas encore de solde.

✅ Pour le détail, voir [Créer un compte Lighter](/docs/pour-demarrer/installation-pas-a-pas/creer-un-compte-lighter.md).

## Étape 3 : Déposer des fonds

Le dépôt sert deux buts : il **crée votre sous-compte de trading** et il l'alimente en capital (en **USDC**, une monnaie stable adossée au dollar).

1. Sur Lighter, ouvrez [app.lighter.xyz/portfolio](https://app.lighter.xyz/portfolio) puis cliquez sur **« Deposit »** (Déposer).
2. Choisissez le moyen qui vous convient :
   * **« Cash »** : par carte bancaire ou virement (pratique si vous n'avez pas encore de crypto).
   * **« Connect exchange »** : reliez une plateforme d'échange (par exemple Binance) pour transférer vos fonds.
   * **« Transfer crypto »** : envoyez de la crypto depuis un wallet, en choisissant le **token** et la **blockchain** ; à la réception à l'adresse affichée, le montant est **converti automatiquement en USDC** sur Lighter.
3. Validez le dépôt et attendez qu'il apparaisse dans votre portefeuille Lighter.

> **Important** : c'est **ce premier dépôt qui crée votre sous-compte de trading**. Tant que vous n'avez pas déposé, les étapes suivantes ne pourront pas aboutir.

✅ Pour le détail des moyens de dépôt, voir [Déposer des fonds](/docs/pour-demarrer/installation-pas-a-pas/deposer-des-fonds.md).

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

Une **clé API** est un identifiant technique qui autorise Botlyz à passer des ordres sur votre sous-compte de trading, **et rien d'autre**.

1. Sur Lighter, ouvrez [app.lighter.xyz/apikeys](https://app.lighter.xyz/apikeys).
2. Cliquez sur **« Generate API Key »**, puis choisissez un **index** compris entre **4 et 254** (les index 0 à 3 sont réservés par Lighter). Il n'y a **aucune permission à choisir** : une clé API Lighter ne peut de toute façon que trader, jamais retirer.
3. Lighter affiche la **clé privée une seule fois** : copiez-la et gardez-la en lieu sûr avant de fermer la page.
4. Dans Botlyz, allez dans **Comptes**, cliquez sur **« + Connecter un compte »** (onglet **Lighter**), et renseignez :
   * Votre **adresse Ethereum** (celle de votre wallet).
   * L'**index de clé** choisi (par exemple 4).
   * La **clé privée** que vous venez de copier.
5. Botlyz vérifie la clé auprès de Lighter, puis la **chiffre** (elle n'est jamais stockée en clair).

> **Important** : cette clé contrôle **uniquement** le sous-compte de trading, donc elle **ne peut que trader**. **Aucun retrait vers une adresse externe n'est possible.** Botlyz n'a jamais accès à votre wallet propriétaire, et un retrait ne peut revenir **que vers votre propre wallet**, déclenché **par vous** sur Lighter.

✅ Pour le détail (permissions, sous-comptes, bonnes pratiques de sécurité), voir [Connecter votre compte à Botlyz](/docs/pour-demarrer/installation-pas-a-pas/connecter-un-compte-lighter.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.

1. Botlyz génère un **message à signer** (hors chaîne, gratuit).
2. Vous le **signez** avec votre wallet.
3. Botlyz enregistre votre approbation. C'est à faire **une seule fois par compte**.

> **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. Choisissez la **paire** à trader (par exemple HYPE).
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 des données passées 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 ; 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 Lighter créé via le lien de parrainage. ✅ Fonds déposés sur Lighter (le sous-compte de trading est créé). ✅ Clé API « trade-only » (index 4 à 254) créée et connectée à Botlyz. ✅ Frais d'intégration (0,10 %) approuvés une fois pour ce compte. ✅ Stratégie choisie ou construite, configurée et backtestée. ✅ 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) crée le sous-compte de trading nécessaire à la clé API (étape 4), et l'approbation des frais (étape 5) est demandée avant votre premier déploiement.

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

Non, jamais. La clé API que vous confiez à Botlyz **ne peut que trader**. Aucun retrait vers une adresse externe n'est possible, et un retrait ne peut revenir qu'à votre propre wallet, déclenché par vous sur Lighter.

**Q. Combien de temps prend l'installation ?**

Comptez environ 15 à 20 minutes la première fois. Une fois votre compte et votre clé en place, déployer une nouvelle stratégie ne prend que quelques minutes.

**Q. Pourquoi mon compte Lighter semble « vide » après sa création ?**

C'est normal : votre **sous-compte de trading** n'est créé qu'au **premier dépôt**. Déposez des fonds (étape 3) et le solde apparaîtra.

**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-lighter.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.