# Webhook

goodcryptoX memungkinkan Anda mengotomatisasi tindakan trading melalui webhook TradingView — mekanisme kuat untuk memicu order dan aksi bot langsung dari sinyal Anda.

Tidak seperti beberapa implementasi yang memperlakukan webhook seperti API yang dapat diprogram (di mana Anda mengirim perintah berparameter seperti "beli 3 BTC"), goodcryptoX saat ini mendukung model berbasis pemicu. Setiap webhook hanya mengaktifkan aksi yang telah ditentukan sebelumnya pada order atau bot tertentu — tidak ada parameter atau perintah yang diinterpretasikan.

> Dalam waktu dekat, kami akan meluncurkan [bot Strategi TradingView](/goodcryptox-id/perp-dex/fungsi-yang-akan-datang/bot-strategi-tradingview.md) yang mendukung instruksi strategi penuh melalui webhook, termasuk pemilihan simbol dinamis, kuantitas, tipe order, dan logika multi-simbol — secara efektif berfungsi sebagai lapisan API. Nantikan

### Keamanan dan akses

* Webhook hanya diterima dari server TradingView untuk saat ini — tidak ada IP kustom atau sumber eksternal.
* Jika Anda perlu menggunakan sumber webhook kustom, hubungi kami di <support@goodcrypto.app> untuk meminta akses.
* Webhook hanya tersedia untuk pengguna dengan [paket](/goodcryptox-id/ekosistem/paket-langganan.md) PRO aktif atau lebih tinggi.

### Cara kerja webhook di goodcryptoX

* Setiap order atau bot **aksi** memiliki URL webhook khususnya sendiri
* Anda harus membuat order atau bot terlebih dahulu untuk mendapatkan URL (mereka akan muncul di **Webhook** bagian dari **Detail**)
* Mengirim **apa pun** payload webhook ke URL tersebut akan memicu aksi

> URL webhook bersifat spesifik untuk aksi, bukan spesifik pengguna. Anda harus membuat satu webhook per aksi, mis. satu untuk entry, satu untuk take profit, satu untuk stop loss, dll. untuk setiap bot atau order

### Aksi order dan bot yang didukung

Jika Anda ingin order atau bot Anda **dipicu oleh webhook**, Anda harus memilih webhook sebagai **kondisi pemicu saat pengaturan**. Ini berlaku untuk:

* Order stop-market / stop-limit memicu
* Aktivasi order trailing (trailing start)
* Pemicu take-profit dan stop-loss&#x20;
* Kondisi entry bot DCA

<figure><img src="/files/32352ad16a36d2d059219c03feedc00ac569704b" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/dfd69896a1e7d87b1ed714c91741f7671c84212d" alt="" width="563"><figcaption></figcaption></figure>

Setelah dibuat, Anda akan menemukan semua URL webhook yang tersedia di **Detail** dari order atau bot Anda:

<figure><img src="/files/55b48cd71879a6b276cdd8cc2e34f0ab6ce7eb68" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/aa9e6a2555691f2027d1e6c1c2f852923c6012b2" alt="" width="563"><figcaption></figcaption></figure>

> **Batalkan** webhook — selalu tersedia di semua order dan bot
>
> **Tutup posisi** webhook — selalu tersedia di detail bot DCA

Ringkasnya:

| Aksi                         | Didukung? | Catatan                                                    |
| ---------------------------- | --------- | ---------------------------------------------------------- |
| Batalkan order               | ✅         | Selalu ditampilkan di detail                               |
| Picu order Stop              | ✅         | Harus memilih webhook saat pengaturan                      |
| Aktifkan order Trailing      | ✅         | Trailing start = webhook                                   |
| Picu take profit / stop loss | ✅         | Opsional dipicu oleh webhook                               |
| Bot DCA - entry              | ✅         | Entry buy/sell via webhook (harus disetel saat pengaturan) |
| Bot DCA - exit               | ✅         | Tutup posisi via webhook (selalu tersedia)                 |
| Bot Grid - entry             | 🚫        | Belum didukung                                             |

{% hint style="info" %}
**Multiple take-profit targets with webhooks**

Jika Anda menyiapkan grup take-profit menggunakan webhook sebagai metode pemicu, semuanya akan berbagi URL webhook yang sama. Setiap kali webhook dipicu, order TP berikutnya dalam urutan akan dieksekusi — satu per satu.
{% endhint %}

### Cara mengatur alert di TradingView

Setelah Anda membuat order atau bot di goodcryptoX dan menyalin URL webhook untuk aksi tertentu, berikut cara menghubungkannya ke alert TradingView Anda:

1. Buka chart Anda di TradingView
2. Buat alert baru berdasarkan strategi, indikator, atau kondisi Anda
3. Di **pengaturan alert**, aktifkan checkbox **“Webhook URL”**
4. Tempelkan URL webhook spesifik dari bagian Webhooks goodcryptoX
5. Biarkan **kolom pesan** sebagaimana adanya (isi apa pun tidak masalah — goodcryptoX mengabaikan payload untuk saat ini)
6. Simpan alert

### Strategi berulang (via bot DCA)

Order yang dipicu webhook (mis. stop-market dengan TP dan SL) adalah **pengaturan satu kali**. Setelah order tereksekusi dan TP atau SL terkait terpenuhi, seluruh trade selesai. Jika Anda ingin struktur ini **mengulang secara otomatis**, itu tidak mungkin dengan order — tetapi sekarang dapat dicapai menggunakan bot DCA.

Kami akan segera memperkenalkan [bot strategi TradingView](/goodcryptox-id/perdagangan-cex/fungsi-yang-akan-datang/bot-strategi-tradingview.md) yang didedikasikan untuk mendukung perdagangan multi-aksi yang berulang, tetapi sementara itu, bot DCA memberikan cara fleksibel untuk mengulang strategi Anda yang dipicu webhook.

#### Loop webhook murni

Untuk menyiapkan bot yang masuk posisi dengan webhook, keluar dengan webhook, dan kemudian mengulang:

1. Atur **kondisi entry** = webhook
2. Atur **order averaging** = 0 (nonaktifkan averaging)
3. Nonaktifkan kedua **take**-**profit** dan **stop-loss**
4. Aktifkan **"Ulangi saat menutup posisi"**&#x20;

<figure><img src="/files/d5ca85d33adaf83f2308499980339a7b1fafd060" alt="" width="375"><figcaption></figcaption></figure>

Setelah bot diluncurkan, Anda akan melihat URL webhook berikut di bawah **Detail → Webhooks** bagian bot:

* **Enter Buy** — membuka posisi Long
* **Enter Sell** — membuka posisi Short
* **Tutup posisi** — menutup posisi aktif (long atau short)
* **Batalkan** — menghentikan bot

**Logika eksekusi**

* Saat bot menerima **Enter Buy**, ia membuka posisi long.
* Saat menerima **Enter Sell**, ia membuka posisi short.
* Bot akan **hanya merespons webhook entry pertama** yang diterimanya saat dalam keadaan idle.
* Saat sebuah posisi terbuka:
  * Sinyal entry selanjutnya akan **diabaikan**
  * Bot tidak akan menambah atau membalik posisi saat ini berdasarkan sinyal Entry
  * Sinyal yang diterima hanya **tutup posisi** atau TP/SL yang terpicu (jika dikonfigurasi)
* Setelah posisi ditutup (secara manual, oleh webhook, atau oleh SL/TP), bot mereset dan menunggu webhook Entry berikutnya.

Loop ini berlanjut selama bot tetap aktif, memungkinkan Anda mengulang siklus lengkap entry → exit → reset tanpa batas.

#### Mode webhook murni vs pengaturan hibrida

Bot DCA mendukung beberapa lapisan kontrol yang dapat digabungkan untuk membangun strategi yang fleksibel:

* **Entry**: via webhook, sinyal, atau sesegera mungkin
* **Exit**: via webhook, atau TP/SL berbasis harga bawaan
* **Averaging**: opsional; dapat dinonaktifkan

Anda dapat:

* Menjalankan bot sepenuhnya melalui sinyal webhook (entry dan exit)
* Menambahkan TP/SL berbasis harga sebagai cadangan, bahkan jika Anda menggunakan exit via webhook
* Menambahkan order averaging untuk perlindungan tambahan

Ini membuat mungkin untuk merancang:

* Strategi loop otomatis penuh (webhook murni)
* Bot berbasis sinyal dengan failover manual
* Pengaturan hibrida dengan exit berlapis

### Contoh strategi webhook praktis

#### Contoh 1: Order satu kali + multiple take profits (memantul dari Bollinger Band)

**Tujuan:** Beli ketika harga menembus Bollinger Band bawah, jual secara bertahap saat naik.

**Pengaturan di goodcryptoX**

* Buat order stop-market dengan kondisi pemicu = webhook
* Tambahkan tiga target take-profit. Pemicu TP = webhook

<figure><img src="/files/7d04a234009766b812e780aed89c9f22ec94f6de" alt="" width="563"><figcaption></figcaption></figure>

**Pengaturan di TradingView**

Buat empat alert:

1. Harga menembus band bawah → kirim ke **Trigger** URL webhook
2. Harga kembali ke dalam band → kirim ke **Pemicu Take Profit** URL webhook
3. Harga melintasi mid-band → kirim ke **Pemicu Take Profit** URL webhook
4. Harga menembus band atas → kirim ke **Pemicu Take Profit** URL webhook

<figure><img src="/files/3f63a6cdc2a6fd9036c9b4c331925bc01c8b1e53" alt="" width="563"><figcaption></figcaption></figure>

Di **pengaturan alert**, aktifkan checkbox **“Webhook URL”**

Tempelkan URL webhook spesifik dari bagian Webhooks goodcryptoX. Biarkan kolom Message sebagaimana adanya — kolom itu tidak digunakan.

#### Contoh 2: Strategi berulang dengan bot DCA (Golden/Death Cross)

**Tujuan:** Masuk long pada Golden Cross, masuk short pada Death Cross. Keluar dengan profit 10% atau saat RSI > 70 dan ulangi selamanya.

**Pengaturan di goodcryptoX**

Buat bot DCA

* Kondisi entry = webhook
* Averaging = off (atur ke 0)
* Take Profit = 10%
* Stop loss = off
* Aktifkan: "Ulangi saat TP"

**Pengaturan di TradingView**

* Buat tiga alert pada chart yang sama:
  1. SMA50 melintasi di atas SMA200 → kirim ke **Enter Buy** webhook
  2. SMA50 melintasi di bawah SMA200 → kirim ke **Enter Sell** webhook
  3. RSI > 70 → kirim ke **Tutup posisi** webhook

{% hint style="info" %}
Bot DCA hanya memegang satu posisi pada satu waktu. Saat berada di posisi, ia mengabaikan webhook entry baru sampai posisi ditutup.

Jika Anda ingin bisa memasuki posisi Long dan Short pada instrumen yang sama secara paralel - buat dua bot terpisah dan kirim Enter Buy ke satu dan Enter Sell ke yang lain
{% endhint %}

### Ringkasan

| Konsep            | Deskripsi                                                       |
| ----------------- | --------------------------------------------------------------- |
| Model pemicu      | Setiap aksi memiliki URL webhook sendiri                        |
| Alur pengaturan   | Buat order → salin URL webhook → tempelkan ke alert TradingView |
| Strategi berulang | Gunakan bot DCA dengan repeat diaktifkan                        |
| Akses             | Memerlukan paket PRO atau lebih tinggi                          |

### Tutorial video

#### **Pengantar trading dengan webhook**

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

#### **Menggunakan bot DCA dengan webhook**

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

#### **Multiple take-profits with webhooks**

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.goodcrypto.app/goodcryptox-id/perdagangan-cex/webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
