# Webhooks

goodcryptoX, TradingView webhook'ları aracılığıyla DEX işlemlerini otomatikleştirmenize olanak tanır — sinyallerinizden doğrudan emirleri ve bot eylemlerini tetiklemenin güçlü bir mekanizması.

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

Yakın gelecekte, dinamik sembol seçimi, miktarlar, emir tipleri ve çoklu sembol mantığı da dahil olmak üzere webhook'lar aracılığıyla tam strateji talimatlarını destekleyen yeni bir TradingView Strateji botu başlatacağız — etkili bir şekilde bir API katmanı gibi davranacak. Takipte kalın

> Şimdilik webhook'lar yalnızca TradingView sunucularından kabul edilir — özel IP'ler veya harici kaynaklar yok.\
> Özel bir webhook kaynağı kullanmanız gerekiyorsa, erişim talebinde bulunmak için <support@goodcrypto.app> adresinden bizimle iletişime geçin.

### goodcryptoX'te webhook'lar nasıl çalışır

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

İşte bir video genel bakışı:

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

> Webhook URL'leri eylem-özelidir. Her eylem için bir webhook oluşturmalısınız, örn. her bot veya emir için giriş, kar al, stop loss vb. için ayrı ayrı.

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

* Limit emirleri tetikler
* Trailing emir aktivasyonu (trailing başlangıcı)
* Kar al ve stop loss tetikleyicileri&#x20;
* DCA bot giriş koşulu

> **İptal et** webhook — tüm emirlerde ve botlarda her zaman kullanılabilir
>
> **Pozisyonu kapat** webhook — DCA bot detaylarında her zaman kullanılabilir

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

Oluşturduktan sonra, tüm kullanılabilir webhook URL'lerini emrinizin veya botunuzun **Detaylar** 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%2FlG04MgjoXROWz32j0tN4%2Fimage.png?alt=media&#x26;token=08009fa1-7757-4495-b60e-1165e12887b3" alt="" width="375"><figcaption></figcaption></figure>

Özetle:

| Eylem                      | Destekleniyor mu? | Notlar                                                      |
| -------------------------- | ----------------- | ----------------------------------------------------------- |
| Emri iptal et              | ✅                 | Detaylarda her zaman gösterilir                             |
| Limit emri tetikle         | ✅                 | Kurulum sırasında webhook seçilmelidir                      |
| Trailing emri etkinleştir  | ✅                 | Trailing başlangıcı = webhook                               |
| kar al / stop loss tetikle | ✅                 | İsteğe bağlı olarak webhook ile tetiklenebilir              |
| DCA bot - giriş            | ✅                 | Giriş al/sat webhook ile (kurulum sırasında ayarlanmalıdır) |
| DCA bot - çıkış            | ✅                 | Pozisyonu webhook ile kapat (her zaman mevcut)              |

{% hint style="info" %}
**Webhook'larla çoklu kar al hedefleri**

Bir kar al grubunu tetikleme yöntemi olarak webhook kullanarak ayarlarsanız, hepsi aynı webhook URL'sini paylaşır. Webhook her tetiklendiğinde, dizideki bir sonraki TP emri sırayla çalışır — teker teker.
{% endhint %}

### TradingView'de alarmları nasıl ayarlarsınız

goodcryptoX'te emrinizi veya botunuzu oluşturup belirli bir eylem için webhook URL'sini kopyaladıktan sonra, bunu TradingView alarmlarınıza nasıl bağlayacağınız:

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

### Tekrarlayan stratejiler (DCA bot ile)

Webhook ile tetiklenen bir emir (örn. TP ve SL ile limit) bir **tek seferlik kurulumdur**. Emir 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ı**istiyorsanız, emirlerle bu mümkün değildir — ancak şimdi DCA bot kullanılarak gerçekleştirilebilir.

Yakında tekrarlayan çoklu eylem işlemleri destekleyecek özel bir TradingView strateji botu tanıtacağız, ancak bu arada DCA bot webhook ile yönlendirilen stratejinizi tekrarlamak için esnek bir yol sağlar.

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

Webhook ile giriş yapan, webhook ile çıkan ve ardından tekrarlayan bir bot kurmak için:

1. Ayarla **giriş koşulu** = webhook
2. Ayarla **ortalama emirleri** = 0 (ortalama devre dışı bırak)
3. Her ikisini de devre dışı bırakın **kar**-**al** ve **stop-loss**
4. Etkinleştir **“Pozisyon kapatıldığında tekrarla”**

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

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

* **Enter Buy** — Long pozisyon açar
* **Pozisyonu kapat** — aktif pozisyonu kapatır (long veya short)
* **İptal et** — botu durdurur

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

* Bot bir **Enter Buy**aldığında, bir long pozisyon açar.
* Bot yalnızca **boşta olduğu sırada aldığı ilk giriş webhook'una yanıt verir.** alır.
* Bir pozisyon açıkken:
  * Herhangi bir ek giriş sinyali **yoksayılır**
  * Kabul edilen tek sinyaller şunlardır **pozisyonu kapat** veya tetiklenen bir TP/SL (yapılandırıldıysa)
* Pozisyon kapatıldığında (manuel, webhook ile veya SL/TP ile), bot sıfırlanır ve bir sonraki Giriş webhook'unu bekler.

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

#### Saf webhook modu vs hibrit kurulumlar

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

* **Giriş**: webhook, sinyal veya anlık üzerinden
* **Çıkış**: webhook veya yerleşik fiyat tabanlı TP/SL ile
* **Ortalama (Averaging)**: isteğe bağlı; devre dışı bırakılabilir

Şunları yapabilirsiniz:

* Bir botu tamamen webhook sinyalleriyle çalıştırmak (giriş ve çıkış)
* Webhook çıkışlarını kullansanız bile fiyat tabanlı TP/SL'yi yedek olarak eklemek
* Ek koruma için ortalama emirleri eklemek

Bu şunları tasarlamayı mümkün kılar:

* Tam otomatik döngü stratejileri (saf webhook)
* Manuel hata kurtarmaları olan sinyal tabanlı botlar
* Çok katmanlı çıkışlara sahip hibrit kurulumlar

### Pratik webhook strateji örnekleri

#### Örnek 1: Tek seferlik emir + çoklu kar al hedefleri (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 limit emri oluşturun
* Üç kar al hedefi ekleyin. TP tetikleyici = webhook

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

**TradingView'de kurulum**

Dört alarm oluşturun:

1. Fiyat alt bandı ihlal eder → ana emrin **Tetikleyici** webhook URL'sine gönder
2. Fiyat bandın içine döner → **Kar Al Tetikleyicisi'ne gönder** webhook URL'sine gönder
3. Fiyat orta bandı keserse → gönder **Kar Al Tetikleyicisi'ne gönder** webhook URL'sine gönder
4. Fiyat üst bandı ihlal ederse → gönder **Kar Al Tetikleyicisi'ne gönder** webhook URL'sine gönder

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

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

goodcryptoX'ten belirli webhook URL'sini yapıştırın **Kullanılabilir webhook'lar** bölümüne. Mesaj alanını olduğu gibi bırakın — kullanılmaz.

#### Örnek 2: DCA bot ile tekrarlayan strateji (Golden/Death Cross)

**Hedef:** Golden Cross'ta long aç, Death Cross'ta short aç. %10 karla veya RSI > 70 olduğunda çık ve sonsuza kadar tekrarla.

**goodcryptoX'te kurulum**

DCA bot oluştur

* Giriş koşulu = webhook
* Ortalama = kapalı (0 olarak ayarla)
* Kar Al = %10
* Stop loss = kapalı
* Şunu etkinleştir: "TP'de tekrarla"

**TradingView'de kurulum**

* Aynı grafikte üç alarm oluşturun:
  1. SMA50, SMA200'ün üstüne kesiyor → gönder **Enter Buy** webhook
  2. SMA50, SMA200'ün altına kesiyor → gönder **Enter Sell** webhook
  3. RSI > 70 → gönder **Pozisyonu kapat** webhook

### Özet

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