# Webhooks

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

A differenza di alcune implementazioni che trattano i webhook come una API programmabile (dove 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 — nessun parametro o comando viene interpretato.

Nel prossimo futuro lanceremo un nuovo bot Strategy per TradingView che supporterà istruzioni di strategia complete tramite webhook, inclusa la selezione dinamica del simbolo, quantità, tipi di ordine e logiche multi-simbolo — agendo di fatto come un livello API. Rimanete sintonizzati

> Per ora i webhook sono accettati solo dai server di TradingView — nessun IP personalizzato o fonti esterne.\
> Se hai bisogno di usare una fonte 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 prima creare l'ordine o il bot per ottenere l'URL (appariranno nella **Webhooks** sezione dei **Dettagli**)
* Inviare **qualsiasi** payload webhook a quell'URL attiverà l'azione

Ecco una panoramica video:

{% embed url="<https://youtu.be/Mx-nD_p2Pgw>" %}

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

### Azioni supportate per ordini e bot

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 Limit attivano
* Attivazione ordine trailing (trailing start)
* Trigger di take-profit e stop-loss&#x20;
* Condizione di entrata del bot DCA

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

<figure><img src="https://4142774519-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fl2pfeXIwqa1tpvsFEldb%2Fimage.png?alt=media&#x26;token=99ca6c17-d547-47c7-abaf-1d1e3bb4e03a" alt="" width="375"><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%2FlG04MgjoXROWz32j0tN4%2Fimage.png?alt=media&#x26;token=08009fa1-7757-4495-b60e-1165e12887b3" alt="" width="375"><figcaption></figcaption></figure>

Per riassumere:

| Azione                         | Supportata? | Note                                                                           |
| ------------------------------ | ----------- | ------------------------------------------------------------------------------ |
| Annulla ordine                 | ✅           | Sempre mostrato nei dettagli                                                   |
| Attiva ordine Limit            | ✅           | Devi selezionare webhook durante la configurazione                             |
| Attiva ordine Trailing         | ✅           | Trailing start = webhook                                                       |
| Attiva take profit / stop loss | ✅           | Opzionalmente attivabile via webhook                                           |
| Bot DCA - entrata              | ✅           | Entrata buy/sell via webhook (deve essere impostato durante la configurazione) |
| Bot DCA - uscita               | ✅           | Chiudi posizione via webhook (sempre disponibile)                              |

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

Se configuri un gruppo di take-profit utilizzando 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 preso dalla **Sezione webhooks disponibili di goodcryptoX** sezione
5. Lascia il **campo messaggio** così com'è (qualsiasi contenuto va bene — goodcryptoX al momento ignora il payload)
6. Salva l'avviso

### Strategie ripetute (tramite bot DCA)

Un ordine attivato da webhook (es. limit con TP e SL) è una **configurazione una tantum**. Una volta che l'ordine viene eseguito e il TP o SL collegato scatta, il trade è completo. Se vuoi che questa struttura **si ripeta automaticamente**, ciò non è possibile con gli ordini — ma è ottenibile ora utilizzando il bot DCA.

Presto introdurremo un bot strategy dedicato per TradingView per supportare trade multi-azione ripetuti, ma nel frattempo il bot DCA offre un modo flessibile per ripetere la tua strategia guidata da webhook.

#### Loop puro di webhook

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

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

<figure><img src="https://4142774519-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNUBBrWgJqqqvjcnLBw7C%2Fimage.png?alt=media&#x26;token=ced6146d-5d8e-4496-94bc-0cb08cb57282" alt="" width="375"><figcaption></figcaption></figure>

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

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

**Logica di esecuzione**

* Quando il bot riceve **Enter Buy**, apre una posizione long.
* Il bot **risponderà solo al primo webhook di entrata** che riceve mentre è inattivo.
* Mentre una posizione è aperta:
  * Qualsiasi ulteriore segnale di entrata viene **ignorato**
  * Gli unici segnali accettati sono **chiudi posizione** o un TP/SL attivato (se configurato)
* Una volta che la posizione è chiusa (manualmente, via webhook o tramite SL/TP), il bot si resetta e attende il prossimo webhook di Entry.

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

#### Modalità webhook pura vs configurazioni ibride

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

* **Entrata**: via webhook, segnale o istantanea
* **Uscita**: via webhook, o TP/SL basati sul prezzo integrati
* **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 protezioni aggiuntive

Questo rende possibile progettare:

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

### Esempi pratici di strategie con webhook

#### Esempio 1: Ordine una tantum + più take profit (rimbalzo dalle Bande di Bollinger)

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

**Configurazione in goodcryptoX**

* Crea un ordine limit con condizione di trigger = webhook
* Aggiungi tre target 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%2Ffg4E339WmltyEDaiNjma%2Fimage.png?alt=media&#x26;token=0ee7cab9-7575-4ac2-89c4-841693b2ba77" alt="" width="375"><figcaption></figcaption></figure>

**Configurazione in TradingView**

Crea quattro avvisi:

1. Il prezzo rompe la banda inferiore → invia all' **Trigger** URL webhook dell'ordine principale
2. Il prezzo rientra nella banda → invia al **Trigger di Take Profit** URL webhook dell'ordine principale
3. Il prezzo attraversa la banda centrale → invia al **Trigger di Take Profit** URL webhook dell'ordine principale
4. Il prezzo rompe la banda superiore → invia alla **Trigger di Take Profit** URL webhook dell'ordine principale

<figure><img src="https://4142774519-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fc3oNniHr6lmTUwc8qQ7V%2Fimage.png?alt=media&#x26;token=9787c6e6-5744-48cc-8ae1-a891fd775e8e" alt="" width="375"><figcaption></figcaption></figure>

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

Incolla l'URL webhook specifico preso dalla **Sezione webhooks disponibili di goodcryptoX** sezione. Lascia il campo Messaggio così com'è — non viene usato.

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

**Obiettivo:** Entrare long sul Golden Cross, entrare short sul Death Cross. Uscire con un profitto del 10% o quando RSI > 70 e ripetere all'infinito.

**Configurazione in goodcryptoX**

Crea bot DCA

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

**Configurazione in TradingView**

* Crea tre avvisi sullo stesso grafico:
  1. SMA50 incrocia verso l'alto SMA200 → invia a **Enter Buy** webhook
  2. SMA50 incrocia verso il basso SMA200 → invia a **Enter Sell** webhook
  3. RSI > 70 → invia a **Chiudi posizione** webhook

### 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                             |