# Webhook

goodcryptoX 允许你通过 TradingView 的 webhook 来自动化交易操作——这是一种强大的机制，可直接由你的信号触发下单与机器人动作。

与某些将 webhook 视为可编程 API（例如发送“buy 3 BTC”这类带参数命令）的实现不同，goodcryptoX 目前支持基于触发的模型。每个 webhook 仅会在特定订单或机器人的预定义动作上生效——不会解析任何参数或命令。

在不久的将来，我们将上线一个新的 [TradingView 策略机器人](https://docs.goodcrypto.app/goodcryptox-zh/yong-xu-he-yue-jiao-yi-suo/ji-jiang-tui-chu-de-gong-neng/tradingview-ce-le-ji-qi-ren) 它通过 webhook 支持完整的策略指令，包括动态交易对选择、数量、订单类型与多标的逻辑——等同于一个 API 层。敬请关注

> 目前仅接受来自 TradingView 服务器的 webhook——不支持自定义 IP 或外部来源。\
> 如果你需要使用自定义的 webhook 来源，请通过以下方式联系我们 <support@goodcrypto.app> 申请访问权限。

### goodcryptoX 中 webhook 的工作方式

* 每个订单或机器人 **动作** 都有自己专属的 webhook URL
* 你必须先创建订单或机器人才能获得 URL（它们会出现在 **Webhooks** 该订单或机器人的 **详情**)
* 向 **任意** 向该 URL 发送 webhook 负载都会触发该动作

> Webhook URL 与动作绑定，而非与用户绑定。你必须为每个动作创建一个 webhook，例如：一个用于入场、一个用于止盈、一个用于止损等，针对每个机器人或订单均如此

### 支持的订单与机器人动作

如果你希望你的订单或机器人被 **webhook 触发**，你必须在设置时选择 webhook 作为 **触发条件**。适用于：

* 止损市价 / 止损限价单触发
* 跟踪单激活（跟踪开始）
* 止盈与止损触发&#x20;
* DCA 机器人入场条件

<figure><img src="https://4287295536-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://4287295536-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://4287295536-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://4287295536-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 平仓（始终可用）        |
| 网格机器人 - 入场   | 🚫    | 尚不支持                       |

{% 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 策略机器人](https://docs.goodcrypto.app/goodcryptox-zh/yong-xu-he-yue-jiao-yi-suo/ji-jiang-tui-chu-de-gong-neng/tradingview-ce-le-ji-qi-ren) 以支持可重复的多动作交易，但在此之前，DCA 机器人已能灵活地重复你的 webhook 驱动策略。

#### 纯 webhook 循环

要设置一个通过 webhook 入场、通过 webhook 出场、然后重复的机器人：

1. 将 **入场条件** = webhook
2. 将 **均价单** = 0（禁用加仓均价）
3. 同时禁用 **止**-**盈** 与 **止损**
4. 启用 **“平仓后重复”**&#x20;

<figure><img src="https://4287295536-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）**&#x65F6;，会开多头仓位。
* 当它收到 **入场卖出（Enter Sell）**&#x65F6;，会开空头仓位。
* 机器人 **只会响应空闲时收到的第一个入场 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://4287295536-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. 价格跌破下轨 → 发送至主订单的 **Trigger（触发）** webhook URL
2. 价格回到轨道内 → 发送至 **Take Profit Trigger（止盈触发）** webhook URL
3. 价格上穿中轨 → 发送至 **Take Profit Trigger（止盈触发）** webhook URL
4. 价格突破上轨 → 发送至 **Take Profit Trigger（止盈触发）** webhook URL

<figure><img src="https://4287295536-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。保持 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="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

#### **使用 DCA 机器人配合 webhook**

{% embed url="<https://youtu.be/gHXB2S6qdXU?si=i9ZobjRsxFAe7zcJ>" %}

#### **使用 webhook 的多重止盈**

{% embed url="<https://youtu.be/xF-O7ZDoDtU?si=apfiF8uyTn-p4Vh4>" %}