# Webhook

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

与某些将 webhook 当作可编程 API（你发送诸如“买入 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 来源，请联系 <support@goodcrypto.app> 以申请访问权限。
* Webhook 仅对拥有有效 PRO [套餐](/goodcryptox-zh/sheng-tai-xi-tong/ding-yue-fang-an.md) 或更高等级的用户开放。

### goodcryptoX 中 webhook 的工作原理

* 每个订单或机器人 **动作** 都有自己的专属 webhook URL
* 你必须先创建订单或机器人来获取 URL（它们会显示在 **Webhooks** 区域，即该订单或机器人的 **详情**)
* 向 **任意** webhook 负载发送到该 URL 都会触发对应动作

> Webhook URL 与动作相关，而非用户相关。每个动作都需要创建一个 webhook，例如：一个用于入场、一个用于止盈、一个用于止损等，适用于每个机器人或订单

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

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

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

<figure><img src="/files/b1cb74a87f623214adf5b8ecb02ffe11c048fd25" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/2d4406f1b583c3297b4347478674823312e5b631" alt="" width="563"><figcaption></figcaption></figure>

创建后，你将在订单或机器人的 **详情** 中找到所有可用的 webhook URL：

<figure><img src="/files/13c7db2dc27896df3d241928039ebb793cc6467e" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/b6f468982e51c0704aff95cf42db108c1778bd0d" 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 策略机器人](/goodcryptox-zh/cex-jiao-yi/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. 启用 **“平仓后重复”**&#x20;

<figure><img src="/files/40c346d9529cad00c9b3912bc71f508a526b0b91" alt="" width="375"><figcaption></figcaption></figure>

机器人启动后，你会在机器人的 **详情 → 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 的止损市价单
* 添加三个止盈目标。止盈触发 = webhook

<figure><img src="/files/5bd15dd0b6d61e0dc3fb72ec6d9667c5b0a85eb0" alt="" width="563"><figcaption></figcaption></figure>

**在 TradingView 中的设置**

创建四个提醒：

1. 价格跌破下轨 → 发送到主订单的 **触发** webhook URL
2. 价格回到带内 → 发送到 **止盈触发** webhook URL
3. 价格上穿中轨 → 发送到 **止盈触发** webhook URL
4. 价格上破上轨 → 发送到 **止盈触发** webhook URL

<figure><img src="/files/a686ef82c8e5e1f61c1fb4bbb1be76c9e819b885" alt="" width="563"><figcaption></figcaption></figure>

在 **提醒设置**中，勾选 **“Webhook URL”**

粘贴来自 goodcryptoX Webhooks 区域的对应 webhook URL。保持消息字段不变——该字段不会被使用。

#### 示例 2：使用 DCA 机器人的重复策略（金叉/死叉）

**目标：** 金叉做多，死叉做空。以 10% 利润或 RSI > 70 时出场，并无限重复。

**在 goodcryptoX 中的设置**

创建 DCA 机器人

* 入场条件 = webhook
* 加仓 = 关闭（设为 0）
* 止盈 = 10%
* 止损 = 关闭
* 启用：“止盈后重复”

**在 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 机器人                            |
| 访问   | 需要 PRO 套餐或更高                               |

### 视频教程

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


---

# 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/cex-jiao-yi/webhook.md?ask=<question>
```

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.
