# Webhook goodcryptoX 允许你通过 TradingView 的 webhook 来自动化 DEX 交易——这是一种强大的机制，可直接由你的信号触发下单与机器人动作。 与某些把 webhook 当作可编程 API（你发送诸如“买入 3 个 BTC”这类带参数命令）的实现不同，goodcryptoX 目前支持基于触发的模型。每个 webhook 只会在特定订单或机器人的预定义动作上生效——不会解析任何参数或命令。 在不久的将来，我们将推出新的 TradingView 策略机器人，通过 webhook 支持完整的策略指令，包括动态品种选择、数量、订单类型以及多品种逻辑——实质上充当一个 API 层。敬请期待 > 目前仅接受来自 TradingView 服务器的 webhook——不支持自定义 IP 或外部来源。\ > 如果你需要使用自定义的 webhook 来源，请联系 申请访问权限。 ### goodcryptoX 中 webhook 的工作方式 * 每个订单或机器人 **动作** 都有专属的 webhook URL * 你必须先创建该订单或机器人才能获取 URL（它们会出现在该订单或机器人的 **Webhooks** 部分的 **详情**) * 向 **任意** 将 webhook 负载发送到该 URL 都会触发该动作 以下是视频概览： {% embed url="" %} > Webhook URL 与动作一一对应。你必须为每个动作创建一个 webhook，例如入场一个、止盈一个、止损一个，等等，适用于每个机器人或订单 ### 支持的订单与机器人动作 如果你希望你的订单或机器人被 **webhook 触发**，你必须在创建时选择 webhook 作为 **触发条件**。适用于： * 限价单触发 * 跟踪单激活（跟踪启动） * 止盈与止损触发 * DCA 机器人入场条件 > **取消** webhook——在所有订单和机器人中始终可用 > > **平仓** webhook——在 DCA 机器人详情中始终可用
创建完成后，你可以在订单或机器人的 **详情** 中找到所有可用的 webhook URL：
总结： | 动作 | 是否支持？ | 备注 | | ------------ | ----- | -------------------------- | | 取消订单 | ✅ | 始终在详情中显示 | | 触发限价单 | ✅ | 必须在创建时选择 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. 启用 **“平仓后重复”**
机器人启动后，你会在机器人的 **详情 → 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
**在 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 的特定 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 机器人 | --- # 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/dex-jiao-yi-xian-huo/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.