# Bot de grille

Le bot Grid est une stratégie de trading automatisée qui monétise les fluctuations de prix en plaçant une grille d’ordres d’achat et de vente dans une certaine plage de prix.

{% embed url="<https://youtu.be/WeuiKvhMI00>" %}

### Pourquoi utiliser le bot Grid ?

Les marchés évoluent rarement en ligne droite. Même lors de fortes tendances, le prix oscille constamment — il monte, recule, rebondit, se consolide, puis recommence. Une approche traditionnelle « acheter et conserver » ne profite que du mouvement directionnel. Le bot Grid profite du mouvement *lui-même*.

Prenons cet exemple : le BTC est à 80 000 $. Au cours du mois suivant, il grimpe à 95 000 $, redescend à 82 000 $, remonte à 91 000 $, retombe à 85 000 $, puis finit par revenir à 80 000 $.

Si vous aviez simplement conservé vos BTC pendant tout cela, votre résultat net serait nul.

Mais au cours de ce trajet, le prix a effectué des dizaines d’oscillations — chacune représentant une opportunité de trading potentielle. Une grille d’ordres d’achat sous le prix actuel et d’ordres de vente au-dessus aurait capturé un profit sur chaque rebond, creux et reprise en chemin. Chaque cycle achat–vente verrouille un petit gain réalisé, et lorsque le prix reste dans votre plage, ces gains se cumulent pour produire des rendements significatifs — même lorsque le marché ne va nulle part.

C’est ce que fait le bot Grid. Il se comporte de manière similaire à une stratégie structurée de market making : il place des ordres d’achat par paliers sous le prix actuel, des ordres de vente par paliers au-dessus, et capture à répétition l’écart entre les deux à mesure que le prix oscille.

Il vous permet d’utiliser efficacement votre capital, qui serait autrement inactif pendant les marchés latéraux, et d’exprimer votre vision du marché tout en profitant également de la volatilité au passage, dans les marchés haussiers ou baissiers.

#### Meilleures conditions de marché pour le trading en grille

Le trading en grille est le plus efficace lorsque le **prix évolue dans une plage définie** (marchés latéraux). Le bot Grid standard ou [neutre](#neutral-grid) est utilisé pour cela. Plus le prix oscille dans la plage et plus il y reste longtemps, plus le profit du bot Grid est élevé.&#x20;

Pour les marchés en range — lorsque le **prix est en tendance haussière ou baissière** mais reste volatil, oscillant autour de la tendance — goodcryptoX propose des bots Grid [long](#long-grid) et [short](#short-grid) respectivement. Avec ces bots, vous profitez toujours de chaque variation de prix à l’intérieur de la plage de la grille, tout en tirant également un rendement du mouvement directionnel du prix.

#### **Cas d’usage courants du bot Grid :**

Les deux cas d’usage les plus courants du trading en grille sont :

* **Profiter des marchés latéraux.** Lorsque le prix se consolide et que vous n’avez pas de vision directionnelle forte, une grille neutre capture le mouvement d’aller-retour dans la plage que vous définissez.
* **Exprimer une vision directionnelle avec un ramassage intégré de la volatilité.** Les grilles Long et Short vous permettent de profiter à la fois de la direction et des fluctuations de prix à l’intérieur de celle-ci.

Mais ce n’est pas tout. Le bot Grid est un outil polyvalent qui peut aussi être utilisé pour des stratégies comme :

* **Sortir progressivement d’une position.** Si vous avez déjà une position, vous pouvez utiliser le bot Grid Short placé au-dessus du prix du marché pour la réduire de manière contrôlée, tout en profitant au passage des rebonds de prix.
* **Accumuler un actif dans le temps.** Une grille Long sur un actif sur lequel vous êtes haussier vous permet de l’accumuler progressivement tout en gagnant sur la volatilité à court terme au passage.

### Comment fonctionne le trading en grille

Une grille est définie par quatre paramètres : un **niveau de grille supérieur**, un **niveau de grille inférieur**, un **nombre de niveaux** dans cette plage, et une **taille d’ordre** pour chaque niveau.

Le bot divise la plage entre les bornes supérieure et inférieure en niveaux régulièrement espacés et place des ordres limites à chacun d’eux. Les ordres d’achat se trouvent sous le prix de marché actuel, les ordres de vente au-dessus. Le niveau le plus proche du prix actuel reste vide - cela garantit que la grille dispose de l’espace nécessaire pour réagir au prochain mouvement de prix dans l’une ou l’autre direction.

**Le cycle de base fonctionne ainsi :**

Lorsque le prix baisse et exécute un ordre d’achat, le bot place immédiatement un ordre de vente un niveau au-dessus. Lorsque le prix monte et exécute un ordre de vente, le bot place un ordre d’achat un niveau en dessous. Chaque paire achat–vente verrouille un petit profit réalisé égal à la distance entre ces deux niveaux multipliée par la taille d’ordre (moins les frais de trading). À mesure que le prix oscille dans la plage, ce cycle se répète encore et encore.

Voyez cela comme un filet tendu sur votre plage de prix. Chaque fois que le prix traverse le filet, il déclenche des trades — et chaque trade déclenché génère un petit profit. Plus le prix oscille, plus les trades s’exécutent, et plus le profit s’accumule.

**Que se passe-t-il aux extrémités ?** Si le prix dépasse la borne supérieure ou inférieure de la grille, il n’existe plus d’ordres au-delà. Le bot conserve sa position accumulée et attend. Si le prix revient dans la plage, le cycle reprend. Si ce n’est pas le cas, vous vous retrouvez avec une position directionnelle — c’est le risque principal du trading en grille, et c’est pourquoi le choix de la plage est important.

**Une illustration simple :** Imaginez une grille avec seulement deux niveaux — un achat à 79 000 $ et une vente à 81 000 $. Chaque fois que le BTC oscille entre ces deux niveaux, le bot achète bas et vend haut, capturant 2 000 $ `x` taille d’ordre par cycle. Si vous étendez cela à 20 ou 50 niveaux sur une plage plus large, vous commencez à voir comment une grille peut générer des centaines de petits trades rentables à partir de la volatilité normale du marché.

### Modes de grille : Neutre, Long, Short

goodcryptoX prend en charge trois modes de grille. Chacun modifie la position initiale du bot et son profil de risque. Le bon mode à choisir dépend de votre vision du marché.

#### Grille neutre

Neutre est le mode par défaut et le plus équilibré.

Lorsque vous lancez une grille neutre, le bot place des ordres d’achat à chaque niveau sous le prix de marché actuel et des ordres de vente à chaque niveau au-dessus. Aucune position initiale n’est prise — vous commencez à plat (ou neutre).

La grille neutre est idéale lorsque vous pensez que le prix restera dans une plage et que vous n’avez pas de vision directionnelle forte. Le bot profite uniquement de la volatilité à l’intérieur de cette plage.

**Profil de risque :** Si le prix dépasse la plage par le haut, vous vous retrouvez avec une position short (sur les perps) ou vous avez vendu votre actif de base (au comptant). Si le prix casse par le bas, vous accumulez une position long. Dans les deux cas, votre exposition correspond approximativement à la moitié de la taille totale de la grille — car seuls les ordres d’un côté de la plage s’exécutent au fil du mouvement du prix. C’est le profil de risque le plus équilibré des trois modes.

**Quand utiliser la grille neutre :**

* Marchés en range, marchés en consolidation
* Lorsque vous n’avez pas de conviction directionnelle forte

#### Grille Long

En mode Long, *tous* les niveaux sont initialement définis comme ordres d’achat.

Les ordres d’achat situés au-dessus du prix de marché actuel s’exécutent immédiatement au lancement (puisqu’ils peuvent être exécutés au prix de marché actuel ou mieux), et chacun est remplacé par un ordre de vente un niveau plus haut. Cela construit une position long initiale dont la taille est égale au nombre de niveaux au-dessus du prix de marché multiplié par la taille d’ordre.

Une grille Long est essentiellement une grille neutre qui démarre avec une position long intégrée. Après les exécutions initiales, elle se comporte de manière identique — acheter plus bas, vendre plus haut, enchaîner les niveaux.

**Profil de risque :** Si le prix monte et finit par dépasser la plage de la grille, le bot vend progressivement la position, verrouillant un profit directionnel en plus des profits du trading en grille. Si le prix baisse, vous accumulez davantage — votre position long augmente, et votre exposition à la baisse est environ deux fois supérieure à celle d’une grille neutre comparable (car vous avez commencé avec une position *et* vous continuez d’acheter davantage à mesure qu’il baisse).

**Quand utiliser une grille Long :**

* Lorsque vous êtes haussier avec une volatilité attendue
* Lorsque vous voulez accumuler un actif tout en capturant les fluctuations à court terme
* Sur le spot, lorsque vous n’avez que la devise de cotation (par ex. USDT) et aucune devise de base à vendre

#### Grille Short

Le mode Short est l’image miroir du mode Long.

Tous les niveaux sont initialement définis comme ordres de vente. Les ordres de vente situés sous le prix de marché actuel s’exécutent immédiatement, construisant une position short initiale. Chaque exécution est remplacée par un ordre d’achat un niveau plus bas.

**Profil de risque :** Si le prix descend et passe sous la plage, le bot rachète progressivement, clôturant le short et verrouillant un profit directionnel. Si le prix monte, la position short grandit, et votre exposition est environ deux fois supérieure à celle d’une grille neutre.

**Quand utiliser une grille Short :**

* Lorsque vous êtes baissier avec une volatilité attendue
* Lorsque vous voulez réduire progressivement une position long existante
* Sur le spot, lorsque vous détenez une position et souhaitez la vendre progressivement

> **Note importante sur l’initialisation Long/Short :** Actuellement, la position initiale en modes Long et Short n’est pas ouverte comme un seul ordre au marché. À la place, tous les ordres sont placés comme ordres limites à chaque niveau de la grille, et ceux du « mauvais » côté du prix de marché s’exécutent immédiatement. Sur certaines bourses à terme, les ordres limites placés profondément dans le carnet peuvent être rejetés en raison de restrictions propres à l’exchange sur la distance à laquelle un ordre limite peut être placé par rapport au prix actuel. Si vous rencontrez des erreurs au lancement d’une grille Long ou Short large sur certaines plateformes, c’est probablement la cause. Il s’agit d’une limite connue qui sera corrigée dans une future mise à jour.

***

### Configuration de la grille

Cette section passe en revue chaque champ du formulaire de configuration du bot Grid de goodcryptoX, de haut en bas — exactement comme il apparaît dans l’interface. Tous les paramètres s’appliquent de la même manière, que vous tradiez sur l’une des plateformes centralisées que nous prenons en charge ou sur [Hyperliquid](/goodcryptox-fr/perp-dexs/hyperliquid.md).

<figure><img src="/files/fdf6b1445dd96b0fc270d03b5bc3f5496cb4e291" alt=""><figcaption></figcaption></figure>

#### Mode de grille

Le premier choix est le mode : **Neutre**, **Long**, ou **Short**. Si vous hésitez, commencez par Neutre - il présente le risque le plus équilibré et ne nécessite pas de vision directionnelle.

#### Niveau de grille le plus haut et le plus bas

Ces deux champs définissent les bornes supérieure et inférieure de votre plage de trading. Tous les niveaux de la grille seront placés entre ces deux prix.

Choisir où les placer est l’une des décisions les plus importantes lors de la configuration d’une grille. Une bonne approche consiste à examiner les niveaux historiques de support et de résistance - dézoomez sur le graphique, identifiez la plage dans laquelle le prix a passé le plus de temps, puis définissez vos bornes en conséquence.

Vous n’avez pas besoin de capter chaque mouvement possible. Définir la plage trop large signifie que vos niveaux seront très espacés (ce qui nécessite plus de niveaux ou entraîne moins de trades), tandis que la définir trop étroite risque de voir le prix sortir rapidement de la plage.

Vous pouvez définir ces valeurs numériquement dans le formulaire, ou faire glisser directement les bornes supérieure et inférieure sur le graphique. Lorsque vous les ajustez, les niveaux de la grille se mettent à jour en temps réel sur le graphique, et vous pouvez voir immédiatement quels niveaux seront des ordres d’achat et lesquels seront des ordres de vente.

#### Niveaux

Ce champ définit le nombre de niveaux (de 2 à 250) dans votre plage.

Il y a ici un compromis fondamental. Avec un montant de capital fixe :

* **Plus de niveaux** signifie un espacement plus serré entre eux. Chaque trade génère un profit plus faible (le PnL par niveau est plus petit), mais les trades se produisent plus souvent. Les tailles d’ordre seront plus petites, car votre capital est réparti sur davantage de niveaux.
* **Moins de niveaux** signifie un espacement plus large. Chaque trade capture une différence de prix plus importante (PnL par niveau plus élevé), mais les trades se produisent moins souvent. Vous pouvez utiliser des tailles d’ordre plus grandes puisque le capital est concentré sur moins de niveaux.

Vous devez trouver un équilibre entre fréquence et profit par trade. Trop serré et les frais peuvent grignoter des marges minces ; trop large et le bot trade à peine avant que le prix ne quitte la plage.

L’interface vous affiche le **PnL par niveau** (après frais de l’exchange) en temps réel lorsque vous ajustez ce nombre. Elle affiche également le pourcentage de gain estimé par niveau, ce qui vous aide à évaluer si l’espacement est cohérent pour l’instrument et les conditions que vous tradez.

> Notez que le PnL par niveau est calculé à l’aide de la grille de frais d’échange standard. Si vous avez un niveau plus élevé, vos frais seront plus faibles et le PnL par niveau - plus élevé.

Sur le graphique, vous pouvez voir les lignes de niveau s’ajuster lorsque vous changez ce nombre — une manière très intuitive de visualiser l’espacement.

#### Répartition des niveaux : Arithmétique vs Log

Sous les champs du niveau le plus haut/le plus bas, vous verrez une case à cocher **Répartition logarithmique** .

Par défaut, la grille utilise une répartition **arithmétique** (linéaire) — les niveaux sont espacés à intervalles de prix égaux. Si votre plage va de 80 000 $ à 90 000 $ avec 10 niveaux, chaque niveau est séparé exactement de 1 000 $.

Lorsque vous activez **Répartition logarithmique** (également appelée géométrique), les niveaux sont espacés à intervalles de *pourcentage* égaux à la place. Cela signifie que l’écart en dollars entre les niveaux est plus petit en bas de la plage et plus grand en haut.

**Pourquoi cela compte-t-il ?** Sur les marchés crypto, le prix tend à évoluer en pourcentage — une baisse de 5 % à partir de 90 000 $ (4 500 $) couvre une plage absolue bien plus large qu’une baisse de 5 % à partir de 80 000 $ (4 000 $). Avec un espacement arithmétique, le rendement en pourcentage par niveau varie : les niveaux proches du bas donnent un gain en pourcentage plus élevé que ceux proches du haut. La répartition logarithmique normalise cela, vous offrant un rendement en pourcentage constant à chaque niveau.

**Le mode Log est généralement préféré pour :**

* Plages de trading larges
* Actifs volatils
* Contrats à terme perpétuels
* La plupart des configurations de grille en pratique

**L’arithmétique peut être utile pour :**

* Plages très étroites
* Stablecoins ou paires à faible volatilité
* Lorsque vous souhaitez spécifiquement un espacement en dollars égal

Si vous hésitez, activez Log — c’est le réglage par défaut recommandé pour la plupart des configurations.

#### Taille d’ordre

La taille d’ordre définit combien le bot trade à chaque niveau. Elle est toujours spécifiée en **devise de base** (ou en contrats, pour les futures).

Par exemple, si vous lancez une grille sur BTC.USDT et que vous fixez la taille d’ordre à 0,01 BTC, le bot achètera ou vendra 0,01 BTC à chaque niveau.

L’interface vous montre aussi l’équivalent approximatif en devise de cotation de chaque ordre au prix actuel. Gardez à l’esprit que cet équivalent varie selon le niveau — les niveaux de prix plus élevés nécessitent plus de devise de cotation par ordre, et les niveaux plus bas en nécessitent moins. Donc, même si chaque niveau échange la même quantité de BTC, la valeur en dollars de chaque trade est différente.

Votre engagement total en capital dépend de la taille d’ordre, du nombre de niveaux et du prix actuel. L’interface calcule les **Fonds nécessaires** en bas du formulaire, afin que vous puissiez voir exactement combien il faut avant de lancer.

#### Prix d’activation

Ce champ facultatif vous permet de retarder le lancement de la grille jusqu’à ce que le prix atteigne un niveau spécifique.

Si vous définissez un prix d’activation, la grille ne placera aucun ordre tant que le marché n’atteindra pas ce prix. Une fois activée, la grille commence comme si elle venait d’être lancée à cet instant.

**Cas d’usage :**

* Vous souhaitez lancer une grille à une plage qui est actuellement au-dessus ou en dessous du marché — définissez un prix d’activation à la limite de votre plage pour attendre que le prix y arrive
* Vous anticipez une cassure et souhaitez démarrer la grille seulement après qu’elle se soit produite
* Vous voulez synchroniser la grille avec un événement ou un niveau spécifique sans surveiller le marché manuellement

#### Stop au-dessus / Stop en dessous

Ce sont des déclencheurs d’arrêt basés sur le prix. Si le prix atteint l’un ou l’autre niveau, le bot s’arrête : tous les ordres de grille ouverts sont annulés, et (si la **Fermer la position lorsque le bot s’arrête** case est cochée) la position actuelle est clôturée au marché.

Vous pouvez faire glisser les niveaux de stop directement sur le graphique, de la même manière que vous définissez les bornes de la grille.

Les niveaux de stop sont essentiels pour la gestion du risque. Ils vous protègent contre des pertes incontrôlées si le prix sort fortement de votre plage. Même si vous pensez que le prix restera dans la plage, définir des stops est une bonne pratique — surtout sur les instruments à effet de levier.

#### Fermer la position lorsque le bot s’arrête

Lorsque cette case est cochée, toute position restante est clôturée au marché lorsqu’un stop se déclenche (ou lorsque la grille s’arrête pour toute autre raison, comme une erreur). Lorsqu’elle est décochée, la grille s’arrête et annule ses ordres, mais votre position reste ouverte pour que vous la gériez manuellement. Sur les perps, tous les ordres de clôture de position utilisent l’indicateur reduce-only, de sorte que le bot ne retournera jamais accidentellement votre position.

#### Take Profit (objectif de PnL)

Ce champ définit un **objectif de PnL réalisé**. Lorsque le profit réalisé total de la grille atteint ce montant, la grille s’arrête.

**Détail critique :** cela repose uniquement sur le *réalisé* PnL — uniquement les profits verrouillés issus des cycles achat–vente terminés. Le PnL non réalisé (la valeur de marché de votre position ouverte) *n’est pas* inclus. Cela signifie que si le prix sort fortement de votre plage de grille, votre perte non réalisée peut augmenter, mais tant qu’aucun nouveau trade de grille ne se termine, l’objectif de PnL n’est pas affecté. Pour vous protéger dans ce scénario, utilisez Stop au-dessus / Stop en dessous en plus de l’objectif de PnL.

#### Stop en position neutre

Lorsque cette option est activée, la grille s’arrêtera la prochaine fois qu’elle reviendra à une **position neutre** (exposition nette nulle issue des ordres de grille).

À elle seule, cette option est utile pour les grilles Long et Short : si le prix traverse votre plage dans la direction souhaitée, la grille clôture progressivement la position, puis, une fois qu’elle atteint la neutralité, elle s’arrête proprement afin que si le prix se retourne ensuite, vous n’ouvriez pas une nouvelle position.&#x20;

Pour une grille neutre, cette case n’a aucun effet au lancement (puisque vous commencez neutre), mais elle s’activera la prochaine fois que la grille reviendra à la neutralité. Vous pouvez l’utiliser après qu’une grille neutre ait fonctionné un certain temps comme un futur niveau de prise de profit.

**Combinaison avec Take Profit :** C’est là que cela devient puissant. Lorsque l’objectif de PnL et Stop en position neutre sont tous deux activés, le comportement change : le bot attend d’abord que l’objectif de PnL réalisé soit atteint. Une fois cela fait, il continue de fonctionner mais surveille désormais une position neutre. La grille ne s’arrête que lorsque *les deux* conditions ont été satisfaites — objectif de profit atteint, et position ramenée à zéro.

Cela garantit une sortie propre : vous avez verrouillé le profit souhaité *et* vous n’avez aucune position résiduelle à gérer (ni PnL non réalisé négatif à matérialiser).

#### Drawdown de PnL (quand s’arrêter)

Ce champ facultatif définit un **trailing stop sur le PnL réalisé**.

Voici comment cela fonctionne : le bot suit en continu le pic de PnL réalisé depuis son lancement. Si le PnL réalisé baisse depuis ce pic du montant que vous avez spécifié, la grille s’arrête.

Par exemple, si vous définissez un drawdown de PnL à 50 $, et que le PnL réalisé de la grille atteint un pic de 300 $ puis redescend à 250 $, la grille s’arrête pour protéger vos gains.

**Important :** Comme l’objectif de PnL, cela repose uniquement sur le *réalisé* PnL. Si le prix sort de la plage de la grille et que votre PnL non réalisé se détériore, l’arrêt sur drawdown ne se déclenchera pas — seuls les changements de profit réalisé comptent. Utilisez des stops basés sur le prix (Stop au-dessus / Stop en dessous) pour gérer l’exposition non réalisée.

Vous pouvez définir le drawdown de PnL alors que votre bot Grid est déjà en fonctionnement - vous n’avez donc pas à le décider à l’avance (sauf si vous le souhaitez).

#### Position (perps uniquement)

Ce champ prévisualise les positions longues et courtes théoriques maximales que le bot Grid peut accumuler (si le prix atteint l’un ou l’autre extrême). C’est un outil utile pour évaluer votre risque et votre exposition potentiels.

#### Marge initiale / Fonds nécessaires

Montre exactement combien de capital est nécessaire pour lancer la grille.

**Pour les contrats à terme perpétuels :**

Seule la marge dans la devise de règlement (par ex. USDT) est nécessaire, quel que soit le mode de la grille. Le montant exact dépend du nombre de niveaux, de la taille d’ordre et des prix de chaque niveau. Gardez à l’esprit qu’il s’agit de la *marge minimale* — vous devriez conserver une réserve bien supérieure au montant calculé pour éviter une liquidation si le prix évolue contre vous. N’allouez jamais 100 % de votre marge disponible à une grille.

**Pour le trading au comptant :**

Les besoins en capital dépendent du mode de grille :

* **Neutre** requiert à la fois la devise de base et la devise de cotation — la devise de cotation pour financer les ordres d’achat sous le marché, et la devise de base pour financer les ordres de vente au-dessus du marché.
* **Long** requiert uniquement la devise de cotation (par ex. USDT), puisque tous les ordres initiaux sont des achats.
* **Short** requiert uniquement la devise de base (par ex. BTC), puisque tous les ordres initiaux sont des ventes.

L’interface affiche clairement les montants requis pour chaque devise, ainsi que votre solde disponible et un avertissement si vous n’en avez pas assez.

**Frais en devise de base sur le spot**

> **⚠️ Trading spot : attention aux frais de trading prélevés en coin de base**
>
> Sur la plupart des plateformes spot (par ex. Binance par défaut), les frais de trading sont prélevés directement sur le coin que vous venez d’acheter. Donc, si la taille d’ordre de votre bot est de 1 BTC, un achat vous crédite d’environ 0,999 BTC — les 0,001 BTC manquants correspondent aux frais. Lorsque le bot tente plus tard de vendre exactement 1 BTC, cela échoue : vous n’avez que 0,999, et l’ordre est rejeté pour « fonds insuffisants ».
>
> Deux façons de gérer cela :
>
> * **Conserver un petit solde supplémentaire du coin de base** sur votre compte, au-delà de ce dont le bot a strictement besoin.
> * **Ou activer le paiement des frais en jeton natif** sur votre exchange (par ex. détenir un peu de BNB sur Binance et activer « Payer les frais en BNB »). Les frais sont alors prélevés sur ce jeton, laissant vos coins tradés intacts. Remarque : vérifiez que votre exchange prend en charge cela spécifiquement pour les ordres API — par exemple, Bybit ne le permet actuellement que pour les ordres passés via l’interface propre de l’exchange.
>
> Cela s’applique uniquement au **spot**. Sur les contrats à terme perpétuels, les frais sont payés dans la devise de règlement (par ex. USDT) et n’affectent pas la taille des ordres.

Après avoir vérifié vos fonds, cliquez sur **Lancer** pour démarrer la grille. Le bot place immédiatement tous les ordres de grille et commence à surveiller.

***

### Lancement et surveillance du bot Grid

Après avoir cliqué sur **Lancer**, le bot place immédiatement tous les ordres de grille sur l’exchange (sauf si un prix d’activation a été défini) et commence à surveiller. Vous pouvez ouvrir à tout moment la page de détails du bot pour voir exactement ce que fait la grille, consulter ses performances, ajuster ses paramètres et le gérer.

Il existe deux façons d’ouvrir la page de détails du bot. Vous pouvez cliquer sur **Bots** dans le menu principal pour voir la liste de tous vos bots en cours d’exécution sur tous les exchanges et paires — trouvez la grille et cliquez dessus. Sinon, si vous êtes déjà sur la page Exchanges avec la même paire de trading sélectionnée, passez à l’onglet **Bots** sous le graphique pour voir tous les bots en cours sur cet instrument spécifique, puis cliquez sur la grille depuis là.

<figure><img src="/files/50c9c411c68e466d9ffab7c6da81d627eb8341ff" alt=""><figcaption></figcaption></figure>

En haut de la page de détails du bot, vous voyez les informations d’identification du bot : l’exchange, la paire de trading, le mode de grille (Neutre / Long / Short) et les paramètres clés définis pendant la configuration. L’état actuel est également affiché ici — que le bot soit en cours d’exécution ou arrêté (et, si oui, la raison de l’arrêt).

Vous voyez aussi le **Montant investi**. C’est le montant total des fonds que le bot utilise pour fonctionner, exprimé en devise de cotation. Pour le trading au comptant, cela représente le capital réel engagé dans la grille - la somme de la devise de base et de la devise de cotation (convertie en devise de cotation au prix de lancement).

Pour le trading à terme avec effet de levier, le montant investi reflète la taille notionnelle totale avec laquelle le bot opère, *n’est pas* votre marge réellement déposée. Si votre bot utilise des positions d’une valeur de 1 000 USDT avec un effet de levier de 10x, votre capital réel à risque est d’environ 100 USDT, mais le montant investi affiche 1 000 USDT. C’est important car les pourcentages de rentabilité affichés dans la section suivante sont calculés par rapport à ce montant investi. Pour obtenir votre rendement réel sur la marge déposée avec effet de levier, multipliez le pourcentage affiché par votre facteur de levier.

#### Rentabilité

Cette section montre la performance financière de la grille.

**PnL réalisé** est le profit total verrouillé provenant des cycles achat–vente terminés. Chaque fois que le bot achète à un niveau plus bas et vend à un niveau plus haut (ou inversement), le profit de cette paire de trades est ajouté au PnL réalisé. Ce nombre n’augmente que lorsque les cycles de grille se terminent - il n’est pas affecté par le prix actuel de marché de votre position ouverte.

**PnL non réalisé** est la valeur de marché de la position ouverte actuelle du bot. Si le bot détient une position long et que le prix est au-dessus du prix d’entrée moyen de cette position, le PnL non réalisé est positif ; si le prix est en dessous, il est négatif. Ce nombre fluctue à chaque variation de prix.

**PnL total** est la somme du réalisé et du non réalisé - votre profit ou perte complet si vous arrêtiez le bot et clôturiez sa position maintenant.

> **PnL du bot vs PnL de position sur l’exchange : pourquoi les chiffres peuvent différer**
>
> Le bot Grid calcule le PnL réalisé niveau par niveau : chaque cycle achat–vente est traité comme une opération aller-retour indépendante. Lorsque le bot achète au niveau A puis revend un niveau plus haut, la différence est enregistrée comme profit réalisé pour cette paire.
>
> Votre exchange, en revanche, suit la position entière comme une seule — en utilisant un prix d’entrée moyen unique. Cela signifie que le PnL réalisé de l’exchange pour une vente individuelle est calculé par rapport au coût moyen de la *totalité* de la position, et non par rapport à l’achat spécifique auquel la grille l’a associée.
>
> Cela peut entraîner des écarts importants, surtout lorsque le prix a fortement évolué dans une direction. Par exemple : le bot achète à 100 $, 95 $, 90 $, 85 $ et 80 $, constituant une position long de 5 ordres avec une entrée moyenne à 90 $. Le prix rebondit ensuite à 85 $ et le bot vend un niveau. Le bot enregistre un profit réalisé sur cette vente (achat à 80 $, vente à 85 $ = +5 $). Mais l’exchange voit une vente à 85 $ par rapport à une entrée moyenne de 90 $ - qu’il affiche comme une perte de -5 $.
>
> Aucun des deux chiffres n’est « faux » - ils représentent des méthodes de comptabilisation différentes. La méthode du bot reflète la performance réelle de la stratégie de grille (chaque niveau est son propre trade). La méthode de l’exchange reflète la position globale.
>
> À mesure que la grille fonctionne et termine davantage de cycles - surtout lorsque le prix oscille de nouveau dans la plage - ces deux chiffres convergent. Avec le temps, le PnL cumulé s’alignera. Mais pendant les périodes de mouvement directionnel prolongé, l’écart peut être important, et il est important de ne pas s’inquiéter si votre exchange affiche un PnL réalisé différent (ou même négatif) alors que le bot affiche un profit réalisé.

La section affiche également **APY** (Annual Projected Yield, rendement annuel projeté) sous deux formes : en montant absolu dans la devise de cotation, et en pourcentage. Cette projection prend le taux actuel de profit réalisé du bot et extrapole ce qu’il produirait sur une année entière, en fonction du montant investi. C’est un point de repère utile pour comparer la performance de la grille à d’autres stratégies, mais gardez à l’esprit qu’il s’agit d’une projection - les résultats réels dépendent des conditions futures du marché.

**Frais d’exchange** affiche le total des frais de trading que le bot a payés à l’exchange sur tous les ordres exécutés. Ce montant est déjà pris en compte dans le PnL réalisé — il est affiché séparément ici pour que vous sachiez combien la grille a dépensé en coûts d’exécution.

> **Les frais de financement ne sont pas inclus dans le PnL (contrats à terme perpétuels)**
>
> Sur les contrats à terme perpétuels, les paiements de financement sont réglés directement entre l’exchange et votre compte - généralement toutes les 8 heures - en fonction de la taille de votre position et du taux de financement en vigueur. Ces paiements ne sont pas **n’est pas** reflétés dans le PnL réalisé ou non réalisé du bot Grid.
>
> Cela signifie que votre profit ou perte réel peut être supérieur ou inférieur à ce que le bot affiche, selon le financement cumulé que vous avez payé ou reçu. Pour les grilles de longue durée qui maintiennent une position directionnelle persistante, la différence peut être substantielle. Vérifiez toujours séparément l’historique de financement de votre exchange lorsque vous évaluez la véritable performance de la grille.

#### Position

Cette section affiche la position actuelle du bot - le nombre de contrats ou la quantité de devise de base que le bot détient à cet instant. C’est la position qui resterait si le bot s’arrêtait maintenant.

Pour une **Grille neutre**, la position initiale est nulle - le bot commence à plat et ne construit une position qu’à mesure que le prix évolue et que les ordres s’exécutent. Pour **Long** et **les grilles Short**, le bot commence immédiatement avec une position : les ordres du « mauvais » côté du prix de marché s’exécutent au lancement, construisant une exposition initiale long ou short. À mesure que la grille fonctionne et que le prix oscille, cette position augmente et diminue au fur et à mesure que les ordres d’achat et de vente s’exécutent à travers les niveaux.

La position affichée ici est la position **totale** du bot - y compris ce qui a été établi au lancement et tout ce qui a changé depuis. Le PnL non réalisé de cette position est inclus dans le PnL total non réalisé du bot, et tout gain ou toute perte réalisé(e) provenant des cycles de grille est inclus dans le PnL total réalisé du bot. Il n’existe pas de séparation entre « performance du bot » et « performance de la position » — le PnL du bot est un chiffre unifié qui reflète l’ensemble du tableau, ce qui est normal : il s’agit de la performance totale de la stratégie, rien d’autre.

La **Fermer la position lorsque le bot s’arrête** case à cocher du formulaire de configuration est également accessible ici, et vous pouvez l’activer ou la désactiver à tout moment pendant que le bot fonctionne. Lorsqu’elle est activée, le bot clôture la position au marché chaque fois qu’il s’arrête (quelle qu’en soit la raison). Lorsqu’elle est désactivée, la position reste ouverte pour que vous la gériez manuellement après l’arrêt du bot.

#### Conditions d’arrêt

Les paramètres d’arrêt que vous avez configurés lors de la configuration - **Stop au-dessus** et **Stop en dessous**, **Take Profit** (objectif de PnL), **Drawdown de PnL** (quand s’arrêter), et **Stop en position neutre** - sont également affichés ici.

Vous pouvez activer ou désactiver **Stop en position neutre** à tout moment pendant l’exécution du bot.

Pour modifier les autres paramètres d’arrêt, cliquez sur le bouton **Modifier** en bas de la page de détails. À partir de là, vous pouvez ajouter, supprimer ou ajuster l’ **objectif de PnL du Take Profit**, **Drawdown de PnL**, ainsi que les **Stop au-dessus** et **Stop en dessous** niveaux de prix. Cela vous permet de resserrer ou d’élargir votre gestion du risque au fur et à mesure que la grille fonctionne et que les conditions changent - sans arrêter et relancer le bot.

#### Ordres

Cette section fournit un décompte du nombre d’ordres limites que le bot a actuellement ouverts sur l’exchange et du nombre d’ordres qu’il a déjà clôturés (exécutés). Elle vous donne une idée rapide du niveau d’activité de la grille - une grille qui a clôturé des centaines d’ordres a activement tradé, tandis qu’une grille avec peu d’ordres clôturés peut se trouver dans une plage où le prix bouge peu.

#### Progression

Affiche le temps total de fonctionnement du bot - son heure de démarrage et depuis combien de temps il fonctionne. Utile pour évaluer la performance dans le temps (en particulier avec la projection APY).

#### Webhooks

La section webhook affiche l’ **URL du webhook d’annulation** pour ce bot Grid. Si vous souhaitez arrêter le bot à partir d’une alerte TradingView, vous pouvez envoyer une requête à cette URL et le bot s’arrêtera comme si vous aviez appuyé manuellement sur le bouton Stop. Actuellement, seul le webhook d’annulation est pris en charge pour les bots Grid.

#### Graphique des prix

La page de détails du bot comprend un graphique complet du prix avec toute l’activité de la grille superposée. C’est l’une des vues les plus instructives pour comprendre comment votre grille fonctionne.

<figure><img src="/files/8ab718f379e30ece2721c2f8cc0f974a2f985573" alt=""><figcaption></figcaption></figure>

Sur le graphique, vous pouvez voir :

* **Lignes horizontales grises** représentent les niveaux de la grille - les points de prix fixes où le bot place des ordres
* **Lignes vertes** sur un niveau de grille indiquent un ordre d’achat actif actuellement placé à ce prix, avec le début de la ligne indiquant le moment exact où l’ordre a été placé sur l’exchange.
* **Lignes rouges** indiquent un ordre de vente actif actuellement placé à ce prix
* La **niveau de position neutre** est marqué - c’est le prix auquel la position nette du bot serait nulle
* La **niveaux de position maximale** sont également marqués - les prix

  &#x20;auxquels le bot atteindrait son exposition directionnelle maximale
* **Points verts** et **points rouges** sur le graphique marquent chaque ordre exécuté. Les points verts sont les exécutions d’achat, les points rouges sont les exécutions de vente. Vous pouvez retracer visuellement tout l’historique de trading du bot — voir exactement quand et à quels niveaux chaque trade a été exécuté

Ce graphique vous donne un retour visuel immédiat sur la performance de la grille : les trades se concentrent-ils dans une plage productive ? Le prix passe-t-il du temps près des bords ? Des stops ou des bornes de plage ont-ils été approchés ? Tout cela est visible d’un coup d’œil.

#### Alertes

Sous le graphique, vous pouvez configurer des notifications pour ce bot Grid spécifique. Il existe quatre types d’alertes, et vous pouvez activer n’importe quelle combinaison d’entre elles :

* **Chaque ordre** - vous notifie chaque fois qu’un ordre de la grille s’exécute
* **Chaque changement de PnL** - vous notifie uniquement lorsqu’un ordre entraîne un changement de PnL réalisé (c.-à-d. des ordres qui complètent un cycle achat–vente), ainsi que tous les ordres de clôture de position. Les ordres qui ouvrent ou augmentent simplement une position sans verrouiller de profit sont ignorés
* **Le prix entre dans la plage ou en sort** - vous notifie lorsque le prix franchit au-dessus du niveau de grille le plus élevé ou en dessous du niveau de grille le plus bas, et lorsqu’il revient dans la plage
* **Le bot s’arrête** - vous notifie lorsque le bot s’arrête pour quelque raison que ce soit

Vous pouvez activer ou désactiver chaque alerte à tout moment pendant l’exécution du bot.

#### Boutons d’action

En bas de la page de détails du bot, vous disposez de trois boutons d’action :

**Stop** - arrête immédiatement le bot. Tous les ordres de grille ouverts sont annulés. Si **Fermer la position lorsque le bot s’arrête** est activé, la position restante est clôturée au marché. Si désactivé, votre position reste ouverte pour que vous la gériez.

**Modifier** - ouvre l’éditeur de paramètres où vous pouvez ajuster les conditions d’arrêt pendant que le bot fonctionne. Vous pouvez ajouter, supprimer ou modifier **Stop au-dessus**, **Stop en dessous**, **Take Profit** (objectif de PnL), et **Drawdown de PnL**. Vous pouvez aussi activer ou désactiver **Fermer la position lorsque le bot s’arrête** et **Stop en position neutre** depuis ici. Vous n’avez pas besoin d’arrêter le bot pour effectuer ces changements - ils prennent effet immédiatement.

**Répéter** - préremplit le formulaire de configuration du bot avec les paramètres exacts de ce bot. Utile lors du redémarrage des bots.

#### Liste des ordres

Sous les boutons d’action, vous voyez la liste complète de tous les ordres associés à ce bot Grid. La liste est divisée en deux sections : **ordres ouverts** (actuellement placés sur l’exchange et en attente d’exécution) et **ordres clôturés** (déjà exécutés).

<figure><img src="/files/fe99b472190792c28f346d749b34d891de816156" alt=""><figcaption></figcaption></figure>

Pour chaque ordre, vous pouvez voir le prix, l’heure à laquelle il a été placé ou exécuté, son statut actuel et - pour les ordres ayant généré un PnL réalisé - le profit réalisé sur ce trade spécifique. Vous pouvez cliquer sur n’importe quel ordre pour ouvrir sa page de détail, qui inclut des informations supplémentaires telles que les frais exacts payés sur cette exécution.

Cette liste d’ordres est particulièrement utile pour examiner en détail l’historique de trading de la grille et comprendre la contribution au PnL des trades individuels.

#### Quand la grille s’arrête-t-elle ?

La grille s’arrête automatiquement dans l’un de ces cas :

* **Le prix atteint un niveau de stop** (Stop au-dessus / Stop en dessous)
* **L’objectif de PnL réalisé est atteint** (si défini)
* **Le drawdown de PnL se déclenche** (si défini)
* **La position neutre est atteinte** (si Stop en position neutre est activé et que les conditions sont remplies)
* **Une erreur se produit** - si un ordre ne peut pas être placé ou est annulé de manière inattendue par l’exchange (par exemple, à cause d’une liquidation), la grille détecte l’écart et s’arrête par mesure de sécurité, en annulant tous les ordres restants

Lorsque la grille s’arrête, tous les ordres de grille ouverts sont annulés. Si **Fermer la position lorsque le bot s’arrête** est activé, la position restante est clôturée au marché. Si désactivé, votre position reste ouverte pour une gestion manuelle.

***

### Playlist vidéo du bot Grid

Pour des exemples pratiques pas à pas, des cas de trading réels et des discussions de stratégie, consultez notre playlist vidéo du bot Grid :

{% embed url="<https://www.youtube.com/playlist?list=PLkscu1wG9E6WxhxMwwCtymU5pg_MRLMZr>" %}

Comprend :

* Cas de grille BTC à long terme avec plus de 60 % de rendement sur 5 mois
* Configurations de grille pour événements à forte volatilité
* Sélection détaillée de la plage et ajustement des niveaux
* Comparaisons pratiques des grilles Long, Short et Neutre

> **Remarque :** Bien que ces exemples montrent des configurations sur diverses plateformes, l’interface et le fonctionnement de la grille goodcryptoX sont identiques sur tous les exchanges pris en charge - y compris Hyperliquid, Binance, OKX, Bybit, Gate, et d’autres.

Nous gérons également un [canal TG](https://t.me/+DfNOhP8G86xmYTMx) dédié où nous publions nos meilleures configurations DCA et, occasionnellement, Grid - à la fois pour les exchanges centralisés et décentralisés. Rejoignez-nous pour obtenir de nouvelles idées de trading et partager votre expérience.

***

### FAQ

<details>

<summary><strong>Qu’est-ce que le trading en grille ?</strong></summary>

Le trading en grille est une stratégie automatisée qui place une série d’ordres limites d’achat et de vente à des niveaux de prix prédéterminés dans une plage définie. À mesure que le prix oscille dans la plage, le bot achète à bas prix et vend à prix élevé de manière répétée, capturant de petits profits à chaque cycle. C’est une façon de monétiser la volatilité sans avoir besoin de prédire la direction du marché.

</details>

<details>

<summary><strong>Le trading en grille est-il rentable ?</strong></summary>

Le trading en grille est rentable lorsque le prix reste dans votre plage sélectionnée ou à proximité, et qu’il y a suffisamment de volatilité pour déclencher des trades. Sur les marchés en range, il peut générer des rendements réguliers. Le principal risque est directionnel : si le prix sort fortement de votre plage, les pertes non réalisées sur votre position accumulée peuvent dépasser vos profits réalisés de grille. La rentabilité dépend d’un bon choix de plage, d’un espacement adéquat des niveaux et d’une bonne gestion du risque.

</details>

<details>

<summary><strong>Quel est le meilleur mode de grille - Neutre, Long ou Short ?</strong></summary>

Cela dépend de votre vision du marché. Neutre est le plus équilibré — aucune position initiale, risque directionnel minimal. Long est le meilleur lorsque vous êtes haussier et souhaitez accumuler tout en profitant des baisses. Short est le meilleur lorsque vous êtes baissier ou souhaitez sortir progressivement d’une position. Si vous hésitez, Neutre est le point de départ le plus sûr.

</details>

<details>

<summary><strong>Quelle est la différence entre la répartition arithmétique et logarithmique des niveaux de grille ?</strong></summary>

La répartition arithmétique espace les niveaux avec des intervalles de dollars égaux (par ex. tous les 1 000 $). La répartition logarithmique (géométrique) les espace avec des intervalles de pourcentage égaux (par ex. tous les 1,2 %). Le mode Log donne un rendement en pourcentage constant par niveau et est généralement préférable pour la crypto — où les prix évoluent en pourcentage — en particulier pour les plages larges et les actifs volatils.

</details>

<details>

<summary><strong>Combien de niveaux de grille dois-je utiliser ?</strong></summary>

Il n’y a pas de réponse unique — cela dépend de la largeur de votre plage, de la taille d’ordre et de la fréquence à laquelle vous souhaitez que les trades s’exécutent. Plus de niveaux signifient des trades plus fréquents mais plus petits ; moins de niveaux signifient des trades moins fréquents mais plus importants. Commencez avec un nombre modéré et observez le PnL par niveau affiché dans l’interface. S’il est très faible après les frais, envisagez moins de niveaux ou une plage plus serrée.

</details>

<details>

<summary><strong>Le financement affecte-t-il le PnL de la grille sur les contrats à terme perpétuels ?</strong></summary>

Oui, mais il n’apparaît pas dans le suivi du PnL de la grille. Les paiements de financement sont réglés directement par l’exchange et affectent le solde réel de votre compte. Pour les grilles de longue durée avec des positions persistantes, le financement cumulé peut avoir un impact significatif sur vos rendements réels. Vérifiez séparément l’historique de financement de votre exchange.

</details>

<details>

<summary><strong>Que se passe-t-il si le prix sort de ma plage de grille ?</strong></summary>

Aucun nouveau trade ne s’exécute au-delà de la plage. Vous conservez la position accumulée par l’activité de trading de la grille, et le PnL non réalisé sur cette position varie avec le prix. Si le prix revient dans la plage, la grille reprend le trading. Si ce n’est pas le cas, vous pouvez soit attendre, soit arrêter la grille manuellement.

</details>

<details>

<summary><strong>Puis-je être liquidé en faisant fonctionner une grille sur les perps ?</strong></summary>

Oui. Si votre marge tombe en dessous de l’exigence de maintenance de l’exchange — à cause, par exemple, du mouvement défavorable de la position de la grille — vous pouvez être liquidé. La grille détecte la liquidation (car l’exchange annule ses ordres) et s’arrête automatiquement. Pour minimiser ce risque, allouez toujours plus de marge que le minimum indiqué dans « Marge initiale »

</details>

<details>

<summary><strong>Que fait « Stop en position neutre » ?</strong></summary>

Lorsqu’il est activé, la grille attend d’avoir une position nette nulle puis s’arrête. C’est utile pour les grilles Long et Short : si le prix traverse la plage dans la direction souhaitée, la grille clôture la position niveau par niveau, puis, une fois à plat, elle s’arrête proprement. Lorsqu’il est combiné avec un objectif de PnL, la grille attend d’abord que l’objectif de profit soit atteint, puis continue de fonctionner jusqu’à ce qu’une position neutre soit obtenue.

</details>

<details>

<summary><strong>Puis-je utiliser un bot Grid sur Hyperliquid ?</strong></summary>

Oui. goodcryptoX prend en charge le trading en grille sur Hyperliquid pour les contrats à terme perpétuels et les marchés spot. [Connectez](/goodcryptox-fr/perp-dexs/hyperliquid/comment-connecter.md) votre compte Hyperliquid via un portefeuille API et vous avez accès à toutes les fonctionnalités du bot Grid — y compris les trois modes, les stops personnalisés, le prix d’activation et les contrôles du graphique en temps réel. Aucun abonnement n’est requis pour faire fonctionner des bots Grid sur Hyperliquid via goodcryptoX.

</details>

<details>

<summary><strong>Le bot Grid fonctionne-t-il aussi sur les perp DEX et les exchanges décentralisés spot ?</strong></summary>

Oui. Le bot Grid de goodcryptoX fonctionne de manière identique sur tous les exchanges pris en charge — y compris Hyperliquid, Binance, OKX, Bybit, Gate, et bien d’autres. Nous sommes également en train d’amener le bot Grid vers les DEX AMM sur Solana, BNB Chain, Base et d’autres réseaux pris en charge. L’interface, la mécanique et toutes les fonctionnalités décrites ici s’appliquent à la fois aux exchanges centralisés et aux perp DEX comme Hyperliquid. Les seules différences sont spécifiques à l’exchange (structures de frais, limites de levier, restrictions de placement d’ordres).

</details>

<details>

<summary><strong>Le bot Grid fonctionne-t-il sur les exchanges spot ?</strong></summary>

Oui. Le bot Grid de goodcryptoX fonctionne sur les marchés spot avec la même interface et les mêmes mécanismes que sur les contrats à terme perpétuels. Les principales différences sont pratiques : il n’y a pas de levier ni de risque de liquidation sur le spot, et les besoins en capital dépendent du mode de grille — Neutre nécessite à la fois la devise de base et la devise de cotation, Long nécessite uniquement la devise de cotation, et Short nécessite uniquement la devise de base. Sur les exchanges spot qui facturent les frais en devise de base, vous devrez maintenir un solde de base supplémentaire pour couvrir les frais de trading. Le formulaire de configuration vous indique exactement ce qui est nécessaire et vous avertit si votre solde est insuffisant.

</details>

<details>

<summary>Le bot Grid de goodcryptoX est-il gratuit ?</summary>

Sur les exchanges centralisés, un nombre limité de bots Grid est disponible dans le plan gratuit. Pour augmenter le nombre de bots Grid que vous pouvez faire fonctionner et accéder aux fonctionnalités Grid avancées, vous auriez besoin d’un [abonnement](/goodcryptox-fr/ecosysteme/formules-dabonnement.md).

payant. Sur Hyperliquid (et d’autres DEX pris en charge), vous pouvez faire fonctionner des bots Grid avec toutes les fonctionnalités sans abonnement requis. Des [frais de trading](/goodcryptox-fr/perp-dexs/hyperliquid/frais-du-builder.md) standard s’appliquent sur chaque ordre exécuté, et vous pouvez les réduire via le volume de trading, [les avoirs en token GOOD](/goodcryptox-fr/jeton-good/resume.md) ou le niveau d’abonnement.&#x20;

</details>


---

# Agent Instructions: 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:

```
GET https://docs.goodcrypto.app/goodcryptox-fr/trading-cex/bots/bot-de-grille.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
