如何在 Bybit 平台设置和使用 Webhook 信号交易

logo
更新于 2026-03-03 18:23:38
分享

Bybit 平台的 Webhook 信号交易是一款强大的交易工具,让用户能够使用来自 TradingView 的信号自动交易永续和交割合约。利用 TradingView 的 Webhook 功能,交易者可以在每次触发提醒时向特定 URL 发送请求,实现交易自动化。


在开始使用 Webhook 信号交易之前,请仔细阅读以下注意事项:

— 确保您使用的是 TradingView 付费订阅 (Essential/Plus/Premium),方可使用 Webhook。

— 请勿向他人透露您的 Webhook URL,以免收到虚假/欺诈消息或他人提交的虚假订单。

— 用户收到的所有 TradingView 提醒都仅基于用户设置。对于由此产生的任何交易亏损,Bybit 不承担任何责任。

— 信号触发依赖第三方平台,可能存在信号丢失或延迟的风险,敬请理解。

— 此功能仅适用于 Bybit 网页端的衍生品交易,包括 USDT 永续、USDC 永续、反向永续和反向交割,需使用您统一交易账户中的资金。




在下文中,我们将为您介绍在 Bybit 平台设置和使用 Webhook 信号交易的具体步骤。在开始之前,请确保您的账户资金充足。



  1. 创建 Webhook

  2. 在 TradingView 上运行策略

  3. 查看信号详情

  4. 暂停或终止 Webhook 信号

  5. 订单限制




创建 Webhook

第 1 步:交易选项卡下进入要交易的合约页面,在下单区中点击工具,然后选择 Webhook 信号交易







第 2 步:点击立即创建。请确保您已大致了解此功能。如需详细了解如何运行 Webhook 信号交易,请观看视频教程,然后点击我已确认







第 3 步:按照以下步骤设置您的 Webhook:

  1. 选择币种:选择要使用 Webhook 交易的币种。此处选择的币种必须与使用 TradingView 策略的币种相同。
  2. 持仓模式:单向持仓。请确保运行策略的币种使用的是单向持仓模式,目前不支持双向持仓模式自动交易。
  3. 信号名称:输入 TradingView 策略的信号名称。


然后,点击创建 Webhook



注意

— 确保您的策略脚本未依赖双向持仓模式,Webhook 信号交易仅支持单向持仓模式。

— 每个交易对需单独创建 Webhook。



恭喜您已成功创建 Webhook!








在 TradingView 上运行策略

第 1 步:创建 Webhook 后,点击相应合约,在 TradingView 上运行策略(如有需要)。







第 2 步:在 TradingView 页面上,点击策略测试器加载您的策略。


请注意,Webhook 信号交易仅用于执行策略,不适用于指标。要确定图表上使用的是指标还是策略,请查看 Pine Script 源代码的初始段。如果其上显示策略,则表明正在使用策略。相反,如果其上显示指标,则表明正在使用指标。







第 3 步:打开策略设置和参数。

  1. 将初始资金设置为您的 Bybit 账户余额。
  2. 输入每笔订单预期交易数额。系统将在收到信号后自动替您下单。


注意:

— 对于反向合约,目前仅支持按合约数量输入订单规模。按 USD 价值或净值百分比输入订单规模可能会导致下单失败。 这是由于TradingView和Bybit计算合约价值的逻辑不同。

— 按合约数量输入订单规模时,请注意,反向合约的合约单位为 1 USD,而对于 USDT 或 USDC 合约,以 BTCUSDT 或 BTC-PERP 为例,合约单位为 1 BTC。







第 4 步:为您的策略创建策略警报。

参数

说明

symbol

{{ticker}} from TradingView

提醒的符号

side

  1. {{strategy.order.action}} from TradingView
  2. ENTER_LONG
  3. EXIT_LONG
  4. ENTER_SHORT
  5. EXIT_SHORT

仅支持单向持仓模式。您可以从下拉菜单中选择订单的交易方向。


Tradingview 方向表示没有固定的交易方向 — 订单将根据 TradingView 策略方向下单。


trigger_time

{{timenow}} from TradingView

这是触发提醒的时间,您无需更改此参数。

strategy_id

Created by Bybit upon signal trigger

此 Webhook 提醒的策略 ID

amount_type

  1. absolute.quantity
  2. position.percentage
  1. 您可以从 Webhook 设置页面选择数量类型,或直接从粘贴在 TradingView 上的模板编辑参数值。
  2. 数量类型为可选,默认为绝对值 (value=absolute.quantity)。
  3. 绝对值表示 Webhook 将根据配置的数量为您下单。
  4. 持仓百分比 (value=position.percentage) 选项仅适用于平仓订单。它会根据所选的持仓百分比平掉您的仓位。


quantity

  1. strategy.order.contracts
  2. Contract quantity
  3. position percentage
  1. 如果设置的数量为 {{strategy.order.contracts}},Webhook 将根据 TradingView 上的设置为您下单。
  2. 您也可以在模板本身输入特定数量,这将覆盖原始信号。以 BTC 为例,如果您设置了 "quantity": "1"。对于 USDT/USDC 线性合约,1 份合约等于 1 BTC。对于反向合约,1 份合约等于 1 USD。
  3. 如果您选择的金额类型是持仓百分比,则设置的数量将是您想要平仓的持仓百分比(对于平多和平空),浮动值将在 [0.01, 100] % 之间。百分比平仓每次都基于最新的开仓数量。

price

Trigger price from tradingview strategy

这是触发提醒的价格结果。您无需对此参数进行更改。

max_lag

Non-negative integer value between [5, 300].

这是您可以接受的最大信号延迟。默认设置为 20 秒。如果延迟超出您的设置,Webhook 将不会下单。







第 5 步:点击策略测试器上的提醒图标,为您的策略创建提醒,并将消息模板和 Webhook URL 粘贴到“提醒”弹出窗口中。



备注:

— 您可以从 Bybit 页面复制消息模板,并将其粘贴到提醒设置选项卡的消息框中。



Webhook URL 可在 Bybit 页面找到,并粘贴到提醒通知选项卡中的 Webhook URL 字段。







第 6 步:信号触发后设置订单类型,如果要设置 TP/SL,请设置订单类型。


  1. 订单类型: 您可以设置市价单或限价单。
  2. 市价单在收到 TradingView 信号后会立即执行。
  3. 收到信号后,限价单会设定一个指定价格。对于限价单,您可以定义限价与触发价的距离

一旦警报被触发,相应的订单将被下达。

  1. 做多订单:限价 = 触发价 × (1 - 百分比))
  2. 做空订单:限价 = 触发价 × (1 + 百分比)


  1. 止盈/止损:止盈/止损单将与入场单同时执行(不支持出场单)。止盈和止损数量基于每个信号的大小。止盈 (TP) 和止损 (SL) 价格根据接收到的信号的触发价格计算得出。
  2. 对于做多订单:
  3. TP = 触发价 × (1 + 价格变化 %)
  4. SL = 触发价 × (1 - 价格变化 %)
  5. 对于做空订单:
  6. TP = 触发价 × (1 - 价格变化 %)
  7. SL = 触发价 × (1 + 价格变化 %)






第 7 步:点击运行 Webhook




您已成功设置信号交易!您将在 Bybit App 或网页端收到关于策略信号的推送通知。







查看信号详情

要查看 Webhook 信号的特定信息,请转至工具选项卡,然后选择 Webhook。在这里,您可以查看信号名称、触发/交易次数、已结盈亏和创建时间。




欲查看信号详情,请点击旁边的详情按钮,此处将显示 Webhook URL 和消息模板。此外,您还可以查看通过此策略执行的交易。




请注意,“Webhook 策略”选项卡上显示的已结盈亏为通过相应 Webhook 策略执行的交易的已结盈亏。此处不会反映用户手动交易产生的任何盈亏。



或者,您也可以转到工具历史,然后在“交易类型”中选择 Webhook 以查看详细信息。









终止 Webhook 信号

手动终止或暂停:要手动终止 Webhook 信号,请导航到工具选项卡。找到要关闭的 Webhook 发出的信号,然后点击终止。若要暂停策略,请点击暂停





自动终止:在以下情况下,Webhook 信号可能会自动终止:

  1. 连续 10 次下单失败,策略将终止。
  2. TradingView 不支持所选的合约类型。
  3. 下单参数缺失,导致自动终止。
  4. 系统不支持所选的持仓模式(双向持仓)。
  5. 所选的交割合约临近交割日期。
  6. 所创建的 Webhook 策略数量已达上限。每个交易对最多可同时运行 5 个 Webhook 策略,而每个 UID 最多可同时运行 30 个 Webhook 策略。
  7. 您的账户受限。








订单限制

请注意,通过 Webhook 策略提交的订单与手动永续和交割交易所受的订单限制相同,包括最小或最大订单规模、合约价格限制等。


以下情况可能会导致 Webhook 策略下单失败:


错误消息

说明

信号接收延迟,已取消该笔订单。

信号传输延迟,此时下单并执行可能会导致订单偏离策略。因此,订单被取消。

交易对无效,下单失败。

Bybit 不支持或已下架策略中设置的交易对。

下单参数缺失,请重新复制并使用消息模板。

参数设置不完整,请重新运行 Webhook。

可用余额不足,下单失败。

您的保证金余额不足,无法下单。请向您统一交易账户充值。

持仓模式不匹配,下单失败。

Webhook 信号交易仅支持单向持仓模式。持仓模式更改为双向持仓模式时,下单将失败。

超出风险限额,下单失败。

如果下单,将超过当前设定的风险限额。您可以在“交易偏好设置”中调整自己的风险限额。

临近交割,仅能提交只减仓订单。

交割合约临近交割日期,因此无法下单。

超出未平仓合约数量上限,下单失败。

如果下单,将超过未平仓合约数量上限。


这篇文章有帮助吗?