PATTERNSMART · PINE SCRIPT 编程实践
TradingView Pine Script v6 Webhook 提醒排错:RSI 区间退出、冷却期与动态 JSON
构建可审计的 RSI Webhook 提醒流程:精确定义区间退出事件、在 K 线收盘时确认、通过共享冷却期抑制连续通知,最后输出便于程序解析的 JSON 数据。
难度:交易技巧 · Pine Script v6 · 免费完整指标源码 · 数值示例均为假设情境
为什么图上的信号很清楚,Webhook 却仍然可能重复或误报?
图表中 RSI 穿越阈值,与外部系统收到一条提醒消息,并不是同一个事件。例如,在一根尚未收盘的 K 线内,RSI 可以暂时升破 30,最后又跌回 30 下方;也可能有两个独立创建的提醒使用了不同参数;或者一个持续为真的条件在多根 K 线上被重复检测。若下游程序把每条通知都当作“唯一且已确认”的交易信号,脚本执行中的细节就会演变成实际操作风险。
这篇周日实用技巧文章介绍的是自定义指标和提醒审计工具,并非自动下单策略。程序识别两种严格定义的 RSI 区间退出:从超卖区向上离开,以及从超买区向下离开;仅接受收盘确认后的事件,随后应用全局共享的冷却规则,并通过 Pine Script 的 alert() 发出动态 JSON,同时在副图标出被接受的事件,便于复盘。
该实现不使用更高周期数据请求、不主动引用未来信息,也不会在盘中发送最终确认信号。不过,“收盘确认”并不等于对一切变化都绝对不重绘:数据修订、图表类型、交易时段、用户修改参数和 TradingView 保存的提醒快照,都可能导致后来看到的历史结果与原先实时情境不同。
先设计提醒决策流程,再讨论指标公式

第一步:检测“离开区间”的瞬间,而不是持续状态
ta.rsi(close, 14) 根据当前图表的收盘价序列计算 Wilder 风格的相对强弱指数。默认超卖阈值是 30:当上一根 RSI 小于或等于 30,当前 RSI 大于 30,才算一次向上离开超卖区;默认超买阈值是 70:当上一根 RSI 大于或等于 70,当前 RSI 小于 70,才算一次向下离开超买区。源码分别使用 ta.crossover() 和 ta.crossunder(),因此不是“只要 RSI 位于 30—70 之间就一直触发”的持续条件。
第二步:明确收盘边界,正确区分历史与实时执行
barstate.isconfirmed 在历史 K 线上以及实时 K 线最终收盘的那次更新为真。它被写入事件接受条件,可防止把盘中临时越界绘制成已确认标记。另一方面,alert.freq_once_per_bar_close 用于限定 alert() 的实时发送频率,使通知只在收盘时产生。两者作用不同:前者决定是否接受信号,后者约束提醒触发时点。历史图表上有符合条件的标记,并不表示当时真的曾发送 Webhook。
第三步:使用共享状态管理三根 K 线的冷却期
脚本用一个 var int lastAcceptedBar 记录最近一次真正被接受的事件所在的 bar_index,无论它来自超卖还是超买方向。下一次事件仅在 bar_index - lastAcceptedBar > quietBars 时通过。如果默认 quietBars=3,那么第 420 根 K 线接受信号后,421、422 和 423 上的候选信号都被抑制,最早在 424 才可能再次接受。只有通过所有过滤器的事件才会更新状态;被拒绝的信号不会排队补发。
第四步:把提醒做成可验证的结构化数据
动态 JSON 包含事件方向 event、品种标识 symbol、周期 timeframe、K 线起始时间戳 bar_time_ms(Unix 毫秒)、图表序号 bar_index、rsi 和 close;用户还可以选择是否带上 volume。跨平台去重时,将品种、周期、K 线时间与事件类型结合起来,通常比单独依赖 bar_index 更稳妥,因为历史数据加载范围可能发生变化。接收端仍应做独立的去重、格式验证和风险判断,不应盲目信任任何一条 Webhook。
用一组假设数值走通整个流程
| K 线 | 假设 RSI / 条件 | 处理结果 |
|---|---|---|
| 419 | RSI=29.6,仍在 30 下方 | 未触发超卖退出事件 |
| 420 | RSI 收盘为 32.4;首次向上越过 30,且没有冷却限制 | 接受 OVERSOLD_EXIT;lastAcceptedBar=420 |
| 421—423 | 假设 RSI 先重返某个区间,随后又发生新的有效边界交叉 | 全部抑制:距离最近接受事件仅有 1—3 根 K 线 |
| 424 | 假设 RSI 从 73.8 向下穿过 70,收盘为 69.2 | 若该方向开启,则接受 OVERBOUGHT_EXIT,因为 424−420=4>3 |
这是可复核的规则演示,不是 TradingView 的真实回测成绩。请特别注意:如果 RSI 没有先回到边界另一侧,超卖退出本身不可能连续重复;表中 421—423 的“再次交叉”假设包含了中间重新进入区间的过程。由于冷却期为两个方向共用,反方向信号也会受抑制。把冷却期设为零,可以接受每一次独立且收盘确认的交叉;增加冷却期则有助于限制通知密度,但也可能错过新的有效事件。
输入参数与实际取舍
| 参数 | 默认值 | 影响 |
|---|---|---|
| RSI length | 14 | 周期越短通常越灵敏、交叉更频繁;周期较长变化更平缓。 |
| Oversold / Overbought boundary | 30 / 70 | 直接决定退出边界的位置,两个阈值可分别设置。 |
| Full intervening cooldown bars | 3 | 接受事件之后,跳过接下来 3 根完整 K 线;两个方向共享限制。 |
| Alert: exit above oversold / below overbought | 均开启 | 允许仅保留一个方向,不必改动检测公式。 |
| Include volume in JSON | 开启 | 仅输出图表提供的成交量;缺失时采用 JSON null,不虚构为零。 |
完整 Pine Script v6 指标源码(与英文版逐字相同)
下方程序包括 RSI 退出区间检测、已收盘确认、共享冷却状态、动态 JSON 构造、图表信号标记,以及可选的静态 alertcondition() 条件。它已按照 Pine Script 的官方语法和提醒机制进行尽可能的逻辑核对,但尚未在 TradingView 账户中实际编译;正式使用前请在 Pine Editor 内检查编译结果,并逐项进行测试。
//@version=6
indicator("PS RSI Zone-Exit Webhook Auditor", shorttitle="PS RSI Alerts", overlay=false, max_labels_count=300)
// Signal definition and alert preferences.
rsiLength = input.int(14, "RSI length", minval=2)
lowerLevel = input.float(30.0, "Oversold boundary", minval=1.0, maxval=49.0)
upperLevel = input.float(70.0, "Overbought boundary", minval=51.0, maxval=99.0)
quietBars = input.int(3, "Full intervening cooldown bars", minval=0, maxval=100)
allowLong = input.bool(true, "Alert: exit above oversold")
allowShort = input.bool(true, "Alert: exit below overbought")
includeVolume = input.bool(true, "Include volume in JSON")
// A zone exit is a directional crossing of a boundary.
rsiValue = ta.rsi(close, rsiLength)
rawLong = ta.crossover(rsiValue, lowerLevel)
rawShort = ta.crossunder(rsiValue, upperLevel)
// Track ONLY previously accepted events. History initializes state;
// actual alert() delivery occurs on live bars, never historical bars.
var int lastAcceptedBar = na
cooldownReady = na(lastAcceptedBar) or (bar_index - lastAcceptedBar > quietBars)
// Both the explicit confirmation guard and alert frequency matter.
longEvent = barstate.isconfirmed and allowLong and rawLong and cooldownReady
shortEvent = barstate.isconfirmed and allowShort and rawShort and cooldownReady
acceptedEvent = longEvent or shortEvent
if acceptedEvent
lastAcceptedBar := bar_index
string side = longEvent ? "OVERSOLD_EXIT" : "OVERBOUGHT_EXIT"
// A structured payload is preferable to parsing prose downstream.
string payload = '{"event":"' + side + '"'
payload += ',"symbol":"' + syminfo.tickerid + '"'
payload += ',"timeframe":"' + timeframe.period + '"'
payload += ',"bar_time_ms":' + str.tostring(time)
payload += ',"bar_index":' + str.tostring(bar_index)
payload += ',"rsi":' + str.tostring(rsiValue, "#.##")
payload += ',"close":' + str.tostring(close, format.mintick)
if includeVolume
payload += ',"volume":' + (na(volume) ? "null" : str.tostring(volume))
payload += '}'
alert(payload, alert.freq_once_per_bar_close)
// The pane shows accepted events, not every temporary intrabar touch.
plot(rsiValue, "RSI", color=color.rgb(37, 94, 224), linewidth=2)
hline(lowerLevel, "Oversold", color=color.rgb(29, 144, 88), linestyle=hline.style_dashed)
hline(upperLevel, "Overbought", color=color.rgb(193, 55, 65), linestyle=hline.style_dashed)
hline(50.0, "Center", color=color.new(color.gray, 50))
plotshape(longEvent, title="Accepted oversold exit", style=shape.triangleup, location=location.bottom, color=color.green, size=size.tiny, text="L")
plotshape(shortEvent, title="Accepted overbought exit", style=shape.triangledown, location=location.top, color=color.red, size=size.tiny, text="S")
bgcolor(not cooldownReady and barstate.isconfirmed ? color.new(color.gray, 94) : na)
// Optional static conditions: they do NOT carry the dynamic JSON body.
alertcondition(longEvent, title="Oversold exit (static)", message="RSI exited oversold on {{ticker}} at {{close}}")
alertcondition(shortEvent, title="Overbought exit (static)", message="RSI exited overbought on {{ticker}} at {{close}}")
安装指标及正确创建 Webhook 提醒
- 在 TradingView 的时间型 K 线图表中打开 Pine Editor,粘贴全部 Pine Script v6 源码、保存并点击 Add to chart。如编译器出现报错,应先修复再建立提醒。
- 进入指标设置,调整 RSI 周期、上下阈值与冷却期。检查副图中绿色和红色的事件标记是否与收盘之后的 RSI 交叉一致,而非盘中偶然触碰。
- 在 Create Alert → Condition 中选择该指标,再选择 Any alert() function call。只有这种选择才会发送代码动态组装的 JSON。Webhook 地址应指向你自己管理、具有权限控制的接收端。
- 如果希望获得 JSON,不要误选
Oversold exit (static)或Overbought exit (static)。这两个alertcondition()选项是独立的静态消息条件,不发送同一份动态 JSON。 - 在实时市场中等待一次已收盘的合格事件,然后检查提醒日志:JSON 是否完整、品种与周期是否正确、
event方向及数值时间戳是否符合预期,以及是否出现意外重复。
TradingView 创建提醒时会保存当时脚本与设置的提醒快照。之后修改代码或图表上的参数,并不意味着已运行的提醒自动采用新版本;修改后应主动重新创建提醒,并核查生效配置。另外,周末或市场休市时,历史标记并不会凭空生成新的实时 Webhook 消息。
故障排查:四个最容易误判的情形
图表上有标记,却没有收到 Webhook:历史绘图不等于提醒历史。确认提醒仍处于运行状态,Condition 为 Any alert() function call,市场确有新的实时 K 线,而且当前事件没有被冷却过滤。
同一根 K 线收到了两条通知:本脚本只管理同一个提醒实例内部的状态,不会自动识别多个独立创建的提醒,也不能防止网络重试导致外部重复送达。接收端必须建立事件键与幂等检查。
RSI 明明穿过 30,却没有显示信号:检查 RSI 在最终收盘时是否仍满足真正的边界交叉、该方向有没有启用、以及是否落在共享冷却期内。被收盘结果否定的盘中交叉本来就应被忽略。
JSON 字段缺失、数值解析失败:成交量字段由选项控制,缺失数据可能写为 null。非时间型图表、不同品种元数据、价格小数位格式及接收端 JSON 解析,需要分别测试。
连接任何自动化系统之前,完成五项验收
- 复制指标,把
quietBars=0,核对每一次独立、收盘确认的区间退出是否均有标记;再恢复默认值 3,检查之后三根完整 K 线上的候选事件是否被抑制。 - 在实时市场观察一次盘中 RSI 越过阈值、收盘又返回原区间的情形。只要收盘未形成交叉,就不应该出现新的“已接受事件”。
- 分别建立一次动态
alert()提醒与(如有需要)一次静态alertcondition()提醒;检查两种选择的实际消息内容,避免把固定文本当成动态 JSON。 - 使用标准 JSON 解析器验证真实 Webhook 样本,核查
bar_time_ms是毫秒级数值、价格小数位正确、成交量缺失时不会误判为零。不要假设所有品种都有成交量数据。 - 暂时关闭一个提醒方向、切换图表周期、重新创建提醒,检查快照配置是否更新,并清理不再需要的旧提醒实例以降低重复通知。
这套方法的价值在于工程可审计性:清晰的事件定义、明确的时间边界、可解释的冷却机制和结构化输出,可以帮助定位提醒问题,但不代表 RSI 具有预测优势,也不保证任何盈利结果。趋势行情中的 RSI 信号可能失效,Webhook 也可能因网络因素延迟或重复送达。若以后连接真实订单执行系统,必须另行设计接收端验证、限仓、资金风控与故障处理。
如果你对这个免费提醒审计指标感兴趣,希望将它用于自己的观察列表、Webhook JSON 格式或数据处理流程,并进一步定制、扩展或修改,可以了解我们的 交易软件定制开发服务,欢迎联系我们讨论具体需求。