# Webhooks

goodcryptoX vă permite să automatizați acțiunile de tranzacționare prin webhook-uri TradingView — un mecanism puternic pentru declanșarea ordinelor și acțiunilor boților direct din semnalele dvs.

Spre deosebire de unele implementări care tratează webhook-urile ca pe 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 activează pur și simplu o acțiune predefinită asupra unui anumit ordin sau bot — nu se interpretează parametri sau comenzi.

În viitorul apropiat, vom lansa un nou [Bot de strategie TradingView](https://docs.goodcrypto.app/goodcryptox-ro/perp-dex-uri/functionalitate-viitoare/bot-strategie-tradingview) 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 momentan doar de la serverele TradingView — nu sunt permise IP-uri personalizate sau surse externe.\
> Dacă trebuie să utilizați o sursă 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 propriul URL webhook dedicat
* Trebuie să creați mai întâi ordinul sau botul pentru a obține URL-ul (vor apărea în **Webhook-uri** secțiunea din **Detalii**)
* Trimiterea **oricărui** payload de webhook către acel URL va declanșa acțiunea

> URL-urile webhook sunt specifice acțiunii, nu utilizatorului. Trebuie să creați 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 suportate pentru ordine și boți

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:

* Ordine stop-market / stop-limit declanșate
* Activarea ordinelor trailing (pornire trailing)
* Declanșatoare take-profit și stop-loss&#x20;
* Condiția de intrare a boților DCA

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

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

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

> **Anulează** webhook — întotdeauna disponibil în toate ordinele și boții
>
> **Închide poziția** webhook — întotdeauna disponibil în detaliile botului DCA

Pe scurt:

| Acțiune                             | Suportat? | Note                                                                 |
| ----------------------------------- | --------- | -------------------------------------------------------------------- |
| Anulează ordinul                    | ✅         | Întotdeauna afișat în detalii                                        |
| Declanșează ordin Stop              | ✅         | Trebuie selectat webhook la configurare                              |
| Activează ordin Trailing            | ✅         | Pornire trailing = webhook                                           |
| Declanșează take profit / stop loss | ✅         | Opțional declanșat prin webhook                                      |
| Bot DCA - intrare                   | ✅         | Intrare cumpărare/vânzare via webhook (trebuie setat la configurare) |
| Bot DCA - ieșire                    | ✅         | Închide poziția via webhook (întotdeauna disponibil)                 |
| Bot Grid - intrare                  | 🚫        | Încă nu este suportat                                                |

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

Dacă configurați un grup de take-profit folosind webhook ca metodă de declanșare, acestea vor împărți același URL webhook. De fiecare dată când webhook-ul este declanșat, următorul ordin TP din secvență se va executa — 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 nouă alertă bazată pe strategia, indicatorul sau condiția dvs.
3. În **setările alertei**, activați caseta de selectare **„Webhook URL”**
4. Lipiți URL-ul webhook specific din secțiunea Webhook-uri a goodcryptoX
5. Lăsați **câmpul mesaj** nemodificat (orice conținut este acceptabil — goodcryptoX ignoră momentan payload-ul)
6. Salvați alerta

### Strategii care se repetă (prin bot DCA)

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

Vom introduce în curând un [bot de strategie TradingView](https://docs.goodcrypto.app/goodcryptox-ro/perp-dex-uri/functionalitate-viitoare/bot-strategie-tradingview) dedicat pentru a sprijini tranzacții repetate cu acțiuni multiple, dar între timp, botul DCA oferă o modalitate flexibilă de a repeta strategia dvs. bazată pe webhook.

#### Buclă pur webhook

Pentru a configura un bot care intră într-o poziție la un webhook, iese la 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”**&#x20;

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

Odată ce botul este lansat, veți vedea următoarele URL-uri webhook în Detalii → Webhook-uri ale botului: **Detalii → Webhook-uri** secțiunea:

* **Intrare Cumpără** — deschide o poziție Long
* **Intrare Vinde** — deschide o poziție Short
* **Închide poziția** — închide poziția activă (long sau short)
* **Anulează** — oprește botul

**Logica de execuție**

* Când botul primește **Intrare Cumpără**, deschide o poziție long.
* Când primește **Intrare Vinde**, deschide o poziție short.
* 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 de intrare ulterioare sunt **ignorate**
  * Botul nu va mări sau inversa poziția curentă pe semnalele de intrare
  * 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 ciclu complet intrare → ieșire → resetare la infinit.

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

Botul DCA suportă multiple straturi de control care pot fi combinate pentru a construi strategii flexibile:

* **Intrare**: via webhook, semnal sau asap
* **Ieșire**: via webhook, sau TP/SL încorporate 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ă

Acest lucru face posibil designul de:

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

### Exemple practice de strategii cu webhook-uri

#### Exemplul 1: Ordin unic + multiple take-profit-uri (rebounce pe Bollinger Band)

**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 stop-market 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%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**Configurare în TradingView**

Creați patru alerte:

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

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

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

Lipiți URL-ul webhook specific din secțiunea Webhook-uri a goodcryptoX. Lăsați câmpul Mesaj nemodificat — 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 un 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ă în sus SMA200 → trimiteți la **Intrare Cumpără** webhook
  2. SMA50 traversează în jos SMA200 → trimiteți la **Intrare Vinde** webhook
  3. RSI > 70 → trimiteți la **Închide poziția** webhook

{% hint style="info" %}
Botul DCA deține doar o poziție la un moment dat. În timp ce este într-o poziție, ignoră noile webhook-uri de intrare până când poziția este închisă.

Dacă doriți să puteți deschide poziții Long și Short pe același instrument în paralel - creați doi boți separați și trimiteți Intrare Cumpără la unul și Intrare Vinde la celălalt
{% endhint %}

### Rezumat

| Concept              | Descriere                                                            |
| -------------------- | -------------------------------------------------------------------- |
| Model de declanșare  | Fiecare acțiune are propriul URL webhook                             |
| Flux de configurare  | Creați ordin → copiați URL-ul webhook → lipiți în alerta TradingView |
| Strategie repetitivă | Folosiți botul DCA cu repetare activată                              |

### Tutoriale video

#### **Introducere în tranzacționarea cu webhook-uri**

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

#### **Folosirea botului DCA cu webhook-uri**

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

#### **Multiple take-profit-uri cu webhook-uri**

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