# Webhooks goodcryptoX 允許你透過 TradingView webhooks 自動化交易操作 — 呢個係一個強大嘅機制，可以由你嘅訊號直接觸發訂單同機械人操作。 唔同於有啲實作會將 webhooks 當做可程式化 API（例如你會傳送參數化指令好似「buy 3 BTC」），goodcryptoX 目前支援以觸發器為基礎嘅模式。每個 webhook 只會啟動預先定義好嘅特定訂單或機械人操作 — 唔會解析任何參數或指令。 > 喺唔久將來，我哋會推出一個新嘅 [TradingView 策略機械人](/goodcryptox-yue/yong-xu-he-yue-dex/ji-jiang-tui-chu-gong-neng/tradingview-ce-le-ji-xie-ren.md) 支援完整嘅策略指令經由 webhooks，包括動態選擇交易標的、數量、訂單類型同多標的邏輯 — 實際上會當做一層 API。敬請留意 ### 安全性同存取權限 * 現時 webhooks 只接受來自 TradingView 伺服器嘅請求 — 唔接受自訂 IP 或外部來源。 * 如果你需要使用自訂 webhook 來源，請聯絡我哋： 提出存取申請。 * Webhooks 只對擁有有效 PRO [方案](/goodcryptox-yue/sheng-tai-xi-tong/ding-yue-ji-hua.md) 或以上級別嘅用戶開放。 ### webhooks 喺 goodcryptoX 入面點運作 * 每個訂單或機械人 **操作** 都有自己專屬嘅 webhook URL * 你必須先建立訂單或機械人先可以獲得呢個 URL（佢哋會顯示喺 **Webhooks** 區域，屬於該訂單或機械人嘅 **詳細資料**) * 發送 **任何** webhook 載荷到該 URL 就會觸發該操作 > Webhook URL 係針對操作而設，而唔係針對用戶。你必須為每個操作建立一個 webhook，例如每個機械人或訂單嘅開倉、逐步獲利、停損等各自建立 webhook。 ### 支援嘅訂單同機械人操作 如果你想你嘅訂單或機械人被 **webhook 觸發**，你必須喺設定時選擇 webhook 作為 **觸發條件**。呢啲適用於： * 市價止損 / 止損限價訂單嘅觸發 * 拖曳單啟動（拖曳開始） * 止盈同止損觸發 * DCA 機械人嘅入場條件
建立後，你會喺你嘅訂單或機械人嘅 **詳細資料** 中搵到所有可用嘅 webhook URL：
> **取消** 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 策略機械人](/goodcryptox-yue/zhong-xin-hua-jiao-yi-suo-jiao-yi/ji-jiang-tui-chu-gong-neng/tradingview-ce-le-ji-xie-ren.md) 去支援重覆嘅多動作交易，但喺呢段時間內，DCA 機械人提供一個靈活方法去重覆你由 webhook 驅動嘅策略。 #### 純 webhook 迴圈 要設定一個喺 webhook 入場、喺 webhook 退出、然後重覆嘅機械人： 1. 設定 **入場條件** = webhook 2. 設定 **均價訂單** = 0（停用均價） 3. 停用 **止**-**盈** 同 **停損** 4. 啟用 **「平倉後重覆」**
一旦機械人啟動，你會喺機械人嘅 **詳細資料 → 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
**喺 TradingView 嘅設定** 建立四個警報： 1. 價格突破下軌 → 發送至主訂單嘅 **觸發** webhook URL 2. 價格回到軌道內 → 發送至 **止盈觸發** webhook URL 3. 價格穿越中軌 → 發送至 **止盈觸發** webhook URL 4. 價格突破上軌 → 發送至 **止盈觸發** webhook URL
喺 **警報設定**中，啟用呢個核取方塊 **「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="" %} #### **使用 DCA 機械人配合 webhooks** {% embed url="" %} #### **使用 webhooks 嘅多重止盈** {% embed url="" %} --- # 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/zhong-xin-hua-jiao-yi-suo-jiao-yi/webhooks.md?ask= ``` 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.