# Webhooks

goodcryptoX, TradingView webhooks aracılığıyla işlem eylemlerini otomatikleştirmenize olanak tanır — sinyallerinizden doğrudan emirleri ve bot eylemlerini tetiklemek için güçlü bir mekanizma.

Bazı uygulamaların webhooks'u "3 BTC al" gibi parametreli komutlar gönderdiğiniz programlanabilir bir API gibi ele almasının aksine, goodcryptoX şu anda tetikleyici tabanlı bir modeli destekler. Her webhook yalnızca belirli bir emir veya bot üzerindeki önceden tanımlanmış bir eylemi etkinleştirir — hiçbir parametre veya komut yorumlanmaz.

Yakın gelecekte yeni bir [TradingView Strateji botu](https://docs.goodcrypto.app/goodcryptox-tr/perp-dexler/yaklasan-ozellikler/tradingview-strateji-botu) başlatacağız; bu bot webhooks aracılığıyla dinamik sembol seçimi, miktarlar, emir türleri ve çoklu sembol mantığı dahil olmak üzere tam strateji talimatlarını destekleyerek etkili bir şekilde bir API katmanı görevi görecektir. Takipte kalın

> Şimdilik webhooks yalnızca TradingView sunucularından kabul edilir — özel IP'ler veya harici kaynaklar yoktur.\
> Özel bir webhook kaynağı kullanmanız gerekiyorsa, erişim talep etmek için bizimle iletişime geçin: <support@goodcrypto.app> ve erişim talep edin.

### goodcryptoX'te webhooks nasıl çalışır

* Her emir veya bot **eyleminin** kendi özel webhook URL'si vardır
* URL'yi almak için önce emri veya botu oluşturmalısınız (bunlar **Webhooks** bölümünde görünecektir) **Detaylar**)
* Herhangi bir **herhangi bir** o URL'ye gönderilen webhook yükü eylemi tetikleyecektir

> Webhook URL'leri kullanıcıya özel değil, eyleme özeldir. Her eylem için bir webhook oluşturmalısınız; örn. her bot veya emir için giriş, kar al, zarar durdurma vb. için ayrı ayrı birer tane.

### Desteklenen emir ve bot eylemleri

Emrinizin veya botunuzun **bir webhook tarafından tetiklenmesini**istiyorsanız, kurulum sırasında tetikleme koşulu olarak webhook'u seçmelisiniz **tetikleme koşulu olarak**. Bu şunlar için geçerlidir:

* Stop-market / stop-limit emirleri tetikler
* Trailing emirlerin aktifleşmesi (trailing başlatma)
* Kar al ve zarar durdurma tetiklemeleri&#x20;
* DCA botlarının giriş koşulu

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

Oluşturduktan sonra, tüm kullanılabilir webhook URL'lerini **Detaylar** emir veya botunuzun şu bölümünde bulacaksınız:

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

> **İptal** webhook — tüm emir ve botlarda her zaman mevcuttur
>
> **Pozisyonu kapatma** webhook — DCA bot detaylarında her zaman mevcuttur

Özetle:

| Eylem                             | Destekleniyor mu? | Notlar                                                        |
| --------------------------------- | ----------------- | ------------------------------------------------------------- |
| Emri iptal et                     | ✅                 | Detaylarda her zaman gösterilir                               |
| Stop emrini tetikle               | ✅                 | Kurulumda webhook seçilmeli                                   |
| Trailing emri aktive et           | ✅                 | Trailing başlatma = webhook                                   |
| Kar al / zarar durdurmayı tetikle | ✅                 | İsteğe bağlı olarak webhook ile tetiklenir                    |
| DCA botu - giriş                  | ✅                 | Webhook ile alım/satım girişi (kurulum sırasında ayarlanmalı) |
| DCA botu - çıkış                  | ✅                 | Webhook ile pozisyon kapatma (her zaman kullanılabilir)       |
| Grid botu - giriş                 | 🚫                | Henüz desteklenmiyor                                          |

{% hint style="info" %}
**Webhook'larla birden fazla kar al hedefi**

Webhook'u tetikleme yöntemi olarak kullanarak bir kar-al grubu oluşturduğunuzda, bunların hepsi aynı webhook URL'sini paylaşır. Webhook her tetiklendiğinde, sıradaki bir sonraki TP emri — birer birer — çalışır.
{% endhint %}

### TradingView'de uyarılar nasıl ayarlanır

goodcryptoX'te siparişinizi veya botunuzu oluşturup belirli bir işlem için webhook URL'sini kopyaladıktan sonra, bunu TradingView uyarılarınıza bağlama adımları şunlardır:

1. TradingView'deki grafiğinize gidin
2. Stratejinize, göstergenize veya koşulunuza dayalı yeni bir uyarı oluşturun
3. Uyarı **ayarlarında**onay kutusunu etkinleştirin **“Webhook URL”**
4. goodcryptoX Webhooks bölümünden alınan belirli webhook URL'sini yapıştırın
5. Mesaj **alanını** olduğu gibi bırakın (herhangi bir içerik uygundur — goodcryptoX şu anda yükü yoksayar)
6. Uyarıyı kaydedin

### Tekrarlayan stratejiler (DCA botu aracılığıyla)

Webhook ile tetiklenen bir sipariş (ör. TP ve SL ile stop-market) bir **tek seferlik kurulum**dur. Sipariş yürütüldüğünde ve bağlı TP veya SL tetiklendiğinde, tüm işlem tamamlanır. Bu yapının **otomatik olarak tekrarlanmasını**isterseniz, siparişlerle bu mümkün değildir — ancak şimdi DCA botu kullanılarak başarılabilir.

Yakında özel bir [TradingView strateji botu](https://docs.goodcrypto.app/goodcryptox-tr/perp-dexler/yaklasan-ozellikler/tradingview-strateji-botu) tanıtacağız; tekrarlayan çok işlemli işlemleri desteklemek için, ancak bu arada DCA botu webhook ile yönlendirilen stratejinizi tekrarlamak için esnek bir yol sağlar.

#### Saf webhook döngüsü

Webhook ile pozisyona giren, webhook ile çıkan ve ardından tekrarlayan bir bot kurmak için:

1. Giriş **koşulunu** = webhook olarak ayarlayın
2. Giriş **ortalama emirlerini** = 0 (ortalama yapmayı devre dışı bırakın)
3. Hem **kar**-**almayı** hem de **zarar durdurmayı**
4. devre dışı bırakın **"Pozisyon kapatıldığında tekrarla" seçeneğini etkinleştirin**&#x20;

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

Bot başlatıldıktan sonra, botun **Detaylar → Webhooklar** bölümünde aşağıdaki webhook URL'lerini göreceksiniz:

* **Alış Girişi** — Long pozisyonu açar
* **Satış Girişi** — Kısa pozisyon açar
* **Pozisyonu kapatma** — aktif pozisyonu (long veya short) kapatır
* **İptal** — botu durdurur

**Yürütme mantığı**

* Bot şunu aldığında **Alış Girişi**, bir long pozisyon açar.
* Bunu aldığında **Satış Girişi**, bir short pozisyon açar.
* Bot **yalnızca ilk giriş webhook'una yanıt verecektir** boşta olduğu sırada alır.
* Bir pozisyon açıkken:
  * Herhangi bir ek giriş sinyali **yoksayılır**
  * Bot, Giriş sinyalleriyle mevcut pozisyonu artırmaz veya tersine çevirmez
  * Kabul edilen tek sinyaller **pozisyonu kapat** veya tetiklenmiş TP/SL (eğer yapılandırıldıysa)
* Pozisyon kapatıldığında (manüel, webhook ile veya SL/TP ile), bot sıfırlanır ve bir sonraki Giriş webhook'unu bekler.

Bu döngü bot aktif kaldığı sürece devam eder ve tam bir giriş → çıkış → sıfırlama döngüsünü sınırsızca tekrarlamanıza olanak tanır.

#### Saf webhook modu vs hibrit düzenlemeler

DCA botu, esnek stratejiler oluşturmak için birleştirilebilen birden çok kontrol katmanını destekler:

* **Giriş**: webhook, sinyal veya asap aracılığıyla
* **Çıkış**: webhook ile veya dahili fiyat tabanlı TP/SL ile
* **Ortalama alma**: isteğe bağlı; devre dışı bırakılabilir

Şunları yapabilirsiniz:

* Bir botu tamamen webhook sinyalleriyle (giriş ve çıkış) çalıştırın
* Webhook çıkışlarını kullanıyor olsanız bile yedek olarak fiyat tabanlı TP/SL ekleyin
* Ek koruma için ortalama alma emirleri ekleyin

Böylece tasarlamak mümkün olur:

* Tam otomatik döngü stratejileri (saf webhook)
* Manüel yedekleri olan sinyal odaklı botlar
* Çok katmanlı çıkışlara sahip hibrit düzenlemeler

### Pratik webhook strateji örnekleri

#### Örnek 1: Tek seferlik emir + birden fazla kâr alma (Bollinger Band sekmesi)

**Hedef:** Fiyat alt Bollinger Band'ını kırdığında al, yükseldikçe kademeli olarak sat.

**goodcryptoX'te kurulum**

* Tetikleme koşulu = webhook olan bir stop-market emri oluşturun
* Üç adet kâr al hedefi ekleyin. TP tetikleyicisi = webhook

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

**TradingView'de kurulum**

Dört uyarı oluşturun:

1. Fiyat alt bandı ihlal eder → ana emrin **Tetikleyicisine** webhook URL'si
2. Fiyat banda geri döner → şuna gönder **Kâr Alma Tetikleyicisi** webhook URL'si
3. Fiyat orta bandı aşıyor → gönder: **Kâr Alma Tetikleyicisi** webhook URL'si
4. Fiyat üst bandı ihlal ediyor → gönder: **Kâr Alma Tetikleyicisi** webhook URL'si

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

Uyarı **ayarlarında**onay kutusunu etkinleştirin **“Webhook URL”**

goodcryptoX Webhooks bölümünden belirli webhook URL'sini yapıştırın. Mesaj alanını olduğu gibi bırakın — kullanılmaz.

#### Örnek 2: DCA bot ile tekrarlayan strateji (Altın/Ölüm Kesişimi)

**Hedef:** Altın Kesişimi'nde long girin, Ölüm Kesişimi'nde short girin. %10 karla veya RSI > 70 olduğunda çıkış yapın ve sonsuza dek tekrarlayın.

**goodcryptoX'te kurulum**

DCA botu oluştur

* Giriş koşulu = webhook
* Ortalama alma = kapalı (0 olarak ayarlayın)
* Kar al = %10
* Zarar durdurma = kapalı
* Etkinleştir: "TP'de Tekrarla"

**TradingView'de kurulum**

* Aynı grafikte üç uyarı oluşturun:
  1. SMA50, SMA200'ün üzerine çıkıyor → gönder: **Alış Girişi** webhook
  2. SMA50, SMA200'ün altına iniyor → gönder: **Satış Girişi** webhook
  3. RSI > 70 → gönder: **Pozisyonu kapatma** webhook

{% hint style="info" %}
DCA bot aynı anda yalnızca bir pozisyon tutar. Pozisyonda olduğu sürece pozisyon kapanana kadar yeni giriş webhook'larını yok sayar.

Aynı enstrümanda paralel olarak Long ve Short pozisyonlarına girmek istiyorsanız - iki ayrı bot oluşturun ve Enter Buy'u birine, Enter Sell'i diğerine gönderin
{% endhint %}

### Özet

| Kavram               | Açıklama                                                                 |
| -------------------- | ------------------------------------------------------------------------ |
| Tetikleyici modeli   | Her eylemin kendi webhook URL'si vardır                                  |
| Kurulum akışı        | Emir oluştur → webhook URL'sini kopyala → TradingView uyarısına yapıştır |
| Tekrarlayan strateji | Tekrar etkinleştirilmiş DCA botunu kullanın                              |

### Video dersleri

#### **Webhook ticaretine giriş**

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

#### **Webhook'larla DCA bot kullanımı**

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

#### **Webhook'larla birden fazla kar al**

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