# Webhook（網絡鉤子）

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="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fl2pfeXIwqa1tpvsFEldb%2Fimage.png?alt=media&#x26;token=99ca6c17-d547-47c7-abaf-1d1e3bb4e03a" alt="" width="375"><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%2FlG04MgjoXROWz32j0tN4%2Fimage.png?alt=media&#x26;token=08009fa1-7757-4495-b60e-1165e12887b3" 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="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNUBBrWgJqqqvjcnLBw7C%2Fimage.png?alt=media&#x26;token=ced6146d-5d8e-4496-94bc-0cb08cb57282" 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="https://62489144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Ffg4E339WmltyEDaiNjma%2Fimage.png?alt=media&#x26;token=0ee7cab9-7575-4ac2-89c4-841693b2ba77" alt="" width="375"><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%2Fc3oNniHr6lmTUwc8qQ7V%2Fimage.png?alt=media&#x26;token=9787c6e6-5744-48cc-8ae1-a891fd775e8e" 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 機械人                           |