> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-id/sex-trading/webhooks.md).

# Webhook

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

Tidak seperti beberapa implementasi yang memperlakukan webhook seperti API yang dapat diprogram (di mana Anda mengirim perintah berparameter seperti "buy 3 BTC"), goodcryptoX saat ini mendukung model berbasis pemicu. Setiap webhook hanya mengaktifkan tindakan 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](https://docs.goodcrypto.app/goodcryptox-id/perp-dexs/upcoming-functionality/tradingview-strategy-bot.md) baru yang mendukung instruksi strategi penuh melalui webhook, termasuk pemilihan simbol dinamis, kuantitas, jenis order, dan logika multi-simbol — yang pada dasarnya berfungsi sebagai lapisan API. Nantikan

### Keamanan dan akses

* Webhook saat ini hanya diterima dari server TradingView — 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 PRO aktif [paket](https://docs.goodcrypto.app/goodcryptox-id/ecosystem/subscription-plans.md) atau lebih tinggi.

### Cara kerja webhook di goodcryptoX

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

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

### Tindakan order dan bot yang didukung

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

* Pemicu order stop-market / stop-limit
* Aktivasi order trailing (awal trailing)
* Pemicu take-profit dan stop-loss
* Kondisi entry bot DCA

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" 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="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

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

Singkatnya:

| Tindakan                     | Didukung? | Catatan                                                        |
| ---------------------------- | --------- | -------------------------------------------------------------- |
| Batalkan order               | ✅         | Selalu ditampilkan di detail                                   |
| Picu order Stop              | ✅         | Harus memilih webhook saat penyiapan                           |
| Aktifkan order Trailing      | ✅         | Awal trailing = webhook                                        |
| Picu take profit / stop loss | ✅         | Opsional dipicu webhook                                        |
| Bot DCA - entry              | ✅         | Beli/jual entry melalui webhook (harus disetel saat penyiapan) |
| Bot DCA - exit               | ✅         | Tutup posisi melalui webhook (selalu tersedia)                 |
| Bot Grid - entry             | 🚫        | Belum didukung                                                 |

{% hint style="info" %}
**Beberapa target take-profit dengan webhook**

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 menyiapkan alert di TradingView

Setelah Anda membuat order atau bot di goodcryptoX dan menyalin URL webhook untuk tindakan 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 kotak centang **“Webhook URL”**
4. Tempelkan URL webhook spesifik dari bagian Webhooks goodcryptoX
5. Biarkan **bidang pesan** apa adanya (isi apa pun tidak masalah — goodcryptoX mengabaikan payload untuk saat ini)
6. Simpan alert

### Strategi berulang (melalui bot DCA)

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

Kami akan segera memperkenalkan [bot strategi TradingView](https://docs.goodcrypto.app/goodcryptox-id/sex-trading/upcoming-functionality/tradingview-strategy-bot.md) khusus untuk mendukung trade multi-tindakan yang berulang, tetapi untuk saat ini, bot DCA menyediakan cara fleksibel untuk mengulangi strategi Anda yang digerakkan webhook.

#### Loop webhook murni

Untuk menyiapkan bot yang masuk ke posisi pada webhook, keluar pada webhook, lalu mengulangi:

1. Atur **kondisi entry** = webhook
2. Atur **order averaging** = 0 (nonaktifkan averaging)
3. Nonaktifkan kedua **ambil**-**profit** dan **stop-loss**
4. Aktifkan **"Ulangi saat posisi ditutup"**

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

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

* **Masuk Beli** — membuka posisi Long
* **Masuk Jual** — membuka posisi Short
* **Tutup posisi** — menutup posisi aktif (long atau short)
* **Batal** — menghentikan bot

**Logika eksekusi**

* Saat bot menerima **Masuk Beli**, bot membuka posisi long.
* Saat bot menerima **Masuk Jual**, bot membuka posisi short.
* Bot akan **hanya merespons webhook entry pertama** yang diterimanya saat idle.
* Saat posisi terbuka:
  * Setiap sinyal entry berikutnya **diabaikan**
  * Bot tidak akan menambah atau membalik posisi saat ini pada sinyal Entry
  * Satu-satunya sinyal yang diterima adalah **tutup posisi** atau TP/SL yang terpicu (jika dikonfigurasi)
* Setelah posisi ditutup (secara manual, oleh webhook, atau oleh SL/TP), bot akan di-reset 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**: melalui webhook, sinyal, atau ASAP
* **Exit**: melalui webhook, atau TP/SL bawaan berbasis harga
* **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 webhook
* Menambahkan order averaging untuk perlindungan tambahan

Ini memungkinkan Anda 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 sekali jalan + beberapa take profit (pantulan Bollinger Band)

**Tujuan:** Beli saat harga menembus Bollinger Band bawah, jual 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="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

**Pengaturan di TradingView**

Buat empat alert:

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

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Di **pengaturan alert**, aktifkan kotak centang **“Webhook URL”**

Tempelkan URL webhook spesifik dari bagian Webhooks goodcryptoX. Biarkan bidang Message apa adanya — tidak digunakan.

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

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

**Pengaturan di goodcryptoX**

Buat bot DCA

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

**Pengaturan di TradingView**

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

{% hint style="info" %}
Bot DCA hanya menyimpan satu posisi pada satu waktu. Saat sedang dalam posisi, bot mengabaikan webhook entry baru sampai posisi ditutup.

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

### Ringkasan

| Konsep            | Deskripsi                                                    |
| ----------------- | ------------------------------------------------------------ |
| Model pemicu      | Setiap tindakan memiliki URL webhook sendiri                 |
| Alur penyiapan    | Buat order → salin URL webhook → tempel ke alert TradingView |
| Strategi berulang | Gunakan bot DCA dengan pengulangan diaktifkan                |
| Akses             | Membutuhkan paket PRO atau lebih tinggi                      |

### Tutorial video

#### **Pengenalan trading webhook**

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

#### **Beberapa take-profit dengan webhook**
