> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-fr/perp-dexs/webhooks.md).

# Webhooks

goodcryptoX vous permet d’automatiser des actions de trading via les webhooks TradingView — un mécanisme puissant pour déclencher des ordres et des actions de bot directement à partir de vos signaux.

Contrairement à certaines implémentations qui traitent les webhooks comme une API programmable (où vous envoyez des commandes paramétrées comme « acheter 3 BTC »), goodcryptoX prend actuellement en charge un modèle basé sur des déclencheurs. Chaque webhook active simplement une action prédéfinie sur un ordre ou un bot spécifique — aucun paramètre ni commande n’est interprété.

Dans un avenir proche, nous lancerons un nouveau [bot de stratégie TradingView](https://docs.goodcrypto.app/goodcryptox-fr/perp-dexs/upcoming-functionality/tradingview-strategy-bot.md) qui prend en charge des instructions de stratégie complètes via des webhooks, y compris la sélection dynamique des symboles, les quantités, les types d’ordres et la logique multi-symboles — agissant ainsi comme une couche API. Restez à l’écoute

> Les webhooks ne sont acceptés pour l’instant que depuis les serveurs de TradingView — pas d’adresses IP personnalisées ni de sources externes.\
> Si vous avez besoin d’utiliser une source de webhook personnalisée, contactez-nous à <support@goodcrypto.app> pour demander l’accès.

### Comment fonctionnent les webhooks dans goodcryptoX

* Chaque ordre ou bot **action** dispose de sa propre URL de webhook dédiée
* Vous devez d’abord créer l’ordre ou le bot pour obtenir l’URL (elles apparaîtront dans la **Webhooks** section des **Détails**)
* de l’ordre ou du bot. **n’importe quel** payload de webhook envoyé à cette URL déclenchera l’action

> Les URL de webhook sont spécifiques à l’action, et non à l’utilisateur. Vous devez créer un webhook par action, par exemple un pour l’entrée, un pour la prise de profit, un pour le stop loss, etc. pour chaque bot ou ordre

### Actions d’ordre et de bot prises en charge

Si vous voulez que votre ordre ou bot soit **déclenché par un webhook**, vous devez sélectionner webhook comme **condition de déclenchement lors de la configuration**. Cela s’applique à :

* Déclenchement des ordres stop-market / stop-limit
* Activation des ordres suiveurs (démarrage du trailing)
* Déclenchements de prise de profit et de stop loss
* Condition d’entrée des bots DCA

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Après la création, vous trouverez toutes les URL de webhook disponibles dans la **Détails** de votre ordre ou bot :

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

> **Annuler** webhook — toujours disponible dans tous les ordres et bots
>
> **Fermer la position** webhook — toujours disponible dans les détails du bot DCA

En résumé :

| Action                                       | Pris en charge ? | Remarques                                                                      |
| -------------------------------------------- | ---------------- | ------------------------------------------------------------------------------ |
| Annuler l’ordre                              | ✅                | Toujours affiché dans les détails                                              |
| Déclencher l’ordre Stop                      | ✅                | Doit sélectionner webhook lors de la configuration                             |
| Activer l’ordre suiveur                      | ✅                | Début du trailing = webhook                                                    |
| Déclencher la prise de profit / le stop loss | ✅                | Déclenché éventuellement par webhook                                           |
| Bot DCA - entrée                             | ✅                | Achat/vente à l’entrée via webhook (doit être défini lors de la configuration) |
| Bot DCA - sortie                             | ✅                | Fermer la position via webhook (toujours disponible)                           |
| Bot Grid - entrée                            | 🚫               | Pas encore pris en charge                                                      |

{% hint style="info" %}
**Multiples objectifs de prise de profit avec webhooks**

Si vous configurez un groupe de prise de profit en utilisant webhook comme méthode de déclenchement, ils partageront tous la même URL de webhook. Chaque fois que le webhook est déclenché, l’ordre TP suivant de la séquence s’exécutera — un par un.
{% endhint %}

### Comment configurer des alertes dans TradingView

Une fois que vous avez créé votre ordre ou bot dans goodcryptoX et copié l’URL du webhook pour une action spécifique, voici comment le relier à vos alertes TradingView :

1. Allez sur votre graphique dans TradingView
2. Créez une nouvelle alerte basée sur votre stratégie, indicateur ou condition
3. Dans les **paramètres de l’alerte**, cochez la case **« Webhook URL »**
4. Collez l’URL de webhook spécifique depuis la section Webhooks de goodcryptoX
5. Laissez le **champ de message** tel quel (tout contenu convient — goodcryptoX ignore le payload pour l’instant)
6. Enregistrez l’alerte

### Stratégies répétitives (via le bot DCA)

Un ordre déclenché par webhook (par ex. stop-market avec TP et SL) est une **configuration ponctuelle**. Une fois que l’ordre est exécuté et que le TP ou le SL associé se déclenche, l’ensemble du trade est terminé. Si vous voulez que cette structure **se répète automatiquement**, ce n’est pas possible avec les ordres — mais c’est désormais réalisable avec le bot DCA.

Nous introduirons bientôt un [bot de stratégie TradingView](https://docs.goodcrypto.app/goodcryptox-fr/perp-dexs/upcoming-functionality/tradingview-strategy-bot.md) dédié pour prendre en charge des trades répétés à actions multiples, mais en attendant, le bot DCA offre un moyen flexible de répéter votre stratégie pilotée par webhook.

#### Boucle webhook pure

Pour configurer un bot qui entre en position sur un webhook, en sort sur un webhook, puis recommence :

1. Définir **la condition d’entrée** = webhook
2. Définir **ordres d’averaging** = 0 (désactiver l’averaging)
3. Désactiver les deux **prise**-**de profit** et **stop-loss**
4. Activer **« Répéter à la fermeture de la position »**

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Une fois le bot lancé, vous verrez les URL de webhook suivantes sous les **Détails → Webhooks** du bot :

* **Entrée Achat** — ouvre une position Long
* **Entrée Vente** — ouvre une position Short
* **Fermer la position** — ferme la position active (longue ou courte)
* **Annuler** — arrête le bot

**Logique d’exécution**

* Lorsque le bot reçoit **Entrée Achat**, il ouvre une position longue.
* Lorsqu’il reçoit **Entrée Vente**, il ouvre une position courte.
* Le bot **ne répond qu’au premier webhook d’entrée** qu’il reçoit lorsqu’il est inactif.
* Lorsqu’une position est ouverte :
  * Tous les autres signaux d’entrée sont **ignorés**
  * Le bot n’augmentera pas et n’inversera pas la position actuelle sur les signaux d’entrée
  * Les seuls signaux acceptés sont **fermer la position** ou un TP/SL déclenché (s’il est configuré)
* Une fois la position fermée (manuellement, par webhook ou par SL/TP), le bot se réinitialise et attend le prochain webhook d’entrée.

Cette boucle continue tant que le bot reste actif, vous permettant de répéter indéfiniment un cycle complet entrée → sortie → réinitialisation.

#### Mode webhook pur vs configurations hybrides

Le bot DCA prend en charge plusieurs couches de contrôle qui peuvent être combinées pour construire des stratégies flexibles :

* **Entrée**: via webhook, signal ou asap
* **Sortie**: via webhook, ou TP/SL natifs basés sur le prix
* **Averaging**: optionnel ; peut être désactivé

Vous pouvez :

* Faire fonctionner un bot entièrement via des signaux webhook (entrée et sortie)
* Ajouter des TP/SL basés sur le prix comme solutions de secours, même si vous utilisez des sorties webhook
* Ajouter des ordres d’averaging pour une protection supplémentaire

Cela permet de concevoir :

* Des stratégies de boucle entièrement automatisées (webhook pur)
* Des bots pilotés par signaux avec relais manuels
* Des configurations hybrides avec sorties multi-niveaux

### Exemples pratiques de stratégies webhook

#### Exemple 1 : Ordre ponctuel + multiples prises de profit (rebond de bandes de Bollinger)

**Objectif :** Acheter lorsque le prix franchit la bande de Bollinger inférieure, vendre progressivement à mesure qu’il monte.

**Configuration dans goodcryptoX**

* Créez un ordre stop-market avec condition de déclenchement = webhook
* Ajoutez trois objectifs de prise de profit. Déclenchement TP = webhook

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

**Configuration dans TradingView**

Créez quatre alertes :

1. Le prix franchit la bande inférieure → envoyer à l’ **Déclencheur** URL du webhook
2. Le prix revient dans la bande → envoyer au **Déclencheur de prise de profit** URL du webhook
3. Le prix franchit la bande médiane → envoyer à **Déclencheur de prise de profit** URL du webhook
4. Le prix franchit la bande supérieure → envoyer à **Déclencheur de prise de profit** URL du webhook

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Dans les **paramètres de l’alerte**, cochez la case **« Webhook URL »**

Collez l’URL de webhook spécifique depuis la section Webhooks de goodcryptoX. Laissez le champ Message tel quel — il n’est pas utilisé.

#### Exemple 2 : Stratégie répétitive avec le bot DCA (croisement doré / croisement de la mort)

**Objectif :** Entrer en long au croisement doré, entrer en short au croisement de la mort. Sortir avec un profit de 10 % ou lorsque RSI > 70, puis répéter à l’infini.

**Configuration dans goodcryptoX**

Créer le bot DCA

* Condition d’entrée = webhook
* Averaging = désactivé (mettre à 0)
* Take Profit = 10 %
* Stop loss = désactivé
* Activer : « Répéter au TP »

**Configuration dans TradingView**

* Créez trois alertes sur le même graphique :
  1. SMA50 croise au-dessus de SMA200 → envoyer à **Entrée Achat** webhook
  2. SMA50 croise en dessous de SMA200 → envoyer à **Entrée Vente** webhook
  3. RSI > 70 → envoyer à **Fermer la position** webhook

{% hint style="info" %}
Le bot DCA ne conserve qu’une seule position à la fois. Lorsqu’il est en position, il ignore les nouveaux webhooks d’entrée jusqu’à la fermeture de la position.

Si vous souhaitez pouvoir ouvrir en parallèle des positions Long et Short sur le même instrument - créez deux bots séparés et envoyez Entrée Achat à l’un et Entrée Vente à l’autre
{% endhint %}

### Résumé

| Concept                 | Description                                                                 |
| ----------------------- | --------------------------------------------------------------------------- |
| Modèle de déclenchement | Chaque action a sa propre URL de webhook                                    |
| Flux de configuration   | Créer un ordre → copier l’URL du webhook → coller dans l’alerte TradingView |
| Stratégie répétitive    | Utiliser le bot DCA avec la répétition activée                              |

### Tutoriels vidéo

#### **Introduction au trading par webhook**

#### **Utiliser le bot DCA avec les webhooks**

#### **Prises de profit multiples avec webhooks**
