> 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/deployer-une-strategie.md). # Déployer une stratégie Ce guide décrit le processus complet de déploiement d'une stratégie de trading automatisé sur Botlyz, du choix initial jusqu'à l'exécution en direct. > **Avertissement** : le trading comporte un risque de perte, pouvant aller jusqu'à la totalité du capital engagé. Les performances passées ne préjugent pas des performances futures. Botlyz est un éditeur de logiciel d'automatisation, pas un conseiller financier. Vous restez seul responsable de votre configuration et de votre capital. ## Vue d'ensemble du processus Le déploiement d'une stratégie suit toujours le même chemin, que vous choisissiez une stratégie exclusive SIGMA ou une stratégie du Builder : 1. **Choix de la stratégie** (exclusive SIGMA ou Builder no-code) 2. **Configuration** (paire, paramètres de stratégie, paramètres de risque) 3. **Vérifications pré-déploiement** (capital suffisant, allocation totale, conflit de paire) 4. **Signature EIP-712** (confirmation sécurisée de votre configuration, sans transaction blockchain) 5. **Activation et exécution** (les ordres se placent à la clôture de bougie) Deux parcours sont possibles. Le parcours **(A)** déploie une stratégie exclusive SIGMA, prête à l'emploi sur HYPE. Le parcours **(B)** déploie une stratégie que vous construisez ou personnalisez dans le Builder, sur la paire de votre choix. Les deux passent par les mêmes vérifications et la même signature. *** ## Parcours A. Déployer une stratégie exclusive SIGMA ### A.1. Choisir SIGMA v2 ou SIGMA v2.1 Botlyz propose deux stratégies propriétaires sur **Lighter DEX** (zkLighter), une place de marché décentralisée en contrats perpétuels : | Stratégie | Logique | Paire | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | | **SIGMA v2** | Mean-reversion à enveloppe de moyenne mobile. Entre quand le prix s'écarte de l'enveloppe, sort au retour vers la moyenne. Ordres LIMIT, stop-loss fixe. | **HYPE** | | **SIGMA v2.1** | Identique à v2, plus un **filtre RSI anti-momentum** : aucune entrée tant que le RSI reste dans sa bande neutre (pas d'entrée en momentum trop marqué). | **HYPE** | Les deux stratégies tradent **HYPE uniquement** : c'est la seule paire, elle est **fixée et non modifiable**. Il n'existe pas d'autre version (pas de variante multi-paires, ni de paliers de capital). Le détail de fonctionnement est présenté dans la page [Stratégies exclusives SIGMA](/docs/strategies/strategies-exclusives-sigma.md). Aucune de ces stratégies ne garantit de résultat. La logique décrite explique le mécanisme d'entrée et de gestion, pas une promesse de gain. ### A.2. Configurer les paramètres de stratégie Les paramètres sont **préremplis** avec les valeurs par défaut et restent **modifiables** avant signature. **SIGMA v2** : | Paramètre | Valeur par défaut | Plage | | ------------- | ----------------- | -------------------- | | Période MA | 140 | 20 à 400 | | Enveloppe (%) | 3 % | 0,5 % à 15 % | | Timeframe | 5 min | 5 min / 15 min / 1 h | **SIGMA v2.1** : mêmes paramètres que v2, avec en plus le filtre RSI. | Paramètre | Valeur par défaut | Plage | | --------------- | ----------------- | ------- | | Période RSI | 80 | 5 à 200 | | RSI borne basse | 42 | 0 à 100 | | RSI borne haute | 58 | 0 à 100 | Tant que le RSI reste entre la borne basse et la borne haute, la stratégie n'ouvre pas de nouvelle position. ### A.3. Régler les paramètres de risque Trois familles de réglages déterminent votre exposition. Elles sont détaillées dans la page [Paramètres de risque](/docs/strategies/parametres-de-risque.md). **Levier (1 à 20)** Le levier multiplie votre capital pour augmenter la taille des positions. Formule : `Capital tradable = Capital × Levier × Allocation (%)` Exemple sur HYPE : * Capital : 100 USDC * Levier : 2 * Allocation : 100 % * Capital tradable : 100 × 2 × 1,0 = **200 USDC** Points importants : * Levier plus élevé = position plus grande = risque plus grand. * HYPE a un levier maximum propre selon son margin requirement Lighter. Si vous demandez plus, il est réduit automatiquement. * Levier minimum : **1** (pas d'effet de levier). Un levier de 1 ne produit aucun effet de levier. Plus le levier augmente, plus la taille de position et le risque de liquidation augmentent, et plus le seuil de liquidation se rapproche du prix d'entrée. Botlyz ne recommande aucune valeur : le choix du levier relève de votre décision, selon votre propre analyse. **Allocation (1 % à 100 %)** L'allocation est le pourcentage du capital du compte dédié à cette stratégie. La valeur par défaut de SIGMA est **100 %**. Points importants : * L'allocation **totale par compte** ne peut pas dépasser 100 %. * Vous pouvez avoir plusieurs stratégies sur un même compte tant que le total reste inférieur ou égal à 100 %. * Allocation 100 % : tout le capital du compte est utilisé par cette stratégie. L'allocation est un pourcentage que vous fixez entre 1 % et 100 %. Plus l'allocation est élevée, plus la part de votre solde exposée à cette stratégie est grande. Botlyz ne recommande aucune valeur : le choix relève de votre décision. **Stop-loss et slippage** | Réglage | Valeur par défaut | Plage | | --------------- | ----------------- | ---------- | | Stop-loss (%) | 11 % | 1 % à 50 % | | Slippage SL (%) | 10 % | 1 % à 50 % | | Slippage TP (%) | 10 % | 1 % à 50 % | * **Stop-loss (%)** : perte maximale par position avant coupe automatique. * **Slippage SL (%)** : tolérance de glissement à l'exécution du stop-loss. L'ordre accepte ce glissement maximal au-delà du niveau pour être sûr de remplir en cas de gap. * **Slippage TP (%)** : tolérance de glissement à l'exécution du take-profit, pour augmenter la probabilité d'exécution. ### A.4. Vérifications, signature, activation Une fois la configuration prête, le déploiement passe par les vérifications décrites dans l'**Étape commune** plus bas (capital suffisant, allocation totale, conflit de paire), puis par la **signature EIP-712**, puis par l'**activation**. *** ## Parcours B. Déployer une stratégie du Builder ### B.1. Construire ou choisir une stratégie générique Le **Builder** vous permet de composer votre propre stratégie à partir d'indicateurs, ou de partir d'un preset générique prêt à personnaliser. Voir [Le Builder](/docs/strategies/le-builder.md). Contrairement à SIGMA, une stratégie du Builder est **entièrement configurable**, y compris sa paire. ### B.2. Choisir la paire et le timeframe * **Paire** : choisissez **une** paire parmi les marchés disponibles sur Lighter. La paire par défaut est **BTC**. Vous pouvez sélectionner une autre paire connue, par exemple **ETH**, **SOL** ou **HYPE**. * **Timeframe** : les signaux et les entrées se calculent à la clôture de la bougie du timeframe choisi. Une paire ne peut être utilisée que par une seule stratégie à la fois sur un même compte (voir la vérification de conflit de paire plus bas). ### B.3. Définir les conditions et le risque * **Conditions d'entrée et de sortie** : combinez des indicateurs (moyennes mobiles, RSI, MACD, Bollinger, etc.) avec des opérateurs ET / OU pour définir quand entrer en long, en short, et quand sortir. * **Stop-loss et take-profit** : par défaut, les stratégies génériques sortent par leurs conditions de sortie. Vous pouvez ajouter un stop-loss et un take-profit avant de signer. * **Levier et allocation** : mêmes plages que pour SIGMA (levier 1 à 20, allocation 1 % à 100 %). ### B.4. Backtester avant de déployer Avant de déployer, **testez votre stratégie avec un backtest**. Un backtest rejoue la stratégie sur l'historique réel du marché (frais et slippage inclus) : vous voyez combien de trades elle aurait pris, son rendement et ses pires baisses, sans risquer un centime. Les performances passées ne préjugent pas du futur, mais c'est le meilleur moyen de comprendre le comportement de votre configuration. Voir la page [Backtest](/docs/strategies/backtest.md). ### B.5. Vérifications, signature, activation Comme pour SIGMA, le déploiement passe ensuite par les vérifications, la signature EIP-712 et l'activation décrites ci-dessous. *** ## Étape commune. Vérifications avant déploiement Avant de valider, Botlyz effectue plusieurs **vérifications** pour éviter les configurations inexploitables. Ces contrôles s'appliquent à SIGMA comme aux stratégies du Builder. ### Vérification 1 : capital suffisant Botlyz vérifie que votre **capital tradable** permet de placer les ordres de la stratégie au-dessus de la taille minimale d'ordre exigée par Lighter. Chaque ordre sur Lighter a une **taille minimale** (le minimum notionnel de la paire, soit de l'ordre de 10 à 17 USDC selon la paire et son prix). Botlyz compare votre capital tradable à un minimum requis, calculé avec une marge de sécurité pour absorber les arrondis de taille de lot. Formule (voir `gates.py`) : ``` Capital tradable = Capital × Levier × Allocation (%) Capital tradable requis ≈ 2 × Taille minimale d'ordre de la paire Capital minimum (fonds propres) = Capital tradable requis / (Levier × Allocation) ``` **Exemple sur HYPE (SIGMA, levier 2, allocation 100 %)** : * Supposons une taille minimale d'ordre HYPE de l'ordre de 12 USDC. * Capital tradable requis ≈ 2 × 12 = 24 USDC. * Capital minimum ≈ 24 / (2 × 1,0) = **12 USDC** de fonds propres. Ce chiffre est **indicatif** : la taille minimale réelle dépend du prix de HYPE au moment du déploiement. Botlyz calcule le minimum exact en direct et affiche : * Votre capital disponible (solde du compte), * Le capital minimum requis, * Un message d'erreur si le solde est insuffisant, avec des pistes de solution. ### Vérification 2 : allocation totale inférieure ou égale à 100 % Botlyz additionne l'allocation de **toutes les stratégies actives, en attente ou en pause sur ce compte** et vérifie que le total ne dépasse pas 100 %. Exemple : * Compte Lighter "Main" * Stratégie SIGMA v2.1 : allocation 60 % (OK) * Vous voulez ajouter une stratégie du Builder : allocation 50 % * Total : 110 %, supérieur à 100 %, donc **refusé** * Solution : ramener une allocation à 40 % (40 % + 60 % = 100 %), ou libérer de l'allocation en arrêtant une autre stratégie. ### Vérification 3 : pas de conflit de paire Botlyz vérifie que la **paire de la nouvelle stratégie** n'est pas déjà utilisée par une autre stratégie sur ce compte. Raison : sur Lighter, une paire ne peut être gérée que par une seule stratégie à la fois sur un même compte. Deux stratégies ne peuvent pas piloter la même position. Exemple : * Stratégie 1 (SIGMA v2) : HYPE * Vous voulez déployer une stratégie du Builder sur HYPE également * **Conflit sur HYPE**, donc le déploiement est refusé * Solution : choisir une autre paire pour la stratégie du Builder (par exemple BTC ou ETH), ou utiliser un autre compte Lighter. ### Autres pré-requis du compte Le déploiement exige aussi que le compte soit complet : * **Clé API présente** sur le compte (requise pour exécuter la stratégie). Sinon, complétez votre compte dans la page Comptes. * **Approbation des frais d'intégration (0,10 %)** signée pour ce compte. ### Messages d'erreur et solutions **Capital insuffisant** : ce message indique que le capital tradable (fonds × levier × allocation) est inférieur au minimum requis par la paire sur Lighter. Les paramètres qui influent sur le capital tradable sont les fonds disponibles, l'allocation et le levier. Toute modification relève de votre décision et chaque combinaison comporte ses propres risques (notamment le levier : augmenter le levier ou l'allocation augmente le risque de perte et de liquidation). Botlyz ne recommande aucune de ces options. **Allocation dépassée** : Botlyz indique le pourcentage déjà alloué sur le compte et le total demandé. Solutions : réduire l'allocation de la nouvelle stratégie, ou arrêter/réduire une stratégie existante. **Conflit de paire** : Botlyz indique la paire déjà utilisée et la stratégie qui l'occupe. Solutions : changer la paire (Builder), supprimer la stratégie existante, ou utiliser un autre compte Lighter. **Comment déposer du capital sur Lighter** : 1. Rendez-vous sur [app.lighter.xyz/?referral=BOTLYZ](https://app.lighter.xyz/?referral=BOTLYZ) 2. Connectez-vous avec votre wallet (MetaMask, etc.) 3. Ouvrez la section "Deposit" 4. Sélectionnez USDC 5. Envoyez depuis Ethereum mainnet ou via un bridge 6. Attendez la confirmation (généralement quelques minutes) Voir aussi [Connecter votre compte à Botlyz](/docs/pour-demarrer/installation-pas-a-pas/connecter-un-compte-lighter.md). *** ## Étape commune. Signature EIP-712 Une fois les vérifications passées, vous **confirmez votre configuration** via une signature EIP-712 (signature blockchain hors-chaîne, sans transaction). Le mécanisme est détaillé dans [Signature et transparence](/docs/fonctionnement/signature-et-transparence.md). ### Pourquoi une signature ? Botlyz est un **éditeur de logiciel**, pas un dépositaire de fonds (non-custodial), voir [Sécurité non-custodial](/docs/securite-and-aide/securite-non-custodial.md) : * Vos clés API Lighter sont **trade-only** (lecture et ordres, aucun retrait possible). * Vous gardez le contrôle de vos fonds et de vos clés privées. * La signature EIP-712 prouve que **vous** avez autorisé cette configuration précise. * C'est une preuve d'autorisation, sans coût de gaz. ### Le processus 1. **Botlyz prépare un message** contenant tous les paramètres : la paire, le levier, l'allocation, l'adresse ETH du wallet et un horodatage. 2. **Vous recevez une invitation** à signer la configuration avec votre wallet. 3. **Vous signez** via MetaMask (ou un autre wallet Ethereum) : cliquez sur "Sign". Aucun coût en gaz, aucun envoi de fonds. 4. **Botlyz vérifie la signature** : si elle est valide, la stratégie est déployée. En cas de délai dépassé ou de rejet, retour à l'écran de configuration. ### Points importants * **Pas de transaction blockchain** : la signature est hors-chaîne. * **Pas de frais de gaz.** * **Modifiable ensuite** : une fois déployée, vous pouvez modifier ou supprimer la stratégie via l'interface. Toute modification des paramètres impose une **nouvelle signature** ; l'ancienne instance est arrêtée (ordres annulés, positions fermées) puis remplacée. *** ## Étape commune. Activation et exécution Après la signature, votre stratégie est **déployée et active**. ### Quand l'exécution démarre-t-elle ? La stratégie est active dès la validation, mais les ordres se placent au moment de la **clôture de bougie** : * **SIGMA** : à la clôture de bougie du timeframe choisi (5 min, 15 min ou 1 h). * **Builder** : à la clôture de bougie du timeframe que vous avez sélectionné. Exemple : vous déployez SIGMA en timeframe 5 min à 14h32. Les premiers signaux sont évalués à la prochaine clôture de bougie 5 min, soit 14h35. ### Suivi Une fois la stratégie en cours d'exécution : * **"Mes stratégies"** : statut, PnL, positions ouvertes, ordres. * **Notifications** : ouverture et fermeture de positions, alertes. * **Historique** : l'ensemble des trades, avec détails d'entrée, de sortie et frais. ### Frais Le **seul frais de Botlyz** est un **frais de protocole de 10 bps (0,10 %)**, prélevé automatiquement sur le notionnel de chaque ordre via le programme « partner attribution » de Lighter, et plafonné à 10 bps. Il s'agit d'un frais du protocole : ce n'est ni une facture ni une commission Botlyz. **Botlyz ne prélève aucune commission sur vos gains.** Exemple : pour un ordre d'un notionnel de 100 USDC, le frais de protocole est d'environ 0,10 USDC. Par ailleurs, les frais propres à la plateforme Lighter (frais de trading, funding) s'appliquent indépendamment de Botlyz, selon les règles de Lighter. Le détail est présenté dans la page [Frais](/docs/fonctionnement/frais.md). ### Pause, reprise et suppression **Pause** : la stratégie cesse de placer de nouveaux ordres. Les positions ouvertes restent ouvertes. Vous pouvez reprendre plus tard. **Reprise** : la stratégie redémarre. De nouvelles positions peuvent s'ouvrir dès la prochaine clôture de bougie. **Suppression** : toutes les positions sont fermées au marché, la stratégie est supprimée définitivement et l'allocation est libérée pour une autre stratégie. *** ## Risques et avertissements > **AVERTISSEMENT, RISQUE DE PERTE** > > Le trading comporte un risque de perte pouvant aller jusqu'à la totalité du capital engagé. Les performances passées ne préjugent pas des performances futures. Botlyz est un **éditeur de logiciel d'automatisation**, pas un conseiller financier. Vous êtes seul responsable de vos décisions de trading et de votre capital. Voir aussi l'[Avertissement sur les risques](/docs/pour-demarrer/avertissement-risques.md). ### Risques spécifiques **Liquidation** (notamment avec un levier élevé) : si le prix évolue suffisamment à votre défaveur, une position peut être liquidée à perte. Plus le levier est élevé, plus le seuil de liquidation est proche du prix d'entrée. Le choix du levier relève de votre décision. **Slippage DEX** : Lighter est un DEX, le prix peut bouger entre la décision et l'exécution. Le slippage agit comme un coût implicite. Les paires peu liquides présentent un slippage potentiellement plus élevé. **Mouvements de marché brutaux** : le prix peut chuter fortement en quelques secondes. Un stop-loss se déclenche, mais peut être exécuté à un prix dégradé. Ce type d'événement n'est pas prévisible. **Risque opérationnel** : erreur de configuration, anomalie logicielle (rare, mais possible), indisponibilité de Lighter DEX. *** ## Exemple complet : déployer SIGMA v2.1 sur HYPE ### Situation * Vous disposez de 300 USDC sur le compte Lighter "Main". * Vous souhaitez déployer SIGMA v2.1 (HYPE). * Appétit pour le risque : modéré. ### Configuration choisie * Paire : **HYPE** (fixée, non modifiable). * Paramètres de stratégie : valeurs par défaut (MA 140, enveloppe 3 %, RSI 80 avec bornes 42 / 58, timeframe 5 min). * Levier : **2** (capital tradable = 300 × 2 × 0,8 = 480 USDC). * Allocation : **80 %** (le reste du capital reste libre). * Stop-loss : **11 %**, slippage SL et TP : **10 %**. ### Vérifications 1. Capital : 300 USDC, largement supérieur au minimum requis pour HYPE à ce levier. 2. Allocation : 80 %, inférieure à 100 % (aucune autre stratégie sur ce compte). 3. Paire : aucune autre stratégie n'utilise HYPE sur ce compte, donc pas de conflit. ### Signature * Le message présente la paire HYPE, le levier 2 et l'allocation 80 %. * Vous signez via MetaMask, sans coût de gaz. * La signature est validée, le déploiement est confirmé. ### Exécution * La stratégie est active dès la validation. * Les premiers signaux sont évalués à la prochaine clôture de bougie 5 min. * Le suivi est mis à jour dans "Mes stratégies". *** ## Support En cas de question ou de problème : * **Formulaire dans l'app** : onglet "Aide". * **Documentation** : consultez la base de connaissance et la [FAQ](/docs/securite-and-aide/faq.md). Voir aussi la page [Support](/docs/securite-and-aide/support.md) et les [Mentions légales](/docs/securite-and-aide/mentions-legales.md). --- # 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/deployer-une-strategie.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.