> 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-lighter.md). # Connecter votre compte à Botlyz (clé API) ## Avant de commencer Pour trader avec Botlyz, vous devez connecter un compte Lighter (un compte sur le DEX perpétuel Lighter). Cette page explique comment ajouter un compte d'exchange et générer une clé API sécurisée. Avant de suivre cette page, assurez-vous d'avoir préparé votre compte Lighter : * [Créer un compte Lighter](/docs/pour-demarrer/installation-pas-a-pas/creer-un-compte-lighter.md) : ouvrir un compte sur Lighter et connecter votre wallet. * [Déposer des fonds sur Lighter](/docs/pour-demarrer/installation-pas-a-pas/deposer-des-fonds.md) : alimenter votre compte en collatéral (USDC). * [Comprendre L1 et L2](/docs/securite-and-aide/comprendre-l1-l2.md) : la différence entre votre wallet (L1) et votre compte de trading Lighter (L2). Si vous débutez, suivez plutôt le [guide d'installation pas à pas](/docs/pour-demarrer/installation-pas-a-pas.md), qui reprend toutes ces étapes dans l'ordre. > **Important** : Botlyz est un **éditeur de logiciel** d'automatisation, pas un gestionnaire de fonds. L'outil est **non-custodial** : vous conservez le **contrôle total** de votre capital et de vos clés. Les stratégies s'exécutent sous votre responsabilité, à partir d'une configuration que vous signez vous-même (EIP-712). Le trading comporte un risque de perte, et les performances passées ne préjugent pas des résultats futurs. ## Clé API Lighter : qu'est-ce que c'est ? Une **clé API Lighter** est un identifiant technique qui permet au logiciel de placer et d'annuler des ordres sur votre compte Lighter, en appliquant strictement les règles que vous avez configurées et signées. Elle est composée de deux parties : 1. **Index de clé** (4 à 254) : un numéro que vous choisissez pour identifier cette clé. 2. **Clé privée** : une longue chaîne de caractères hexadécimale qui signe les ordres. ### Sécurité : clé « trade-only » Botlyz **ne peut que placer et annuler des ordres** avec cette clé. Elle **ne peut pas** : * Retirer des fonds de votre compte. * Transférer votre collatéral. * Modifier les paramètres de votre compte. * Voir vos autres clés API. C'est ce qu'on appelle une clé **« trade-only »** ou « limitée aux ordres ». Aucun retrait n'est donc possible avec la clé confiée à Botlyz. ## Prérequis ### Avoir un compte Lighter 1. Créez votre compte Lighter via notre lien de parrainage : [app.lighter.xyz/?referral=BOTLYZ](https://app.lighter.xyz/?referral=BOTLYZ). 2. Connectez-vous avec votre wallet (le même que celui utilisé pour Botlyz). Voir [Connecter votre wallet](/docs/pour-demarrer/installation-pas-a-pas/connecter-votre-wallet.md). 3. Déposez du collatéral sur votre compte Lighter. Pour déposer des fonds, voir [Déposer des fonds sur Lighter](/docs/pour-demarrer/installation-pas-a-pas/deposer-des-fonds.md). ### Capital minimum Le capital minimum dépend de **la paire que vous tradez** : * Chaque paire a une **taille d'ordre minimale** (en USD), définie par Lighter. Par exemple, certaines paires demandent un minimum de 20 à 50 USD par ordre. * Botlyz recalcule ce minimum en fonction de votre levier et de votre allocation. * Avant de déployer une stratégie, Botlyz affiche le **capital tradable minimum requis** et votre capital actuel. Exemple : * Paire HYPE, minimum 50 USD, levier 5x, allocation 50 % : capital tradable minimum 500 USD, soit un capital requis d'environ 100 USD. Botlyz vous empêche de déployer une stratégie si votre capital est insuffisant. ## Générer une clé API Lighter Cette clé se crée **chez Lighter**, pas dans Botlyz. Prévoyez de noter **trois informations** que vous saisirez ensuite dans Botlyz : votre **adresse Ethereum**, l'**index de clé** et la **clé privée**. > 👉 Créez votre clé directement sur [app.lighter.xyz/apikeys](https://app.lighter.xyz/apikeys) (chez Lighter : **Settings** puis **API Keys**). L'index de clé doit être compris entre **4 et 254** (les index 0 à 3 sont réservés par Lighter pour ses propres applications). 1. Ouvrez [app.lighter.xyz/apikeys](https://app.lighter.xyz/apikeys) et connectez-vous à Lighter avec votre wallet (celui que vous utilisez déjà pour Botlyz). 2. Cliquez sur le bouton **« Generate API Key »**. 3. Choisissez un **index de clé** libre, entre **4 et 254** (par exemple, 4). Les index **0 à 3 sont réservés** par Lighter pour ses propres applications : ne les utilisez pas. C'est le **seul réglage à faire** : il n'y a **aucune permission à choisir**. Une clé API Lighter ne peut de toute façon **que trader, jamais retirer** vos fonds. Notez l'index choisi, il vous sera redemandé. 4. Si Lighter vous le demande, **signez** avec votre wallet pour confirmer (opération gratuite, hors chaîne). 5. Lighter affiche alors la **clé privée** (elle peut n'apparaître qu'**une seule fois**). **Copiez-la immédiatement** et conservez-la dans un endroit sûr (par exemple un gestionnaire de mots de passe). 6. Notez aussi votre **adresse Ethereum** (elle commence par `0x`) : c'est l'adresse publique de votre wallet, visible dans Lighter et dans votre wallet. À la fin, vous devez avoir sous la main **trois éléments** : votre **adresse Ethereum** (`0x...`), l'**index de clé** (entre 4 et 254) et la **clé privée** (longue chaîne hexadécimale). Ils vous seront demandés à l'étape suivante. > **Attention** : ne fermez pas cette page sans avoir copié votre clé privée. Lighter ne l'affiche qu'une seule fois : si vous la perdez, vous ne pourrez pas la récupérer et devrez créer une nouvelle clé. ## Connecter la clé à Botlyz ### Par l'interface Botlyz 1. Allez dans **Paramètres** puis **Comptes d'exchange** (ou l'équivalent). 2. Cliquez sur **« Ajouter un compte Lighter »**. 3. Remplissez : * **Étiquette** : un nom pour ce compte (ex. « Mon compte principal »). * **Adresse Ethereum** : l'adresse publique du wallet Lighter (ex. `0x1234...`). * **Index de clé** : le numéro que vous avez choisi chez Lighter (ex. 4). * **Clé privée** : collez la clé privée copiée depuis Lighter. 4. Botlyz **vérifie immédiatement** la clé auprès de Lighter. * Si la clé est valide, elle est acceptée et **chiffrée au repos** (jamais stockée en clair). * Si elle est invalide ou expirée, Botlyz rejette la connexion avec un message d'erreur. 5. Une fois connecté, le compte apparaît dans votre liste de comptes. ### Sous-comptes Lighter Lighter prend en charge les **sous-comptes** (sous-comptes isolés rattachés à la même adresse Ethereum). Par exemple : * Compte principal : votre compte Lighter par défaut. * Sous-compte 1 : collatéral isolé pour une stratégie. * Sous-compte 2 : collatéral isolé pour une autre stratégie. Botlyz détecte automatiquement le sous-compte associé à votre clé API lors de la connexion. Si vous avez plusieurs sous-comptes, vous pouvez connecter une clé pour chacun d'eux (avec des étiquettes différentes). ## Sécurité de votre clé API ### Chez Botlyz * Votre clé privée est **chiffrée immédiatement** après vérification (chiffrement fort au repos). * Elle n'est **jamais stockée en clair** et **jamais loggée**. * Seul le serveur Botlyz qui exécute vos stratégies peut la déchiffrer. * Si vous supprimez le compte Lighter, la clé est supprimée de la base de données. ### Chez Lighter * La clé existe sur le registre Lighter. Si vous la révoquez chez Lighter, Botlyz ne peut plus l'utiliser. * Vous pouvez révoquer une clé à tout moment, sans avertissement préalable à Botlyz (les stratégies cesseront alors de fonctionner). ### Bonnes pratiques 1. **Utilisez une clé dédiée à Botlyz.** Ne partagez pas la même clé avec d'autres services. 2. **Gardez un collatéral modeste** sur ce sous-compte. Plus le collatéral est faible, plus le risque est limité en cas de compromission de la clé. 3. **Révoquez la clé si** : * Vous n'utilisez plus Botlyz. * Vous suspectez une fuite. * Vous changez de stratégie ou de venue. 4. **Ne partagez jamais votre clé privée** avec qui que ce soit, y compris le support Botlyz. ## Après la connexion ### Approbation du frais de protocole Avant de déployer votre première stratégie sur ce compte, vous devez **approuver le frais de protocole** : **10 bps (0,10 %)** prélevés automatiquement sur chaque ordre via le programme « partner attribution » de Lighter, plafonné à 10 bps. Il s'agit d'un **frais du protocole, prélevé et reversé par la plateforme, ce n'est PAS une facture ni une commission Botlyz**. Ce processus : 1. Génère un message à signer (hors chaîne, gratuit). 2. Vous le signez avec votre wallet. 3. Botlyz enregistre votre approbation. Vous ne devez l'approuver qu'une fois par compte ou sous-compte. Pour le détail du modèle de frais, voir [Frais](/docs/fonctionnement/frais.md). ### Voir votre solde Dans Botlyz, allez dans **Comptes** et cliquez sur le compte Lighter. Vous verrez : * Le collatéral disponible (USD). * Les positions ouvertes. * L'historique des trades. Le solde est récupéré en temps réel via l'API Lighter authentifiée. ## Gérer plusieurs comptes Lighter Vous pouvez connecter plusieurs comptes ou sous-comptes Lighter à Botlyz : * Chacun reçoit une étiquette distincte. * Chaque stratégie s'exécute sur **un seul compte** (pas de multi-compte par stratégie). * Les allocations sont **indépendantes par compte** (une stratégie à 80 % sur le compte A, une autre à 80 % sur le compte B : c'est possible). ## Modifier ou supprimer un compte ### Renommer un compte 1. Allez dans **Paramètres** puis **Comptes**. 2. Cliquez sur l'icône d'édition (crayon). 3. Changez l'étiquette et validez. ### Mettre à jour la clé API 1. Si votre clé API est expirée ou compromise, créez-en une nouvelle chez Lighter. 2. Dans Botlyz, cliquez sur le compte, puis sur **« Mettre à jour la clé »**. 3. Entrez la nouvelle clé privée et le nouvel index. 4. Botlyz vérifie et met à jour. ### Supprimer un compte 1. Allez dans **Paramètres** puis **Comptes**. 2. Cliquez sur le compte, puis sur **« Supprimer »**. 3. Si des stratégies sont actives, Botlyz les arrête (toutes les positions sont fermées). 4. Une fois toutes les positions fermées, le compte est supprimé. ## Dépannage ### « Clé API invalide » * Vérifiez que vous avez copié **intégralement** la clé privée (sans espaces supplémentaires). * Vérifiez que l'**index de clé** est correct (celui que vous avez choisi chez Lighter). * Si la clé a été révoquée chez Lighter, créez-en une nouvelle et réessayez. ### « Sous-compte introuvable » * Vous avez saisi un index de sous-compte qui n'existe pas pour votre adresse Ethereum. * Vérifiez l'index exact chez Lighter (Paramètres puis Sous-comptes). ### « Aucun compte Lighter pour cette adresse » * L'adresse Ethereum ne correspond pas à un compte Lighter valide. * Vérifiez que vous avez créé un compte Lighter et déposé du collatéral. * Utilisez la même adresse que celle avec laquelle vous êtes connecté à Lighter. ### « Solde momentanément indisponible » * L'API Lighter est temporairement indisponible. * Attendez quelques secondes et réessayez. * Si le problème persiste, vérifiez l'état de Lighter sur ses canaux officiels. ## Questions fréquentes **Q. Peut-on connecter le même compte Lighter à plusieurs utilisateurs Botlyz ?** Non. Chaque compte Lighter ne peut être connecté qu'à **un seul wallet Botlyz**. Si vous avez besoin d'une séparation, créez des sous-comptes chez Lighter. **Q. Cette clé API peut-elle retirer mes fonds ?** Non. Une clé API Lighter ne peut **que trader** : elle ne permet **aucun retrait** vers une adresse externe. Il n'y a d'ailleurs aucune permission à régler à sa création, c'est ainsi par nature. Vos fonds ne peuvent revenir que vers votre propre wallet, et c'est vous qui déclenchez le retrait sur Lighter. **Q. Combien de clés puis-je connecter ?** Autant que vous le souhaitez. Vous pouvez avoir une clé par stratégie, une clé par sous-compte, etc. Botlyz gère cela de façon transparente. **Q. Que se passe-t-il si je révoque la clé API chez Lighter ?** Vos stratégies Botlyz cesseront de fonctionner (les ordres ne seront plus placés). Botlyz n'a aucun moyen de savoir que la clé est révoquée tant que l'API Lighter ne refuse pas la requête. **Q. Botlyz prélève-t-il des frais en plus de ceux de Lighter ?** Le seul frais de Botlyz est le **frais de protocole de 10 bps (0,10 %)**, prélevé automatiquement sur chaque ordre via le programme « partner attribution » de Lighter et plafonné à 10 bps. C'est un **frais du protocole, prélevé et reversé par la plateforme, ce n'est PAS une facture ni une commission Botlyz**. Botlyz ne prélève **aucune commission sur vos gains**. Par ailleurs, les frais propres de la plateforme Lighter (trading, funding) s'appliquent indépendamment de Botlyz. Voir [Frais](/docs/fonctionnement/frais.md). **Q. Ma clé API est-elle utilisée pour autre chose que les ordres ?** Non. Elle sert uniquement à : * Placer des ordres (limit ou market). * Annuler des ordres. * Lire votre solde et vos positions (pour le calcul du PnL). Elle ne peut pas retirer des fonds. --- # 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-lighter.md?ask=&goal= ``` `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.