# 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 bots 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 ou commande n'est interprété.

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

### Sécurité et accès

* Les webhooks ne sont acceptés que depuis les serveurs TradingView pour l'instant — pas d'IPs 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.
* Les webhooks sont disponibles uniquement pour les utilisateurs disposant d'un [abonnement](https://docs.goodcrypto.app/goodcryptox-fr/ecosysteme/forfaits-dabonnement) PRO actif ou supérieur.

### Comment fonctionnent les webhooks dans goodcryptoX

* Chaque ordre ou bot **action** a sa propre URL webhook dédiée
* Vous devez d'abord créer l'ordre ou le bot pour obtenir l'URL (elles apparaîtront dans la **section Webhooks** de la **fiche détaillée**)
* Envoyer **n'importe quelle** charge utile webhook à cette URL déclenchera l'action

> Les URL webhook sont spécifiques à une action, pas à un utilisateur. Vous devez créer un webhook par action, par ex. un pour l'entrée, un pour le take profit, un pour le stop loss, etc. pour chaque bot ou ordre

### Actions d'ordres et de bots 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 à :

* Les ordres stop-market / stop-limit déclenchent
* Activation des ordres suivis (début du trailing)
* Déclenchements take-profit et stop-loss&#x20;
* 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%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOtmSJHlKDJLkbCquvUfC%2Fimage.png?alt=media&#x26;token=c152200c-d5ad-4d69-861d-7c66700cd569" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F278uiG55cCWY8A3XpJxm%2Fimage.png?alt=media&#x26;token=7d852fc3-0ef4-45ab-921d-eab0d2287e97" alt="" width="563"><figcaption></figcaption></figure>

Après la création, vous trouverez toutes les URL webhook disponibles dans la **fiche détaillée** de votre ordre ou bot :

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNoneMggO61H3EFmkwTrP%2Fimage.png?alt=media&#x26;token=f6f48a58-1585-41e3-8778-b69fe9564902" alt="" width="563"><figcaption></figcaption></figure>

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

Pour résumer :

| Action                             | Pris en charge ? | Remarques                                                                    |
| ---------------------------------- | ---------------- | ---------------------------------------------------------------------------- |
| Annuler l'ordre                    | ✅                | Toujours affiché dans les détails                                            |
| Déclencher un ordre Stop           | ✅                | Doit sélectionner webhook lors de la configuration                           |
| Activer un ordre Trailing          | ✅                | Début du trailing = webhook                                                  |
| Déclencher take profit / stop loss | ✅                | Optionnellement déclenché par webhook                                        |
| Bot DCA - entrée                   | ✅                | Achat/vente d'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" %}
**Cibles multiples de take-profit avec webhooks**

Si vous configurez un groupe de take-profit en utilisant webhook comme méthode de déclenchement, ils partageront tous la même URL webhook. Chaque fois que le webhook est déclenché, le prochain ordre TP dans 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 webhook pour une action spécifique, voici comment la lier à 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**, activez la case à cocher **“URL webhook”**
4. Collez l'URL webhook spécifique depuis la section Webhooks de goodcryptoX
5. Laissez le **champ message** tel quel (tout contenu convient — goodcryptoX ignore la charge utile pour l'instant)
6. Enregistrez l'alerte

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

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

Nous introduirons bientôt un [bot stratégie TradingView](https://docs.goodcrypto.app/goodcryptox-fr/trading-cex/fonctionnalites-a-venir/bot-strategie-tradingview) dédié pour supporter des trades multi-actions répétitifs, mais en attendant, le bot DCA offre un moyen flexible de répéter votre stratégie pilotée par webhook.

#### Boucle pure webhook

Pour configurer un bot qui entre en position via un webhook, sort via un webhook, puis se répète :

1. Définissez **condition d'entrée** = webhook
2. Définissez **ordres d'averaging** = 0 (désactiver l'averaging)
3. Désactivez les deux **take**-**profit** et **stop-loss**
4. Activez **"Répéter à la fermeture de la position"**&#x20;

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FCquwy7JurEJkuO9rQeWn%2Fimage.png?alt=media&#x26;token=542f9526-7ecb-4033-8b1c-740aef270b51" alt="" width="375"><figcaption></figcaption></figure>

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

* **Entrer Achat** — ouvre une position Long
* **Entrer Vente** — ouvre une position Short
* **Fermer position** — ferme la position active (long ou short)
* **Annuler** — arrête le bot

**Logique d'exécution**

* Lorsque le bot reçoit **Entrer Achat**, il ouvre une position long.
* Lorsqu'il reçoit **Entrer Vente**, il ouvre une position short.
* Le bot **ne répondra qu'au premier webhook d'entrée** qu'il reçoit alors qu'il est au repos.
* Tant qu'une position est ouverte :
  * Tout signal d'entrée supplémentaire est **ignoré**
  * Le bot n'augmentera ni n'inversera la position actuelle sur des signaux d'entrée
  * Les seuls signaux acceptés sont **fermer la position** ou un TP/SL déclenché (si 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 pure webhook 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 intégré basé 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 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 en boucle entièrement automatisées (pure webhook)
* Des bots pilotés par signaux avec basculements manuels
* Des configurations hybrides avec sorties multi-couches

### Exemples pratiques de stratégies avec webhooks

#### Exemple 1 : Ordre unique + multiples take-profits (rebond sur les 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 cibles de take-profit. Déclencheur TP = webhook

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**Configuration dans TradingView**

Créez quatre alertes :

1. Le prix franchit la bande inférieure → envoyer à l' **URL de déclenchement** webhook de l'ordre principal
2. Le prix retourne à l'intérieur de la bande → envoyer au **Déclencheur Take Profit** webhook de l'ordre principal
3. Le prix croise la bande médiane → envoyer au **Déclencheur Take Profit** webhook de l'ordre principal
4. Le prix franchit la bande supérieure → envoyer à **Déclencheur Take Profit** webhook de l'ordre principal

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" alt="" width="563"><figcaption></figcaption></figure>

Dans les **paramètres de l'alerte**, activez la case à cocher **“URL webhook”**

Collez l'URL 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 bot DCA (Golden/Death Cross)

**Objectif :** Entrer long sur Golden Cross, entrer short sur Death Cross. Sortir avec un profit de 10 % ou lorsque le RSI > 70 et répéter indéfiniment.

**Configuration dans goodcryptoX**

Créer un 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 à **Entrer Achat** webhook
  2. SMA50 croise en dessous de SMA200 → envoyer à **Entrer Vente** webhook
  3. RSI > 70 → envoyer à **Fermer position** webhook

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

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

### Résumé

| Concept                 | Description                                                              |
| ----------------------- | ------------------------------------------------------------------------ |
| Modèle de déclenchement | Chaque action a sa propre URL webhook                                    |
| Flux de configuration   | Créer un ordre → copier l'URL webhook → coller dans l'alerte TradingView |
| Stratégie répétitive    | Utiliser le bot DCA avec la répétition activée                           |
| Accès                   | Nécessite un abonnement PRO ou supérieur                                 |

### Tutoriels vidéo

#### **Introduction au trading via webhooks**

{% embed url="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

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

{% embed url="<https://youtu.be/gHXB2S6qdXU?si=i9ZobjRsxFAe7zcJ>" %}

#### **Multiples take-profits avec webhooks**

{% embed url="<https://youtu.be/xF-O7ZDoDtU?si=apfiF8uyTn-p4Vh4>" %}