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

# 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 機械人                           |