# Webhooks goodcryptoX 允許你透過 TradingView webhooks 自動化交易操作 — 呢個係一個可以直接由你嘅訊號觸發訂單同機械人行為嘅強大機制。 唔同於有啲實作會將 webhooks 當成可編程嘅 API（例如你發送參數化指令如「買 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。敬請留意 > 目前只接受由 TradingView 伺服器發出嘅 webhooks — 暫時唔接受自訂 IP 或外部來源。\ > 如果你需要使用自訂 webhook 來源，請聯絡我哋： 申請存取權。 ### webhooks 喺 goodcryptoX 嘅運作方式 * 每個訂單或機械人 **動作** 都有自己專用嘅 webhook URL * 你必須先建立該訂單或機械人先會得到 URL（佢哋會出現喺 **Webhooks** 該訂單或機械人嘅 **詳細資料**) * 傳送 **任何** webhook 負載到嗰個 URL 就會觸發該動作 > Webhook URL 係針對動作而非使用者。你需要為每個動作建立一個 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/yong-xu-he-yue-dex/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： * **進場買入** — 開多倉 * **進場賣出** — 開空倉 * **平倉** — 平掉現有倉位（多或空） * **取消** — 停止機械人 **執行邏輯** * 當機械人收到 **進場買入**，佢會開一個多倉。 * 當佢收到 **進場賣出**，佢會開一個空倉。 * 機械人只會 **回應佢閒置時收到嘅第一個進場 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 → 發送到 **進場買入** webhook 2. SMA50 向下穿越 SMA200 → 發送到 **進場賣出** webhook 3. RSI > 70 → 發送到 **平倉** webhook {% hint style="info" %} DCA 機械人同一時間只持有一個倉位。當有倉位時，佢會忽略新嘅進場 webhook，直到倉位被平倉。 如果你想喺同一標的上同時並行進場多倉同空倉——就建立兩個獨立嘅機械人，並將「進場買入」發送到一個，「進場賣出」發送到另一個。 {% endhint %} ### 總結 | 概念 | 描述 | | ---- | ----------------------------------------- | | 觸發模型 | 每個動作都有自己嘅 webhook URL | | 設定流程 | 建立訂單 → 複製 webhook URL → 貼到 TradingView 警報 | | 重複策略 | 使用啟用重複嘅 DCA 機械人 | ### 教學影片 #### **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/yong-xu-he-yue-dex/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.