# Webhook（網絡鉤子）

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

唔同於有啲實作會將 webhooks 當成可編程嘅 API（例如你發送參數化指令如「買 3 BTC」），goodcryptoX 目前支援基於觸發器嘅模型。每個 webhook 只會啟動對特定訂單或機械人嘅預定動作 — 唔會解析任何參數或指令。

喺不久將來，我哋會推出一個新嘅 [TradingView 策略機械人](https://docs.goodcrypto.app/goodcryptox-yue/yong-xu-he-yue-dexs/ji-jiang-tui-chu-kai-gong-neng/tradingview-ce-le-ji-xie-ren) 會支援透過 webhooks 完整嘅策略指示，包括動態選擇交易標的、數量、訂單類型同多標的邏輯 — 實際上會成為一層 API。敬請留意

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

### webhooks 喺 goodcryptoX 嘅運作方式

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

> Webhook URL 係針對動作而非使用者。你需要為每個動作建立一個 webhook，例如每個機械人或訂單嘅進場、止盈、止損等各一個。

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

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

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

<figure><img src="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOtmSJHlKDJLkbCquvUfC%2Fimage.png?alt=media&#x26;token=c152200c-d5ad-4d69-861d-7c66700cd569" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F278uiG55cCWY8A3XpJxm%2Fimage.png?alt=media&#x26;token=7d852fc3-0ef4-45ab-921d-eab0d2287e97" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNoneMggO61H3EFmkwTrP%2Fimage.png?alt=media&#x26;token=f6f48a58-1585-41e3-8778-b69fe9564902" alt="" width="563"><figcaption></figcaption></figure>

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

總結一下：

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

{% hint style="info" %}
**使用 webhooks 嘅多重止盈目標**

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

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

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

1. 去你喺 TradingView 嘅圖表
2. 根據你嘅策略、指標或條件建立一個新警報
3. 喺 **警報設定**中，啟用核取方塊 **「Webhook URL」**
4. 貼上 goodcryptoX Webhooks 部分嘅特定 webhook URL
5. 保留 **訊息欄位** 原樣（任何內容都得 — goodcryptoX 而家會忽略負載）
6. 儲存警報

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

一個由 webhook 觸發嘅訂單（例如帶 TP 同 SL 嘅停止市價）係一個 **一次性設定**。一旦訂單執行同相關嘅 TP 或 SL 觸發，整筆交易就完成。如果你想呢個結構能夠 **自動重複**，訂單做唔到 — 但而家可以透過 DCA 機械人實現。

我哋好快會推出專門嘅 [TradingView 策略機械人](https://docs.goodcrypto.app/goodcryptox-yue/yong-xu-he-yue-dexs/ji-jiang-tui-chu-kai-gong-neng/tradingview-ce-le-ji-xie-ren) 去支援重複嘅多動作交易，但喺此之前，DCA 機械人提供一個靈活方法去重複你嘅 webhook 驅動策略。

#### 純 webhook 循環

要建立一個用 webhook 進場、用 webhook 退出，然後重複嘅機械人：

1. 設定 **進場條件** = webhook
2. 設定 **平均價格訂單** = 0（關閉平均）
3. 同時禁用 **止**-**盈** 同 **止損**
4. 啟用 **「平倉時重複」**&#x20;

<figure><img src="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FCquwy7JurEJkuO9rQeWn%2Fimage.png?alt=media&#x26;token=542f9526-7ecb-4033-8b1c-740aef270b51" alt="" width="375"><figcaption></figcaption></figure>

一旦機械人啟動，你會喺機械人嘅 **詳細資料 → Webhooks** 部分見到以下 webhook URL：

* **進場買入** — 開多倉
* **進場賣出** — 開空倉
* **平倉** — 平掉現有倉位（多或空）
* **取消** — 停止機械人

**執行邏輯**

* 當機械人收到 **進場買入**，佢會開一個多倉。
* 當佢收到 **進場賣出**，佢會開一個空倉。
* 機械人只會 **回應佢閒置時收到嘅第一個進場 webhook** 。
* 當一個倉位開啟時：
  * 任何進一步嘅進場訊號都會 **被忽略**
  * 機械人喺進場訊號入面唔會增加或反轉目前倉位
  * 唯⼀接受嘅訊號係 **平倉** 或已觸發嘅 TP/SL（如果有設定）
* 一旦倉位被平倉（手動、透過 webhook，或被 SL/TP），機械人會重置並等候下一個進場 webhook。

只要機械人保持啟動，呢個循環就會繼續，容許你無限次重複完整嘅進場 → 退出 → 重置 週期。

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

DCA 機械人支援多個可結合嘅控制層去建立靈活策略：

* **進場**：透過 webhook、訊號或盡快（asap）
* **退出**：透過 webhook，或內建嘅基於價格嘅 TP/SL
* **平均**：可選；可以關閉

你可以：

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

咁樣可以設計：

* 完全自動循環策略（純 webhook）
* 以訊號驅動但有手動備援嘅機械人
* 多層退出嘅混合設定

### 實用 webhook 策略示例

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

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

**喺 goodcryptoX 嘅設定**

* 建立一個觸發條件 = webhook 嘅停止市價訂單
* 加入三個止盈目標。TP 觸發 = webhook

<figure><img src="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**喺 TradingView 嘅設定**

建立四個警報：

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

<figure><img src="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" alt="" width="563"><figcaption></figcaption></figure>

喺 **警報設定**中，啟用核取方塊 **「Webhook URL」**

貼上 goodcryptoX Webhooks 部分嘅特定 webhook URL。訊息欄位保持原樣 — 呢個欄位未被使用。

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

**目標：** 金叉時進場多倉，死叉時進場空倉。以 10% 利潤退出或當 RSI > 70 時退出，並無限重複。

**喺 goodcryptoX 嘅設定**

建立 DCA 機械人

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

**喺 TradingView 嘅設定**

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

{% hint style="info" %}
DCA 機械人同一時間只持有一個倉位。當有倉位時，佢會忽略新嘅進場 webhook，直到倉位被平倉。

如果你想喺同一標的上同時並行進場多倉同空倉——就建立兩個獨立嘅機械人，並將「進場買入」發送到一個，「進場賣出」發送到另一個。
{% endhint %}

### 總結

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

### 教學影片

#### **webhook 交易入門**

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

#### **使用 DCA 機械人配合 webhooks**

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

#### **使用 webhooks 嘅多重止盈**

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