跳转到主要内容

信号机器人

通过 Webhook 将 TradingView 警报自动转换为 Pionex 合约交易指令。涵盖 TradingView Essential 方案需求、策略测试脚本、Webhook URL 设置、仓位大小计算公式、最高 10 倍杠杆限制、仅支持合约交易,以及警报触发失败的处理说明。

透过信号机器人策略,交易者可以将 TradingView 警报自动化为 Pionex 上的实时交易。透过 webhook 将 TradingView 策略连接到 Pionex,投资者能即刻捕捉机会——无论是在信号触发时买入,或是在条件反转时卖出。

这种自动化确保了在波动市场中的纪律、速度与一致性。


什么是信号机器人

信号机器人是由 Pionex 开发的自动化工具,能将 TradingView 警报直接连接到您的 Pionex 账户。机器人会监听您所选策略的信号,并自动下单,无需手动执行交易。

它作为策略设计与实时执行之间的桥梁,使交易更快速且更可靠。


信号机器人与其他机器人的差异是什么?

  • 天地单:专注于套利区间与波动率捕捉。

  • 网格机器人:专长于跨价格区间的网格交易。

  • CopyBot(跟单):复制其他交易者已公开的机器人,策略与参数来自该机器人的作者,而非您自己设定(仅支持 Pionex App)。

  • 信号机器人:根据外部信号(TradingView 警报)执行交易,让您拥有完全的灵活性来设计或导入策略。


如何开始使用信号机器人?

  1. 建立 Pionex 账户。

  2. 设置 TradingView Essential(或更高级)方案以启用 webhook。

  3. 建立或导入 TradingView 策略脚本。

  4. 在 Pionex 生成信号机器人并复制其 webhook URL。

  5. 将 webhook 粘贴入 TradingView 警报设置中。

  6. 测试警报并确认交易自动执行。


Signal Bot 的资金来源

您的 Signal Bot 从主账户(Primary Account)的现货余额中扣款,而非合约账户。「合约」指的是机器人交易的市场,而不是提供资金的账户。

若主账户余额不足而合约账户中有资金,请先划转:资产 → 合约账户 → 划转出 → USDT → 主账户,然后再创建机器人或为其注资。已存放在主账户中的资金无需划转。

创建机器人时设置的投资金额,乘以您选择的杠杆倍数(最高 10 倍),即为该机器人的权益,也是策略中 qty 数值所对应的下单规模。


建立 Pionex 兼容策略

要开始使用信号机器人,您必须先在 TradingView 上拥有一个包含内建「策略」的可运作指标。

您可以透过检查是否有「策略测试器」选项来确认是否具备内建策略,该选项会显示回测结果。

若 TradingView 缺少此选项,您需要取得带有策略的开源指标或使用 AI 模型自行生成。

1. 您需要一个 Telegram 账户,加入我们的Telegram 群组并取得文件。

2. 打开置顶消息并找到「pionex-signal-bot-toolkit.html」文件。

3. 打开新页面后,请选择第一个选项。

4. 生成指标

  • 使用任何 AI 平台来创建 TradingView Pine Script。

  • 将脚本复制到 TradingView 的 Pine 编辑器,然后点击 加入图表。

5. 应用于 TradingView:

  • 复制生成的脚本。

  • 将其粘贴入 TradingView Pine 编辑器。

  • 点击「加入图表」。

6. 调整脚本(必要修改): 确认脚本可运作后,进行修改以避免未来冲突:

  • 条件变量:移除、修改或注释(//)任何与 Toolkit 生成器专用变量「longCondition」和「shortCondition」相似的变量。

  • 不必要的代码:移除初始化代码(版本)及警报代码行。

  • 绘图代码:图表绘图代码行可保留,但须确保不与前述条件变量冲突。

  • 识别条件:记录定义指标「多头」和「空头」条件的具体代码行,因为这些将用于 Toolkit 生成器。

7. 生成策略代码:将修改后的代码粘贴入 Toolkit 生成器:

  • 字段 1:粘贴完整修改后代码。

  • 字段 2:粘贴「多头」条件代码。

  • 字段 3:粘贴「空头」条件代码。

点击「生成」按钮。

8. 更新 TradingView:

  • 复制新生成的策略代码。

  • 将最终代码粘贴入 TradingView Pine 编辑器。

  • 点击「更新图表」。

  • 错误检查:若出现轻微错误,依建议提示修正。

  • 确认:若无错误,图表应显示策略测试器结果,并有持仓进出场标记,证明指标已具策略功能。

9. 优化回测:在连接策略至 Pionex 信号机器人前,调整指标设置以优化回测结果。

10. 在「属性」设置中,参考以下建议设置:

  • 初始资金:保持此值为「100」

  • 基础货币:保持此值为「预设」

  • 订单大小:1 ~ 100 USDT。此值保持在 1 至 100 USDT 之间。
    「50」USDT 将被解读为信号机器人资金利用率的 50%

  • 金字塔加码:1 ~ 任意值。此值用于多重持仓进场设置

  • 多头保证金:保持此值为「0」

  • 空头保证金:保持此值为「0」

  • 其他参数可忽略,因不影响配置。

11. Pionex 兼容的 TradingView 策略建立完成。


在 Pionex 上配置信号监听器

1. 登录您的 Pionex 账户

2. 前往 合约 → 合约机器人 → 信号机器人

3. 点击「新增信号」按钮,设置此信号的名称及描述,然后点击「确认」

4. 信号建立后,直接点击「我已完成脚本配置」及「我已完成各币种信号推送配置」

5. Pionex 上的信号设置完成。


在 Pionex 上建立信号机器人

1. 登录您的 Pionex 账户

2. 前往 合约 → 合约机器人 → 合约机器人

3. 在「信号机器人」页面,点击「自动化信号」配置机器人设置,然后点击「建立机器人」

4. Pionex 上的信号机器人建立完成。


将 TradingView 警报连接到 Pionex 信号

1. 登录您的 TradingView 账户(http://www.tradingview.com/chart)

2. 点击右上角的「警报」图标,然后点击「+」图标建立新警报

3. 在「设置」标签,从列表中选择所需策略。

注意:最新设置会在列表底部,策略「输入」配置变更时需更新。

4. 在「消息」标签,保持默认内容不变。

注意:内容将产生作为交易指令的 JSON 代码「消息」。

5. 在「通知」标签,启用「Webhook URL」,并将 Pionex 的「Webhook URL」粘贴入 TradingView 的「Webhook URL」字段

6. 点击「建立」按钮完成设置,警报将出现在「警报」列表中

7. TradingView 图表中的策略警报配置完成。


信号消息参考

您的 Webhook 地址与消息模板都显示在您自己的信号页面上:

https://www.pionex.com/en/user-signal/YOUR_SIGNAL_ID

请将 YOUR_SIGNAL_ID 替换为您自己的信号 ID。请从该页面复制地址与模板,不要手动输入。

默认的消息模板如下:

{"data":{"action":"{{strategy.order.action}}","contracts":"{{strategy.order.contracts}}","position_size":"{{strategy.position_size}}"},"price":"{{close}}","signal_param":"{}","signal_type":"YOUR_SIGNAL_ID","symbol":"{{ticker}}","time":"{{timenow}}"}

各字段含义

  • signal_type — 您的信号 ID。用于告知 Pionex 该警报属于哪个信号机器人。

  • symbol — 触发警报的 TradingView 交易对。

  • price — 下单所使用的价格。

  • time — 警报发送的时间。请保留 {{timenow}},详见下方「时间戳」。

  • signal_param — 保留字段,请保持为 "{}"。

  • data.action — buy 或 sell。

  • data.contracts — 本次订单的数量。

  • data.position_size — 本次订单执行后您的策略持仓。

持仓数量是累计的

您的持仓从零开始。正值代表多头持仓,负值代表空头持仓,数值会累加:先发送 +1,之后再发送 -1,持仓即回到零。

若要平仓,请发送相反的数值。请勿发送 0 或空值——这并非可靠的重置方式,可能导致持仓未被平掉。您也可以在「当前持仓」下点击「–」按钮手动平仓。

时间戳

请在模板中保留 {{timenow}},使时间戳为警报实际发送的时刻。

时间戳若超前当前时间 3 秒以上,该信号会被忽略。时间戳落后则没有问题——例如标记为 08:00 UTC 的消息在 08:01 到达 Pionex,仍会被接受并正常执行。

若您的脚本发送的是 K 线收盘时间而非 {{timenow}},时间戳可能会超前于实际时间,信号将被丢弃。

Webhook 如何验证

信号机器人的 Webhook 通过两项信息识别:Webhook 地址中的 token,以及消息中的信号 ID。与 Pionex 交易 API 不同,它不使用签名——这只是一个普通的 Webhook,无需签名。

在浏览器中打开该 Webhook 地址本身不会产生任何作用。即便如此,也请勿将您的 Webhook 地址或消息内容提供给他人,因为两者结合可以识别出您的信号。


检查从 TradingView 到 Pionex 的信号传送

1. 登录您的 TradingView 账户(http://www.tradingview.com/chart)

2. 点击右上角的「警报」图标,并点击「日志」标签查看列表

3. 登录您的 Pionex 账户

4. 点击「详细信息」,然后前往「信号日志」标签

5. 比较 TradingView 警报日志与 Pionex 信号日志,确保信号正确接收

6. 使用「信号消息解码器」将消息内容转换为更易理解的格式。


常见问题

问:我可以添加多少交易对到信号机器人?
答:一次只能启用一个交易对。不支持同时使用两个相同交易对。

问:为什么我的信号机器人开仓时数量不同?
答:信号机器人根据策略值计算持仓大小:公式:价格 × 持仓大小 = 名义价值(USDT)。

例如:投资 100 USDT,杠杆 10 倍,权益 = 100 × 10 = 1000 USDT;交易量 = 权益的 50% = 1000 × 50% = 500 USDT。

问:如果信号机器人关闭,还会处理信号吗?
答:不会,信号会接收但若无启用的信号机器人将被忽略。

问:如何编辑或删除已创建的信号?
答:信号的新增、编辑和删除都只能在网页版操作,App 只能查看并使用已创建的信号。请登录 Pionex 网页版,前往 合约 → 合约机器人 → 信号机器人,在「我的信号」列表中找到该信号,点击信号卡片上的「更多操作」,选择「编辑信号」或「删除信号」。
删除前请注意:

  • 如果仍有使用该信号且尚未关闭的机器人订单,系统会拒绝删除。请先关闭相关机器人,再删除信号。

  • 删除后无法恢复。该信号的 Webhook 地址约 1 分钟内失效,之后 TradingView 推送到该地址的警报都会被拒绝。如需继续交易,请新建信号,并把新的 Webhook 地址填入 TradingView 警报。

  • 删除信号不会同时删除 TradingView 中的警报,请到 TradingView 的「警报」列表,自行删除或停用使用该 Webhook 地址的警报。

  • 每个账户默认最多可创建 100 个信号,信号太多时可删除不再使用的信号。

问:我可以将信号机器人用于其他平台吗?
答:可以,只要信号运作方式类似 TradingView。

问:我可以使用多重进出场吗?
答:可以,只要策略与信号机器人执行兼容。

问:哪个 TPSL 设置会先执行:信号机器人还是 TradingView?
答:以先满足条件者为准。请只使用一种以避免冲突。

问:为什么 TradingView 警报后 Pionex 没有交易?
答:可能原因:
i. 信号已发送且接收:检查信号日志 > 详细信息是否有错误。
ii. 信号已发送但未接收:联系 TradingView 支持处理 webhook 问题。
iii. 信号已接收但无动作:「单向」模式的信号机器人可能会先平掉相反持仓。
iv. 信号的 time 超前当前时间 3 秒以上,因此被忽略。请在消息模板中保留 {{timenow}},而非 K 线收盘时间。

问:信号已发送但未成交,我该怎么办?
答:请手动平仓或自行手动触发信号(风险自负)。

问:我可以用信号机器人在现货市场交易吗?
答:不行,只限期货。可使用 1 倍杠杆达到类似现货效果。

问:信号机器人最大杠杆是多少?
答:10 倍。不建议使用更高杠杆。

问:我的信号机器人出现亏损,如何保持订单大小不变?
答:请增加保证金以覆盖亏损。最大订单大小依投资金额 × 杠杆决定。

问:我加保证金后,交易量会增加吗?
答:不会,加保证金只会调整权益与爆仓价格。

问:我可以分享我的信号机器人以进行利润分成吗?
答:支持。Signal Bot 支持利润分成,采用高水位(High-Water Mark)机制:仅当机器人的累计收益创下新高时才会收取分成,而非每笔盈利平仓都收取。若机器人回撤后再度回升,对于此前已实现的收益不会重复收取分成。分成比例由您自行设置,范围为 0% 至 30%。所收取的分成中,您获得 80%,Pionex 获得 20%。亏损不会产生分成。在外部 VPS 上运行策略同样需要分成,因为交易执行仍在 Pionex 完成。

问:"PionexGPT" 是否还能使用?
答:PionexGPT 已于早前正式下架,目前平台上已无法使用。如有类似需求,可以改用信号机器人,透过 TradingView 警报将您的交易策略自动化,直接在 Pionex 上执行。

问:信号机器人支持模拟交易吗?
答:不支持。目前模拟交易仅支持手动合约下单,模拟 PUSD 无法用于任何交易机器人,包括信号机器人。详情请参考「合约模拟交易」。


策略脚本中的多重进出场设置

  • 建议使用的 Strategy() 语法:

strategy("策略名称", overlay=true, default_qty_type=strategy.cash, default_qty_value=100, initial_capital = 100)
  • 以权益 25% 开多单示例:

strategy.entry("Long", strategy.long, qty=25)

「qty=25」将设定为「25 USDT」订单大小,解读为每个信号使用信号机器人权益的 25% 来开多单。相同代码行的后续信号将再使用 25% 权益,总计使用 50% 权益,依此类推。 2. 以权益 25% 平多单


示例:strategy.exit('Close Long', from_entry = "Long", qty_percent=25) 「qty_percent=25」将设定为平掉 25% 可用的多单持仓。

  • 平多单示例:

strategy.exit('Close Long', from_entry = "Long")

此行用于完全平掉多单持仓。

  • 以权益 25% 开空单示例:

strategy.entry("Short", strategy. Long, qty=25)

「qty=25」将设定为「25 USDT」订单大小,解读为每个信号使用信号机器人权益的 25% 来开空单。相同代码行的后续信号将再使用 25% 权益,总计使用 50% 权益,依此类推。

  • 以权益 25% 平空单示例:

strategy.exit('Close Short', from_entry = "Short", qty_percent=25)

「qty_percent=25」将设定为平掉 25% 可用的空单持仓。

  • 平空单示例:

strategy.exit('Close Short', from_entry = "Short")

此行用于完全平掉空单持仓。

这是否解答了您的问题?