# Webhooks

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

Bazı uygulamaların webhokları "3 BTC al" gibi parametreli komutlar gönderebileceğiniz programlanabilir bir API gibi ele almasının aksine, goodcryptoX şu anda tetikleyici tabanlı bir modeli destekliyor. Her webhok yalnızca belirli bir emir veya bot üzerindeki önceden tanımlanmış bir eylemi etkinleştirir — 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 webhoklar aracılığıyla dinamik sembol seçimi, miktarlar, emir tipleri ve çoklu sembol mantığı dahil olmak üzere tam strateji talimatlarını destekleyerek fiilen bir API katmanı gibi çalışacak. Takipte kalın

### Güvenlik ve erişim

* Şimdilik webhoklar yalnızca TradingView sunucularından kabul edilir — özel IP'ler veya harici kaynaklar desteklenmez.
* Özel bir webhok kaynağı kullanmanız gerekiyorsa, bizimle iletişime geçin: <support@goodcrypto.app> erişim talep etmek için.
* Webhoklar yalnızca aktif PRO [planı](https://docs.goodcrypto.app/goodcryptox-tr/ekosistem/abonelik-planlari) ve üzeri kullanıcılar için kullanılabilir.

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

* Her emir veya bot **eyleminin** kendisinin ayrılmış bir webhok 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**)
* Gönderme **herhangi bir** o URL'ye yapılan webhok yükü eylemi tetikleyecektir

> Webhok URL'leri kullanıcıya göre değil, eyleme özeldir. Her eylem için bir webhok oluşturmalısınız; örn. giriş için bir, kar al için bir, zararı durdur için bir vs. her bot veya emir için

### Desteklenen emir ve bot eylemleri

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

* Stop-market / stop-limit emirlerinin tetiklenmesi
* Trailing emirlerin etkinleştirilmesi (trailing başlatma)
* Kar al ve zararı durdur 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 webhok URL'lerini **Detaylar** emir veya botunuzun içinde 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** webhoku — tüm emirlerde ve botlarda her zaman mevcuttur
>
> **Pozisyonu kapat** webhoku — DCA bot detaylarında her zaman mevcuttur

Özetle:

| Eylem                          | Destekleniyor mu? | Notlar                                                  |
| ------------------------------ | ----------------- | ------------------------------------------------------- |
| Emri iptal et                  | ✅                 | Detaylarda her zaman gösterilir                         |
| Stop emrini tetikle            | ✅                 | Kurulumda webhok seçilmelidir                           |
| Trailing emri etkinleştir      | ✅                 | Trailing başlatma = webhok                              |
| Kar al / zararı durdur tetikle | ✅                 | İsteğe bağlı olarak webhok ile tetiklenebilir           |
| DCA botu - giriş               | ✅                 | Giriş alım/satımı webhok ile (kurulumda ayarlanmalıdır) |
| DCA botu - çıkış               | ✅                 | Pozisyonu webhok ile kapama (her zaman mevcut)          |
| Grid botu - giriş              | 🚫                | Henüz desteklenmiyor                                    |

{% hint style="info" %}
**Webhoklarla çoklu kar al hedefleri**

Eğer tetikleme yöntemi olarak webhoku seçerek bir kar al grubu kurarsanız, hepsi aynı webhok URL'sini paylaşır. Webhok her tetiklendiğinde, sıra içindeki bir sonraki TP emri yürütülür — teker teker.
{% endhint %}

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

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

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

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

Bir webhok tarafından tetiklenen emir (ör. TP ve SL ile stop-market) bir **tek seferlik kurulumdur**. Emir gerçekleştirildiğinde ve bağlı TP veya SL tetiklendiğinde, tüm işlem tamamlanır. Bu yapının **otomatik olarak tekrarlanmasını**isterseniz, emirlerle bunu yapmak mümkün değildir — ancak artık DCA botu kullanarak bunu başarmak mümkündür.

Yakında tekrarlayan çoklu eylem işlemlerini desteklemek için özel bir [TradingView strateji botu](https://docs.goodcrypto.app/goodcryptox-tr/cex-ticareti/yaklasan-ozellikler/tradingview-strateji-botu) tanıtacağız; ancak bu arada DCA botu webhok tabanlı stratejinizi tekrarlamak için esnek bir yol sunar.

#### Saf webhok döngüsü

Webhokla giriş yapan, webhokla çıkan ve sonra tekrarlayan bir bot kurmak için:

1. Ayarla **giriş koşulu** = webhok
2. Ayarla **ortalama verme emirleri** = 0 (ortalama vermeyi devre dışı bırak)
3. Hem **kar**-**al** ve **zararı durdur**
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 → Webhooks** bölümünde aşağıdaki webhok URL'lerini göreceksiniz:

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

**İcra mantığı**

* Bot **Enter Buy**aldığında, bir long pozisyon açar.
* Bot **Enter Sell**aldığında, bir short pozisyon açar.
* Bot sadece **boşken aldığı ilk giriş webhokuna yanıt verir.** pozisyon açıkken
* Herhangi bir sonraki giriş sinyali
  * yoksayılır **Bot, Giriş sinyalleriyle mevcut pozisyonu artırmaz veya tersine çevirmez**
  * Kabul edilen tek sinyaller
  * pozisyonu kapat **veya tetiklenmiş bir TP/SL'dir (eğer yapılandırıldıysa)** Pozisyon kapatıldıktan (manuel, webhok ile veya SL/TP ile) sonra, bot sıfırlanır ve bir sonraki Giriş webhokunu bekler.
* Bu döngü, bot aktif kaldığı sürece devam eder ve size tam bir giriş → çıkış → sıfırlama döngüsünü sınırsız olarak tekrarlama imkanı sağlar.

Saf webhok modu ile hibrit kurulumlar

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

Giriş

* **: webhok, sinyal veya asap ile**Çıkış
* **: webhok veya yerleşik fiyat tabanlı TP/SL ile**Ortalama verme
* **: isteğe bağlı; devre dışı bırakılabilir**Şunları yapabilirsiniz:

Bir botu tamamen webhok sinyalleriyle çalıştırmak (giriş ve çıkış)

* Webhok çıkışları kullansanız bile geri çekilme olarak fiyat tabanlı TP/SL eklemek
* Ek koruma için ortalama verme emirleri eklemek
* Bu, şu stratejileri tasarlamayı mümkün kılar:

Tam otomatik döngü stratejileri (saf webhok)

* Sinyal odaklı botlar ile manuel yedekleme mekanizmaları
* Çok katmanlı çıkışlara sahip hibrit kurulumlar
* Pratik webhok strateji örnekleri

### Örnek 1: Tek seferlik emir + çoklu kar al hedefleri (Bollinger Band sıçraması)

#### Hedef:

**Fiyat alt Bollinger Band'ı kırdığında al, tırmanırken kademeli olarak sat.** goodcryptoX'te kurulum

**Tetikleme koşulu = webhok olan bir stop-market emri oluşturun**

* Üç kar al hedefi ekleyin. TP tetikleyicisi = webhok
* TradingView'de kurulum

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

**Dört uyarı oluşturun:**

Fiyat alt bandı kırar → ana emrin

1. Tetikleyici **webhok URL'sine gönder** Fiyat bant içine döner →
2. Kar Al Tetikleyicisine gönder **Fiyat orta bandı keser →** Fiyat bant içine döner →
3. gönder **Fiyat orta bandı keser →** Fiyat bant içine döner →
4. Fiyat üst bandı kırar → gönder **Fiyat orta bandı keser →** Fiyat bant içine döner →

<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**işaret kutusunu etkinleştirin **“Webhook URL”**

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

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

**Fiyat alt Bollinger Band'ı kırdığında al, tırmanırken kademeli olarak sat.** Golden Cross'ta long aç, Death Cross'ta short aç. %10 karla çık veya RSI > 70 olduğunda çık ve sonsuza kadar tekrarla.

**Tetikleme koşulu = webhok olan bir stop-market emri oluşturun**

DCA bot oluşturun

* Giriş koşulu = webhok
* Ortalama verme = kapalı (0 olarak ayarlayın)
* Kar Al = %10
* Zararı durdur = kapalı
* Etkinleştir: "TP'de tekrarla"

**Dört uyarı oluşturun:**

* Aynı grafik üzerinde üç uyarı oluşturun:
  1. SMA50, SMA200'ün üzerine geçerse → **Enter Buy** webhoka gönderin
  2. SMA50, SMA200'ün altına geçerse → **Enter Sell** webhoka gönderin
  3. RSI > 70 → gönder **Pozisyonu kapat** webhoka gönderin

{% hint style="info" %}
DCA bot aynı anda yalnızca bir pozisyon tutar. Pozisyonda iken, pozisyon kapanana kadar yeni giriş webhoklarını yoksayar.

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 webhok URL'si vardır                                  |
| Kurulum akışı        | Emri oluştur → webhok URL'sini kopyala → TradingView uyarısına yapıştır |
| Tekrarlayan strateji | Tekrar etkinleştirilmiş DCA botu kullanın                               |
| Erişim               | PRO planı veya üzeri gerektirir                                         |

### Video eğitimleri

#### **Webhok ticaretine giriş**

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

#### **Webhoklarla DCA botu kullanımı**

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

#### **Webhoklarla çoklu kar al hedefleri**

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