# Webhooks

goodcryptoX 允許你透過 TradingView webhooks 自動化 DEX 交易 — 一個可以直接由你嘅訊號觸發訂單同機械人操作嘅強大機制。

唔同於某啲把 webhooks 當作可編程 API（例如你傳送類似「買入 3 BTC」嘅參數化指令）嘅實作，goodcryptoX 目前支援基於觸發器嘅模式。每個 webhook 只係啟動預先定義好嘅特定訂單或機械人動作 — 唔會解析任何參數或指令。

喺不久嘅將來，我哋會推出一個新嘅 TradingView 策略機械人，支援透過 webhooks 傳遞完整策略指示，包括動態選幣、數量、訂單類型同多幣種邏輯 — 實際上會作為一層 API。敬請期待。

> 目前 webhooks 只會接受來自 TradingView 伺服器嘅請求 — 唔接受自訂 IP 或外部來源。\
> 如果你需要使用自訂 webhook 來源，請聯絡我哋： <support@goodcrypto.app> 以申請存取權。

### goodcryptoX 裡面 webhooks 嘅運作方式

* 每個訂單或機械人 **動作** 都有其專屬嘅 webhook URL
* 你必須先建立該訂單或機械人先可以取得 URL（佢哋會出現喺 **Webhooks** 該訂單或機械人嘅 **詳細資料**)
* 傳送 **任何** webhook 載荷到嗰個 URL 就會觸發該動作

以下係一條影片概覽：

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

> Webhook URL 係針對動作而設。你要為每一個動作建立一個 webhook，例如為入場建立一個、為止盈建立一個、為止損建立一個，等等，針對每個機械人或訂單都係咁。

### 支援嘅訂單同機械人動作

如果你想令你嘅訂單或機械人被 **webhook 觸發**, 你必須喺設定時揀 webhook 作為 **觸發條件**. 呢點適用於：

* 限價訂單觸發
* 追蹤訂單啟動（追蹤開始）
* 止盈同止損觸發&#x20;
* DCA 機械人入場條件

> **取消** webhook — 喺所有訂單同機械人都始終可用
>
> **平倉** webhook — 喺 DCA 機械人詳細資料中始終可用

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

建立後，你會喺你嘅訂單或機械人嘅 **詳細資料** 找到所有可用嘅 webhook URL：

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

總結：

| 動作           | 支援？ | 備註                        |
| ------------ | --- | ------------------------- |
| 取消訂單         | ✅   | 喺詳細資料中會始終顯示               |
| 觸發限價訂單       | ✅   | 喺設定時必須選擇 webhook          |
| 啟動追蹤訂單       | ✅   | 追蹤開始 = webhook            |
| 觸發止盈 / 止損    | ✅   | 可選用 webhook 觸發            |
| DCA 機械人 - 入場 | ✅   | 透過 webhook 入場買/賣（須喺設定時設置） |
| DCA 機械人 - 退出 | ✅   | 透過 webhook 平倉（始終可用）       |

{% hint style="info" %}
**用 webhook 設置多個止盈目標**

如果你用 webhook 作為觸發方法設置咗一組止盈，佢哋會共用相同嘅 webhook URL。每次 webhook 被觸發，序列中下一個 TP 訂單就會執行 — 一個接一個。
{% endhint %}

### 喺 TradingView 設定警報嘅方法

一旦你喺 goodcryptoX 創建好訂單或機械人並複製咗特定動作嘅 webhook URL，以下係點樣將佢連接到你嘅 TradingView 警報：

1. 去到你喺 TradingView 嘅圖表
2. 根據你嘅策略、指標或條件建立一個新嘅警報
3. 喺 **警報設定**, 啟用個勾選框 **「Webhook URL」**
4. 把從 goodcryptoX 複製出嚟嘅特定 webhook URL 貼上去，來自 **可用 webhooks** 區段
5. 保留 **訊息欄位** 原樣（任何內容都得 — goodcryptoX 目前會忽略載荷）
6. 儲存警報

### 重複策略（透過 DCA 機械人）

一個由 webhook 觸發嘅訂單（例如限價連 TP 同 SL）係一個 **一次性設定**. 訂單一旦執行同相關聯嘅 TP 或 SL 觸發，整個交易就完成。如果你想令呢個結構可以 **自動重複**, 訂單本身做唔到 — 但而家可以用 DCA 機械人達成。

我哋好快會推出專門嘅 TradingView 策略機械人去支援可重複嘅多動作交易，但與此同時，DCA 機械人係一個靈活嘅方法去重複你由 webhook 驅動嘅策略。

#### 純 webhook 迴圈

要設定一個靠 webhook 入場、靠 webhook 退出，然後重複嘅機械人：

1. 設定 **入場條件** = webhook
2. 設定 **平均加倉訂單** = 0（關閉平均加倉）
3. 停用兩者： **止**-**盈** 同 **止損**
4. 啟用 **「平倉時重複」**

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

一旦機械人啟動，你會喺機械人嘅以下位置見到啲 webhook URL： **詳細資料 → Webhooks** 區段：

* **入場 買入** — 開啟一個多倉（Long）
* **平倉** — 平掉現有倉位（無論多倉定空倉）
* **取消** — 停止機械人

**執行邏輯**

* 當機械人收到 **入場 買入**時，佢會開一個多倉。
* 機械人會 **只回應喺閒置時收到嘅第一個入場 webhook。** 嗰個時候佢收到嘅第一個。
* 當一個倉位開啟期間：
  * 任何進一步嘅入場訊號都會被 **忽略**
  * 唯一被接受嘅訊號係 **平倉** 或已觸發嘅 TP/SL（如果已配置）
* 一旦倉位被平倉（手動、透過 webhook、或由 SL/TP），機械人會重設並等待下一個入場 webhook。

只要機械人保持啟動，呢個迴圈會繼續，容許你無限次重複完整嘅入場 → 退出 → 重設 循環。

#### 純 webhook 模式 vs 混合設定

DCA 機械人支援多個控制層，可以組合嚟建立靈活嘅策略：

* **入場**: 透過 webhook、訊號，或即時
* **退出**: 透過 webhook，或內建基於價格嘅 TP/SL
* **平均加倉**: 可選；可以關閉

你可以：

* 完全透過 webhook 訊號運行機械人（入場同退出）
* 即使你用 webhook 退出，都可以加入基於價格嘅 TP/SL 作為備援
* 加入平均加倉訂單作進一步保護

咁樣可以設計出：

* 完全自動化嘅迴圈策略（純 webhook）
* 以訊號驅動並有手動備援嘅機械人
* 具有多層退出嘅混合設定

### 實用 webhook 策略示例

#### 示例 1：一次性訂單 + 多個止盈（布林帶反彈）

**目標：** 價格突破下方布林帶時買入，價格回升時逐步賣出。

**喺 goodcryptoX 嘅設定**

* 建立一個觸發條件 = webhook 嘅限價訂單
* 新增三個止盈目標。TP 觸發 = webhook

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

**喺 TradingView 嘅設定**

建立四個警報：

1. 價格突破下方波段 → 傳送到主訂單嘅 **觸發器** webhook URL
2. 價格回到波段內 → 傳送到 **止盈觸發** webhook URL
3. 價格穿越中線 → 傳送到 **止盈觸發** webhook URL
4. 價格突破上方波段 → 傳送到 **止盈觸發** webhook URL

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

喺 **警報設定**, 啟用個勾選框 **「Webhook URL」**

把從 goodcryptoX 複製出嚟嘅特定 webhook URL 貼上去，來自 **可用 webhooks** 區段。保留訊息欄位原樣 — 佢唔會被使用。

#### 示例 2：用 DCA 機械人嘅重複策略（黃金交叉/死亡交叉）

**目標：** 喺黃金交叉入多倉，喺死亡交叉入空倉。以 10% 盈利或當 RSI > 70 時退出，並永久重複。

**喺 goodcryptoX 嘅設定**

建立 DCA 機械人

* 入場條件 = webhook
* 平均加倉 = 關閉（設為 0）
* 止盈 = 10%
* 止損 = 關閉
* 啟用：「TP 時重複」

**喺 TradingView 嘅設定**

* 喺同一張圖表上建立三個警報：
  1. SMA50 上穿 SMA200 → 傳送到 **入場 買入** webhook
  2. SMA50 下穿 SMA200 → 傳送到 **入場 賣出** webhook
  3. RSI > 70 → 傳送到 **平倉** webhook

### 總結

| 概念    | 描述                                        |
| ----- | ----------------------------------------- |
| 觸發模型  | 每個動作都有自己嘅 webhook URL                     |
| 設定流程  | 建立訂單 → 複製 webhook URL → 貼到 TradingView 警報 |
| 可重複策略 | 使用啟用重複嘅 DCA 機械人                           |


---

# 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-yue/dex-jiao-yi-xian-huo/webhooks.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.