# Webhooks

goodcryptoX vă permite să automatizați tranzacționarea pe DEX prin webhook-uri TradingView — un mecanism puternic pentru declanșarea ordinelor și acțiunilor botului direct din semnalele dvs.

Spre deosebire de unele implementări care tratează webhook-urile ca un API programabil (unde trimiteți comenzi parametrizate precum "cumpără 3 BTC"), goodcryptoX acceptă în prezent un model bazat pe declanșatoare. Fiecare webhook pur și simplu activează o acțiune predefinită asupra unui anumit ordin sau bot — nu se interpretează parametri sau comenzi.

În viitorul apropiat vom lansa un nou bot TradingView Strategy care va suporta instrucțiuni complete de strategie prin webhook-uri, inclusiv selecție dinamică a simbolului, cantități, tipuri de ordine și logică multi-simbol — acționând efectiv ca un strat API. Rămâneți aproape

> Webhook-urile sunt acceptate doar de la serverele TradingView pentru moment — fără IP-uri personalizate sau surse externe.\
> Dacă aveți nevoie să utilizați o sursă de webhook personalizată, contactați-ne la <support@goodcrypto.app> pentru a solicita acces.

### Cum funcționează webhook-urile în goodcryptoX

* Fiecare ordin sau bot **acțiune** are propria sa adresă URL dedicată pentru webhook
* Trebuie să creați mai întâi ordinul sau botul pentru a obține URL-ul (vor apărea în **Webhook-uri** secțiunea **Detalii**)
* Trimiterea **orice** payload de webhook către acel URL va declanșa acțiunea

Iată o prezentare video:

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

> URL-urile webhook sunt specifice acțiunii. Trebuie să creați câte un webhook pentru fiecare acțiune, de ex. unul pentru intrare, unul pentru take profit, unul pentru stop loss etc. pentru fiecare bot sau ordin

### Acțiuni de ordin și bot acceptate

Dacă doriți ca ordinul sau botul dvs. să fie **declanșat de un webhook**, trebuie să selectați webhook ca **condiție de declanșare în timpul configurării**. Aceasta se aplică la:

* Ordinelor limită - declanșator
* Activarea ordinului trailing (începere trailing)
* Declanșatoare pentru take-profit și stop-loss&#x20;
* Condiția de intrare a botului DCA

> **Anulare** webhook — întotdeauna disponibil în toate ordinele și bot-urile
>
> **Închidere poziție** webhook — întotdeauna disponibil în detaliile botului DCA

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

După creare, veți găsi toate URL-urile webhook disponibile în **Detalii** al ordinului sau botului dvs.:

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

Pe scurt:

| Acțiune                             | Acceptat? | Note                                                                  |
| ----------------------------------- | --------- | --------------------------------------------------------------------- |
| Anulează ordinul                    | ✅         | Întotdeauna afișat în detalii                                         |
| Declanșează Ordin Limită            | ✅         | Trebuie selectat webhook la configurare                               |
| Activează Ordin Trailing            | ✅         | Începere trailing = webhook                                           |
| Declanșează take profit / stop loss | ✅         | Opțional declanșat prin webhook                                       |
| Bot DCA - intrare                   | ✅         | Intrare cumpărare/vânzare prin webhook (trebuie setat la configurare) |
| Bot DCA - ieșire                    | ✅         | Închidere poziție prin webhook (întotdeauna disponibil)               |

{% hint style="info" %}
**Ținte multiple de take-profit cu webhook-uri**

Dacă configurați un grup de take-profit folosind webhook ca metodă de declanșare, ele vor împărți toate aceeași adresă URL de webhook. De fiecare dată când webhook-ul este declanșat, următorul ordin TP din secvență va fi executat — unul câte unul.
{% endhint %}

### Cum să configurați alertele în TradingView

După ce ați creat ordinul sau botul în goodcryptoX și ați copiat URL-ul webhook pentru o acțiune specifică, iată cum să-l legați de alertele din TradingView:

1. Accesați graficul dvs. în TradingView
2. Creați o alertă nouă pe baza strategiei, indicatorului sau condiției dvs.
3. În **setările alertei**, activați caseta de selectare **„Webhook URL”**
4. Lipiți URL-ul webhook specific din goodcryptoX **Webhook-uri disponibile** secțiunea
5. Lăsați **câmpul mesaj** nemodificat (orice conținut este ok — goodcryptoX ignoră payload-ul pentru moment)
6. Salvați alerta

### Strategii repetitive (prin bot DCA)

Un ordin declanșat prin webhook (de ex. limit cu TP și SL) este o **configurare unică**. Odată ce ordinul se execută și TP-ul sau SL-ul legat se declanșează, întreaga tranzacție este completă. Dacă doriți ca această structură să **se repete automat**, acest lucru nu este posibil cu ordinele — dar este realizabil acum folosind botul DCA.

În curând vom introduce un bot dedicat de strategie TradingView pentru a susține tranzacții repetitive cu mai multe acțiuni, dar între timp botul DCA oferă o modalitate flexibilă de a repeta strategia dvs. controlată prin webhook.

#### Buclă pură de webhook

Pentru a configura un bot care intră într-o poziție pe un webhook, iese pe un webhook și apoi se repetă:

1. Setați **condiția de intrare** = webhook
2. Setați **ordine de mediere** = 0 (dezactivați medierea)
3. Dezactivați ambele **take**-**profit** și **stop-loss**
4. Activați **„Repetă la închiderea poziției”**

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

Odată lansat botul, veți vedea următoarele URL-uri webhook sub **Detalii → Webhooks** secțiunea:

* **Enter Buy** — deschide o poziție Long
* **Închidere poziție** — închide poziția activă (long sau short)
* **Anulare** — oprește botul

**Logică de execuție**

* Când botul primește **Enter Buy**, deschide o poziție long.
* Botul va **răspunde doar la primul webhook de intrare** pe care îl primește în timp ce este inactiv.
* În timp ce o poziție este deschisă:
  * Orice semnale suplimentare de intrare sunt **ignorate**
  * Singurele semnale acceptate sunt **închide poziția** sau un TP/SL declanșat (dacă este configurat)
* Odată ce poziția este închisă (manual, prin webhook sau prin SL/TP), botul se resetează și așteaptă următorul webhook de intrare.

Această buclă continuă atât timp cât botul rămâne activ, permițându-vă să repetați un ciclu complet intrare → ieșire → resetare la nesfârșit.

#### Mod pur webhook vs configurații hibride

Botul DCA acceptă mai multe straturi de control care pot fi combinate pentru a construi strategii flexibile:

* **Intrare**: prin webhook, semnal sau instant
* **Ieșire**: prin webhook, sau TP/SL integrate bazate pe preț
* **Mediere**: opțională; poate fi dezactivată

Puteți:

* Rula un bot în întregime prin semnale webhook (intrare și ieșire)
* Adăuga TP/SL bazate pe preț ca soluții de rezervă, chiar dacă folosiți ieșiri prin webhook
* Adăuga ordine de mediere pentru protecție suplimentară

Aceasta face posibil să proiectați:

* Strategii buclă complet automate (pur webhook)
* Boti conduși de semnale cu fallback-uri manuale
* Configurații hibride cu ieșiri în mai multe straturi

### Exemple practice de strategii cu webhook

#### Exemplul 1: Ordin unic + multiple take profit-uri (rebound de pe banda Bollinger)

**Scop:** Cumpărați când prețul depășește banda Bollinger inferioară, vindeți progresiv pe măsură ce urcă.

**Configurare în goodcryptoX**

* Creați un ordin limită cu condiția de declanșare = webhook
* Adăugați trei ținte de take-profit. Declanșator TP = webhook

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

**Configurare în TradingView**

Creați patru alerte:

1. Prețul depășește banda inferioară → trimiteți către **Declanșator** URL webhook
2. Prețul revine în interiorul benzii → trimiteți către **Declanșator Take Profit** URL webhook
3. Prețul traversează banda mediană → trimiteți către **Declanșator Take Profit** URL webhook
4. Prețul depășește banda superioară → trimiteți către **Declanșator Take Profit** URL webhook

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

În **setările alertei**, activați caseta de selectare **„Webhook URL”**

Lipiți URL-ul webhook specific din goodcryptoX **Webhook-uri disponibile** secțiunea. Lăsați câmpul Mesaj așa cum este — nu este folosit.

#### Exemplul 2: Strategie repetitivă cu bot DCA (Golden/Death Cross)

**Scop:** Intrați long la Golden Cross, intrați short la Death Cross. Ieșiți cu profit de 10% sau când RSI > 70 și repetați la nesfârșit.

**Configurare în goodcryptoX**

Creați bot DCA

* Condiție de intrare = webhook
* Mediere = dezactivat (setați la 0)
* Take Profit = 10%
* Stop loss = dezactivat
* Activați: "Repetă la TP"

**Configurare în TradingView**

* Creați trei alerte pe același grafic:
  1. SMA50 traversează peste SMA200 → trimiteți către **Enter Buy** webhook
  2. SMA50 traversează sub SMA200 → trimiteți către **Enter Sell** webhook
  3. RSI > 70 → trimiteți către **Închidere poziție** webhook

### Rezumat

| Concept              | Descriere                                                              |
| -------------------- | ---------------------------------------------------------------------- |
| Model de declanșare  | Fiecare acțiune are propria adresă URL de webhook                      |
| Flux de configurare  | Creează ordin → copiază URL-ul webhook → lipește în alerta TradingView |
| Strategie repetitivă | Folosiți botul DCA cu repetare activată                                |