# Webhooks

goodcryptoX ti consente di automatizzare le azioni di trading tramite webhook di TradingView — un potente meccanismo per attivare ordini e azioni dei bot direttamente dai tuoi segnali.

A differenza di alcune implementazioni che trattano i webhook come un'API programmabile (in cui invii comandi parametrizzati come "compra 3 BTC"), goodcryptoX attualmente supporta un modello basato su trigger. Ogni webhook semplicemente attiva un'azione predefinita su uno specifico ordine o bot — non vengono interpretati parametri o comandi.

Nel prossimo futuro lanceremo un nuovo [bot strategia per TradingView](https://docs.goodcrypto.app/goodcryptox-it/perp-dex/funzionalita-in-arrivo/bot-strategia-tradingview) che supporterà istruzioni di strategia complete tramite webhook, inclusa la selezione dinamica del simbolo, quantità, tipi di ordine e logica multi-simbolo — agendo effettivamente come un livello API. Restate sintonizzati

> Per ora i webhook sono accettati solo dai server di TradingView — nessun IP personalizzato o sorgente esterna.\
> Se hai bisogno di utilizzare una sorgente webhook personalizzata, contattaci a <support@goodcrypto.app> per richiedere l'accesso.

### Come funzionano i webhook in goodcryptoX

* Ogni ordine o bot **azione** ha il proprio URL webhook dedicato
* Devi creare prima l'ordine o il bot per ottenere l'URL (appariranno nella **sezione Webhooks** dettagli dell'ordine o del bot **Dettagli**)
* Inviare **qualsiasi** payload webhook a quell'URL attiverà l'azione

> Gli URL webhook sono specifici per l'azione, non per l'utente. Devi creare un webhook per ogni azione, ad es. uno per l'entrata, uno per il take profit, uno per lo stop loss, ecc. per ogni bot o ordine

### Azioni di ordini e bot supportate

Se vuoi che il tuo ordine o bot sia **attivato da un webhook**, devi selezionare webhook come **condizione di trigger durante la configurazione**. Questo si applica a:

* Gli ordini stop-market / stop-limit attivano
* Attivazione degli ordini trailing (trailing start)
* Trigger di take-profit e stop-loss&#x20;
* Condizione di entrata dei bot DCA

<figure><img src="https://4142774519-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://4142774519-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>

Dopo la creazione, troverai tutti gli URL webhook disponibili nel **Dettagli** del tuo ordine o bot:

<figure><img src="https://4142774519-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://4142774519-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>

> **Annulla** webhook — sempre disponibile in tutti gli ordini e bot
>
> **Chiudi posizione** webhook — sempre disponibile nei dettagli del bot DCA

Per riassumere:

| Azione                         | Supportata? | Note                                                                               |
| ------------------------------ | ----------- | ---------------------------------------------------------------------------------- |
| Annulla ordine                 | ✅           | Sempre mostrato nei dettagli                                                       |
| Attiva ordine Stop             | ✅           | Devi selezionare webhook durante la configurazione                                 |
| Attiva ordine Trailing         | ✅           | Trailing start = webhook                                                           |
| Attiva take profit / stop loss | ✅           | Opzionalmente attivato da webhook                                                  |
| Bot DCA - entrata              | ✅           | Entrata buy/sell tramite webhook (deve essere impostato durante la configurazione) |
| Bot DCA - uscita               | ✅           | Chiudi posizione tramite webhook (sempre disponibile)                              |
| Bot Grid - entrata             | 🚫          | Non ancora supportato                                                              |

{% hint style="info" %}
**Più obiettivi di take-profit con i webhook**

Se imposti un gruppo di take-profit utilizzando il webhook come metodo di trigger, condivideranno tutti lo stesso URL webhook. Ogni volta che il webhook viene attivato, verrà eseguito il prossimo ordine TP nella sequenza — uno alla volta.
{% endhint %}

### Come impostare gli avvisi in TradingView

Una volta creato il tuo ordine o bot in goodcryptoX e copiato l'URL webhook per una specifica azione, ecco come collegarlo ai tuoi avvisi di TradingView:

1. Vai al tuo grafico in TradingView
2. Crea un nuovo avviso basato sulla tua strategia, indicatore o condizione
3. Nelle **impostazioni dell'avviso**, abilita la casella di controllo **“Webhook URL”**
4. Incolla l'URL webhook specifico dalla sezione Webhooks di goodcryptoX
5. Lascia il **campo messaggio** così com'è (qualsiasi contenuto va bene — goodcryptoX ignora il payload per ora)
6. Salva l'avviso

### Strategie ripetute (tramite bot DCA)

Un ordine attivato da webhook (ad es. stop-market con TP e SL) è una **configurazione una tantum**. Una volta che l'ordine viene eseguito e il TP o SL collegato scatta, l'intera operazione è completa. Se vuoi che questa struttura **si ripeta automaticamente**, non è possibile con gli ordini — ma è ottenibile ora usando il bot DCA.

Presto introdurremo un dedicato [bot strategia per TradingView](https://docs.goodcrypto.app/goodcryptox-it/perp-dex/funzionalita-in-arrivo/bot-strategia-tradingview) per supportare operazioni ripetute con azioni multiple, ma nel frattempo il bot DCA offre un modo flessibile per ripetere la tua strategia guidata da webhook.

#### Loop completamente basato su webhook

Per impostare un bot che entri in posizione con un webhook, esca con un webhook e poi ripeta:

1. Imposta **condizione di entrata** = webhook
2. Imposta **ordini di media** = 0 (disabilita la media)
3. Disabilita sia **take**-**profit** e **stop-loss**
4. Abilita **"Ripeti alla chiusura della posizione"**&#x20;

<figure><img src="https://4142774519-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>

Una volta avviato il bot, vedrai i seguenti URL webhook sotto i **Dettagli → Webhooks** del bot:

* **Entra Buy** — apre una posizione Long
* **Entra Sell** — apre una posizione Short
* **Chiudi posizione** — chiude la posizione attiva (long o short)
* **Annulla** — ferma il bot

**Logica di esecuzione**

* Quando il bot riceve **Entra Buy**, apre una posizione long.
* Quando riceve **Entra Sell**, apre una posizione short.
* Il bot **risponderà solo al primo webhook di entrata** che riceve mentre è inattivo.
* Mentre una posizione è aperta:
  * Ulteriori segnali di entrata sono **ignorati**
  * Il bot non aumenterà né invertirà la posizione corrente sugli segnali di Entrata
  * Gli unici segnali accettati sono **chiudi posizione** o un TP/SL attivato (se configurato)
* Una volta che la posizione è chiusa (manualmente, via webhook o da SL/TP), il bot si resetta e aspetta il prossimo webhook di Entrata.

Questo ciclo continua finché il bot rimane attivo, permettendoti di ripetere indefinitamente un completo ciclo entrata → uscita → reset.

#### Modalità completamente webhook vs configurazioni ibride

Il bot DCA supporta più livelli di controllo che possono essere combinati per costruire strategie flessibili:

* **Entrata**: tramite webhook, segnale o asap
* **Uscita**: tramite webhook, o TP/SL builtin basati sul prezzo
* **Media**: opzionale; può essere disabilitata

Puoi:

* Eseguire un bot interamente tramite segnali webhook (entrata e uscita)
* Aggiungere TP/SL basati sul prezzo come fallback, anche se usi uscite via webhook
* Aggiungere ordini di media per protezione aggiuntiva

Questo rende possibile progettare:

* Strategie a loop completamente automatizzate (puro webhook)
* Bot guidati da segnali con failover manuali
* Configurazioni ibride con uscite a più livelli

### Esempi pratici di strategie con webhook

#### Esempio 1: Ordine one-off + take profit multipli (rimbalzo sulle Bande di Bollinger)

**Obiettivo:** Comprare quando il prezzo viola la banda inferiore di Bollinger, vendere progressivamente mentre risale.

**Configurazione in goodcryptoX**

* Crea un ordine stop-market con condizione di trigger = webhook
* Aggiungi tre obiettivi di take-profit. Trigger TP = webhook

<figure><img src="https://4142774519-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>

**Configurazione in TradingView**

Crea quattro avvisi:

1. Il prezzo viola la banda inferiore → invia all' **Trigger** URL webhook
2. Il prezzo rientra nella banda → invia al **Trigger Take Profit** URL webhook
3. Il prezzo attraversa la banda media → invia a **Trigger Take Profit** URL webhook
4. Il prezzo viola la banda superiore → invia a **Trigger Take Profit** URL webhook

<figure><img src="https://4142774519-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>

Nelle **impostazioni dell'avviso**, abilita la casella di controllo **“Webhook URL”**

Incolla l'URL webhook specifico dalla sezione Webhooks di goodcryptoX. Lascia il campo Messaggio così com'è — non viene usato.

#### Esempio 2: Strategia ripetuta con bot DCA (Golden/Death Cross)

**Obiettivo:** Entra long al Golden Cross, entra short al Death Cross. Esci con un profitto del 10% o quando RSI > 70 e ripeti all'infinito.

**Configurazione in goodcryptoX**

Crea bot DCA

* Condizione di entrata = webhook
* Media = off (imposta a 0)
* Take Profit = 10%
* Stop loss = off
* Abilita: "Ripeti al TP"

**Configurazione in TradingView**

* Crea tre avvisi sullo stesso grafico:
  1. SMA50 incrocia sopra SMA200 → invia a **Entra Buy** webhook
  2. SMA50 incrocia sotto SMA200 → invia a **Entra Sell** webhook
  3. RSI > 70 → invia a **Chiudi posizione** webhook

{% hint style="info" %}
Il bot DCA mantiene una sola posizione alla volta. Mentre è in posizione, ignora nuovi webhook di entrata fino alla chiusura della posizione.

Se vuoi poter entrare in posizioni Long e Short sullo stesso strumento in parallelo - crea due bot separati e invia Entra Buy a uno e Entra Sell all'altro
{% endhint %}

### Riepilogo

| Concetto                 | Descrizione                                                          |
| ------------------------ | -------------------------------------------------------------------- |
| Modello di trigger       | Ogni azione ha il proprio URL webhook                                |
| Flusso di configurazione | Crea ordine → copia URL webhook → incolla nell'avviso di TradingView |
| Strategia ripetuta       | Usa il bot DCA con ripetizione abilitata                             |

### Video tutorial

#### **Introduzione al trading con webhook**

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

#### **Uso del bot DCA con i webhook**

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

#### **Più take-profit con i webhook**

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