# Webhook（網絡鉤子）

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

唔同於有啲實作會將 webhooks 當做可程式化 API（例如你會傳送參數化指令好似「buy 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。敬請留意

### 安全性同存取權限

* 現時 webhooks 只接受來自 TradingView 伺服器嘅請求 — 唔接受自訂 IP 或外部來源。
* 如果你需要使用自訂 webhook 來源，請聯絡我哋： <support@goodcrypto.app> 提出存取申請。
* Webhooks 只對擁有有效 PRO [方案](https://docs.goodcrypto.app/goodcryptox-yue/sheng-tai-xi-tong/ding-yue-ji-hua) 或以上級別嘅用戶開放。

### webhooks 喺 goodcryptoX 入面點運作

* 每個訂單或機械人 **操作** 都有自己專屬嘅 webhook URL
* 你必須先建立訂單或機械人先可以獲得呢個 URL（佢哋會顯示喺 **Webhooks** 區域，屬於該訂單或機械人嘅 **詳細資料**)
* 發送 **任何** webhook 載荷到該 URL 就會觸發該操作

> Webhook URL 係針對操作而設，而唔係針對用戶。你必須為每個操作建立一個 webhook，例如每個機械人或訂單嘅開倉、逐步獲利、停損等各自建立 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/zhong-xin-hua-jiao-yi-cex/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：

* **Enter Buy** — 開多倉
* **Enter Sell** — 開空倉
* **平倉** — 平掉現時倉位（多或空）
* **取消** — 停止機械人

**執行邏輯**

* 當機械人收到 **Enter Buy**，就會開一個多倉。
* 當佢收到 **Enter Sell**，就會開一個空倉。
* 機械人只會 **回應喺閒置時收到嘅第一個入場 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 → 發送至 **Enter Buy** webhook
  2. SMA50 向下穿越 SMA200 → 發送至 **Enter Sell** webhook
  3. RSI > 70 → 發送至 **平倉** webhook

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

如果你想喺同一個合約上同時平行入多同入空 — 就建立兩個獨立機械人，將 Enter Buy 傳送畀一個，Enter Sell 傳送畀另一個。
{% endhint %}

### 總結

| 概念   | 描述                                        |
| ---- | ----------------------------------------- |
| 觸發模型 | 每個操作都有自己嘅 webhook URL                     |
| 設定流程 | 建立訂單 → 複製 webhook URL → 貼到 TradingView 警報 |
| 重覆策略 | 使用啟用重覆嘅 DCA 機械人                           |
| 存取權限 | 需要 PRO 方案或以上                              |

### 影片教學

#### **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>" %}