# Webhook

goodcryptoX memungkinkan Anda mengotomatiskan perdagangan DEX melalui webhook TradingView — sebuah mekanisme kuat untuk memicu pesanan 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 "beli 3 BTC"), goodcryptoX saat ini mendukung model berbasis pemicu. Setiap webhook hanya mengaktifkan tindakan yang telah ditentukan pada pesanan atau bot tertentu — tidak ada parameter atau perintah yang diinterpretasikan.

Dalam waktu dekat, kami akan meluncurkan bot Strategi TradingView baru yang mendukung instruksi strategi penuh melalui webhook, termasuk pemilihan simbol dinamis, kuantitas, jenis pesanan, dan logika multi-simbol — secara efektif berfungsi sebagai lapisan API. Nantikan

> Untuk saat ini webhook hanya diterima dari server TradingView — tidak menerima IP kustom atau sumber eksternal.\
> Jika Anda perlu menggunakan sumber webhook kustom, hubungi kami di <support@goodcrypto.app> untuk meminta akses.

### Cara kerja webhook di goodcryptoX

* Setiap pesanan atau bot **tindakan** memiliki URL webhook khusus sendiri
* Anda harus membuat pesanan atau bot terlebih dahulu untuk mendapatkan URL (mereka akan muncul di **Webhook** bagian dari **Detail**)
* Mengirim **apa pun** muatan webhook ke URL itu akan memicu tindakan

Berikut adalah video tinjauan:

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

> URL webhook bersifat spesifik untuk tindakan. Anda harus membuat satu webhook per tindakan, mis. satu untuk masuk, satu untuk ambil keuntungan, satu untuk stop loss, dll. untuk setiap bot atau pesanan

### Tindakan pesanan dan bot yang didukung

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

* Pesanan Limit memicu
* Aktivasi pesanan trailing (awal trailing)
* Pemicu ambil-keuntungan dan stop-loss&#x20;
* Kondisi masuk bot DCA

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

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

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

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

Untuk menyimpulkan:

| Tindakan                            | Didukung? | Catatan                                                    |
| ----------------------------------- | --------- | ---------------------------------------------------------- |
| Batalkan pesanan                    | ✅         | Selalu ditampilkan di detail                               |
| Memicu pesanan Limit                | ✅         | Harus memilih webhook saat pengaturan                      |
| Aktifkan pesanan Trailing           | ✅         | Awal trailing = webhook                                    |
| Memicu ambil keuntungan / stop loss | ✅         | Opsional dipicu webhook                                    |
| Bot DCA - masuk                     | ✅         | Masuk beli/jual via webhook (harus diatur saat pengaturan) |
| Bot DCA - keluar                    | ✅         | Tutup posisi via webhook (selalu tersedia)                 |

{% hint style="info" %}
**Beberapa target ambil-keuntungan dengan webhook**

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

### Cara mengatur alert di TradingView

Setelah Anda membuat pesanan 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. Tempel URL webhook spesifik dari goodcryptoX **Webhook tersedia** bagian
5. Biarkan **kolom pesan** sebagaimana adanya (konten apa pun tidak apa-apa — goodcryptoX mengabaikan payload untuk saat ini)
6. Simpan alert

### Strategi berulang (melalui bot DCA)

Pesanan yang dipicu webhook (mis. limit dengan TP dan SL) adalah **pengaturan satu kali**. Setelah pesanan dieksekusi dan TP atau SL yang terkait aktif, seluruh perdagangan selesai. Jika Anda ingin struktur ini **mengulang secara otomatis**, itu tidak mungkin dengan pesanan — tetapi dapat dicapai sekarang menggunakan bot DCA.

Kami akan segera memperkenalkan bot strategi TradingView khusus untuk mendukung perdagangan multi-tindakan berulang, tetapi sementara itu, bot DCA menyediakan cara fleksibel untuk mengulang strategi yang digerakkan webhook Anda.

#### Loop murni webhook

Untuk mengatur bot yang masuk posisi pada webhook, keluar pada webhook, dan kemudian mengulang:

1. Atur **kondisi masuk** = webhook
2. Atur **pesanan averaging** = 0 (nonaktifkan averaging)
3. Nonaktifkan keduanya **ambil**-**keuntungan** dan **stop-loss**
4. Aktifkan **"Ulangi saat menutup posisi"**

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

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

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

**Logika eksekusi**

* Ketika bot menerima **Masuk Beli**, bot membuka posisi long.
* Bot akan **hanya merespons webhook masuk pertama** yang diterimanya saat dalam keadaan idle.
* Saat posisi terbuka:
  * Sinyal masuk lebih lanjut **diabaikan**
  * Satu-satunya sinyal yang diterima adalah **tutup posisi** atau TP/SL yang dipicu (jika dikonfigurasi)
* Setelah posisi ditutup (secara manual, oleh webhook, atau oleh SL/TP), bot direset dan menunggu webhook Masuk berikutnya.

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

#### Mode webhook murni vs pengaturan hibrida

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

* **Masuk**: via webhook, sinyal, atau instan
* **Keluar**: via webhook, atau TP/SL berbasis harga bawaan
* **Averaging**: opsional; dapat dinonaktifkan

Anda dapat:

* Menjalankan bot sepenuhnya melalui sinyal webhook (masuk dan keluar)
* Menambahkan TP/SL berbasis harga sebagai cadangan, bahkan jika Anda menggunakan keluaran webhook
* Menambahkan pesanan averaging untuk perlindungan tambahan

Ini memungkinkan untuk merancang:

* Strategi loop otomatis penuh (webhook murni)
* Bot yang digerakkan sinyal dengan failover manual
* Pengaturan hibrida dengan exit multi-lapisan

### Contoh strategi webhook praktis

#### Contoh 1: Pesanan sekali jalan + beberapa ambil-keuntungan (pantulan Bollinger Band)

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

**Pengaturan di goodcryptoX**

* Buat pesanan limit dengan kondisi pemicu = webhook
* Tambahkan tiga target ambil-keuntungan. Pemicu TP = webhook

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

**Pengaturan di TradingView**

Buat empat alert:

1. Harga menembus band bawah → kirim ke **Pemicu** URL webhook utama pesanan
2. Harga kembali ke dalam band → kirim ke **Pemicu Ambil Keuntungan** URL webhook utama pesanan
3. Harga menyeberang mid-band → kirim ke **Pemicu Ambil Keuntungan** URL webhook utama pesanan
4. Harga menembus band atas → kirim ke **Pemicu Ambil Keuntungan** URL webhook utama pesanan

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

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

Tempel URL webhook spesifik dari goodcryptoX **Webhook tersedia** bagian. Biarkan kolom Pesan apa adanya — 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 keuntungan 10% atau saat RSI > 70 dan ulangi terus.

**Pengaturan di goodcryptoX**

Buat bot DCA

* Kondisi masuk = webhook
* Averaging = mati (setel ke 0)
* Ambil Keuntungan = 10%
* Stop loss = mati
* Aktifkan: "Ulangi saat TP"

**Pengaturan di TradingView**

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

### Ringkasan

| Konsep            | Deskripsi                                                      |
| ----------------- | -------------------------------------------------------------- |
| Model pemicu      | Setiap tindakan memiliki URL webhook sendiri                   |
| Alur pengaturan   | Buat pesanan → salin URL webhook → tempel ke alert TradingView |
| Strategi berulang | Gunakan bot DCA dengan pengulangan diaktifkan                  |


---

# 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-dex-spot/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.
