# Webhook goodcryptoX 允许你通过 TradingView 的 webhook 来自动化交易操作——这是一种强大的机制，可直接由你的信号触发下单与机器人动作。 与某些将 webhook 视为可编程 API（例如发送“buy 3 BTC”这类带参数命令）的实现不同，goodcryptoX 目前支持基于触发的模型。每个 webhook 仅会在特定订单或机器人的预定义动作上生效——不会解析任何参数或命令。 在不久的将来，我们将上线一个新的 [TradingView 策略机器人](/goodcryptox-zh/yong-xu-dex/ji-jiang-tui-chu-de-gong-neng/tradingview-ce-le-ji-qi-ren.md) 它通过 webhook 支持完整的策略指令，包括动态交易对选择、数量、订单类型与多标的逻辑——等同于一个 API 层。敬请关注 > 目前仅接受来自 TradingView 服务器的 webhook——不支持自定义 IP 或外部来源。\ > 如果你需要使用自定义的 webhook 来源，请通过以下方式联系我们 申请访问权限。 ### goodcryptoX 中 webhook 的工作方式 * 每个订单或机器人 **动作** 都有自己专属的 webhook URL * 你必须先创建订单或机器人才能获得 URL（它们会出现在 **Webhooks** 该订单或机器人的 **详情**) * 向 **任意** 向该 URL 发送 webhook 负载都会触发该动作 > Webhook URL 与动作绑定，而非与用户绑定。你必须为每个动作创建一个 webhook，例如：一个用于入场、一个用于止盈、一个用于止损等，针对每个机器人或订单均如此 ### 支持的订单与机器人动作 如果你希望你的订单或机器人被 **webhook 触发**，你必须在设置时选择 webhook 作为 **触发条件**。适用于： * 止损市价 / 止损限价单触发 * 跟踪单激活（跟踪开始） * 止盈与止损触发 * DCA 机器人入场条件
创建完成后，你可以在 **详情** 中找到该订单或机器人的所有可用 webhook URL：
> **取消** webhook —— 在所有订单与机器人中始终可用 > > **平仓** webhook —— 在 DCA 机器人详情中始终可用 总结： | 动作 | 是否支持？ | 备注 | | ------------ | ----- | -------------------------- | | 取消订单 | ✅ | 始终在详情中显示 | | 触发止损单 | ✅ | 必须在设置时选择 webhook | | 激活跟踪单 | ✅ | 跟踪开始 = webhook | | 触发止盈 / 止损 | ✅ | 可选由 webhook 触发 | | DCA 机器人 - 入场 | ✅ | 通过 webhook 入场买/卖（必须在设置时配置） | | DCA 机器人 - 出场 | ✅ | 通过 webhook 平仓（始终可用） | | 网格机器人 - 入场 | 🚫 | 尚不支持 | {% hint style="info" %} **使用 webhook 的多重止盈目标** 如果你将止盈组设置为使用 webhook 作为触发方式，它们会共享同一个 webhook URL。每次触发该 webhook，序列中的下一个止盈单会依次执行——一个接一个。 {% 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-zh/yong-xu-dex/ji-jiang-tui-chu-de-gong-neng/tradingview-ce-le-ji-qi-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. 价格跌破下轨 → 发送至主订单的 **Trigger（触发）** webhook URL 2. 价格回到轨道内 → 发送至 **Take Profit Trigger（止盈触发）** webhook URL 3. 价格上穿中轨 → 发送至 **Take Profit Trigger（止盈触发）** webhook URL 4. 价格突破上轨 → 发送至 **Take Profit Trigger（止盈触发）** webhook URL
在 **提醒设置**中，勾选 **“Webhook URL”** 粘贴来自 goodcryptoX Webhooks 部分的对应 webhook URL。保持 Message 字段原样——不会被使用。 #### 示例 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 机器人 | ### 视频教程 #### **webhook 交易入门** {% embed url="" %} #### **使用 DCA 机器人配合 webhook** {% embed url="" %} #### **使用 webhook 的多重止盈** {% 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-zh/yong-xu-dex/webhook.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.