# Webhook

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

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

在不久的将来，我们将推出新的 TradingView 策略机器人，通过 webhook 支持完整的策略指令，包括动态品种选择、数量、订单类型以及多品种逻辑——实质上充当一个 API 层。敬请期待

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

### goodcryptoX 中 webhook 的工作方式

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

以下是视频概览：

{% embed url="<https://youtu.be/Mx-nD_p2Pgw>" %}

> Webhook URL 与动作一一对应。你必须为每个动作创建一个 webhook，例如入场一个、止盈一个、止损一个，等等，适用于每个机器人或订单

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

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

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

> **取消** webhook——在所有订单和机器人中始终可用
>
> **平仓** webhook——在 DCA 机器人详情中始终可用

<figure><img src="https://4287295536-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fl2pfeXIwqa1tpvsFEldb%2Fimage.png?alt=media&#x26;token=99ca6c17-d547-47c7-abaf-1d1e3bb4e03a" alt="" width="375"><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%2FlG04MgjoXROWz32j0tN4%2Fimage.png?alt=media&#x26;token=08009fa1-7757-4495-b60e-1165e12887b3" alt="" width="375"><figcaption></figcaption></figure>

总结：

| 动作           | 是否支持？ | 备注                         |
| ------------ | ----- | -------------------------- |
| 取消订单         | ✅     | 始终在详情中显示                   |
| 触发限价单        | ✅     | 必须在创建时选择 webhook           |
| 激活跟踪单        | ✅     | 跟踪启动 = webhook             |
| 触发止盈 / 止损    | ✅     | 可选由 webhook 触发             |
| DCA 机器人 - 入场 | ✅     | 通过 webhook 入场买/卖（必须在创建时设置） |
| DCA 机器人 - 出场 | ✅     | 通过 webhook 平仓（始终可用）        |

{% hint style="info" %}
**使用 webhook 的多目标止盈**

如果你将止盈组设置为以 webhook 作为触发方式，它们将共享同一个 webhook URL。每次触发该 webhook，序列中的下一个 TP 订单会依次执行——一个接一个。
{% endhint %}

### 如何在 TradingView 中设置提醒

当你在 goodcryptoX 中创建了订单或机器人并复制了某个动作的 webhook URL 后，按以下步骤把它链接到 TradingView 提醒：

1. 前往 TradingView 的图表
2. 基于你的策略、指标或条件创建新提醒
3. 在 **提醒设置**中，勾选 **“Webhook URL”**
4. 将来自 goodcryptoX 的特定 webhook URL 粘贴到 **可用的 webhooks** 栏目
5. 将 **消息字段** 保持原样（内容随意——goodcryptoX 目前会忽略负载）
6. 保存提醒

### 重复型策略（通过 DCA 机器人）

由 webhook 触发的订单（例如带 TP 与 SL 的限价单）是 **一次性设置**。一旦订单成交且关联的 TP 或 SL 触发，整笔交易就完成。如果你希望这种结构 **自动重复**，订单无法实现——但现在可以通过 DCA 机器人实现。

我们很快会推出专用的 TradingView 策略机器人，以支持重复的多动作交易；在此之前，DCA 机器人提供了灵活方式来重复你的 webhook 驱动策略。

#### 纯 webhook 循环

要设置一个在 webhook 入场、webhook 出场并重复循环的机器人：

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

<figure><img src="https://4287295536-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNUBBrWgJqqqvjcnLBw7C%2Fimage.png?alt=media&#x26;token=ced6146d-5d8e-4496-94bc-0cb08cb57282" alt="" width="375"><figcaption></figcaption></figure>

机器人启动后，你会在机器人的 **详情 → Webhooks** 部分看到以下 webhook URL：

* **入场买入** — 开启多头仓位
* **平仓** — 平掉当前持仓（多头或空头）
* **取消** — 停止机器人

**执行逻辑**

* 当机器人收到 **入场买入**时，会开出多头仓位。
* 机器人 **只会响应第一个入场 webhook** （空闲状态下）收到的信号。
* 当持仓打开时：
  * 任何进一步的入场信号都会被 **忽略**
  * 唯一接受的信号是 **平仓** 或触发的 TP/SL（如果已配置）
* 一旦仓位被平掉（手动、通过 webhook，或由 SL/TP 触发），机器人会重置并等待下一次入场 webhook。

只要机器人保持激活，该循环就会持续，允许你无限次重复 入场 → 出场 → 重置 的完整周期。

#### 纯 webhook 模式 vs 混合方案

DCA 机器人支持多层控制，可组合构建灵活策略：

* **入场**：通过 webhook、信号或即时
* **出场**：通过 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%2Ffg4E339WmltyEDaiNjma%2Fimage.png?alt=media&#x26;token=0ee7cab9-7575-4ac2-89c4-841693b2ba77" alt="" width="375"><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%2Fc3oNniHr6lmTUwc8qQ7V%2Fimage.png?alt=media&#x26;token=9787c6e6-5744-48cc-8ae1-a891fd775e8e" alt="" width="375"><figcaption></figcaption></figure>

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

将来自 goodcryptoX 的特定 webhook URL 粘贴到 **可用的 webhooks** 栏目。将 Message 字段保持原样——不会被使用。

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

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

**在 goodcryptoX 中的设置**

创建 DCA 机器人

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

**在 TradingView 中的设置**

* 在同一张图上创建三个提醒：
  1. SMA50 上穿 SMA200 → 发送到 **入场买入** webhook
  2. SMA50 下穿 SMA200 → 发送到 **入场卖出** webhook
  3. RSI > 70 → 发送到 **平仓** webhook

### 总结

| 概念   | 说明                                         |
| ---- | ------------------------------------------ |
| 触发模型 | 每个动作都有自己的 webhook URL                      |
| 设置流程 | 创建订单 → 复制 webhook URL → 粘贴到 TradingView 提醒 |
| 重复策略 | 使用启用重复的 DCA 机器人                            |