NinjaTrader 8 ATR 百分位阶段转换:带状态记忆的波动率压缩与扩张指标
高级交易教程 · NinjaTrader 8 · 免费完整 NinjaScript 指标源码
波动率收缩并不等于买卖信号。市场可能持续低波动很久,突然出现一根大 K 线也不能证明趋势已经形成。本文构建一个基于已收盘 K 线、具有状态记忆能力的波动率阶段转换指标:先记录压缩事件,再等待后续扩张,最后结合趋势方向与收盘位置进行确认。重点不仅是 ATR 公式,更是如何让程序跨 K 线保存事件状态,同时避免未来函数与连续重复信号。
为什么需要状态机,而不是简单的单根 K 线判断?
“ATR 较高且价格高于 EMA”只描述当前状态,无法说明行情之前是否经历过压缩。本文把流程拆成三个阶段:空闲、压缩后进入观察状态、扩张满足条件后确认。观察状态具有有效期;确认信号后又有冷却期,避免相邻多根 K 线重复出现相同提示。
这是一个用于观察和研究的指标,不会自动下单。它可以辅助图表分析,也可以作为未来独立开发策略的研究基础,但目前不涉及仓位、止损、手续费或滑点模型。
ATR 百分位排名如何避免前瞻偏差
设 A(t) 为第 t 根已收盘 K 线的 Wilder ATR(14)。当回看长度 N=100 时,只将当前 ATR 与此前 100 个 ATR 值比较,即 A(t−1) 至 A(t−100),不把当前值放入参考集合。计算公式为:百分位排名 = 100 ×(历史 ATR 小于或等于当前 ATR 的数量)/ N。并列值计入数量,保证低波动或价格刻度较粗的品种也有确定的计算结果。
当排名 ≤25% 时,程序记录压缩发生的 K 线编号。随后最多等待 20 根已收盘 K 线;如果排名达到 ≥60%,再检查方向。多头要求收盘价高于 EMA(34)、当前 EMA 高于上一根 EMA,并且收盘位置 (Close−Low)/(High−Low) ≥0.70。空头要求收盘价低于 EMA、EMA 向下且收盘位置 ≤0.30。最高价等于最低价的 K 线被忽略,避免除零错误。
可复现的数字示例
假设过去 100 个 ATR 数值中,有 21 个小于或等于当前 ATR 1.20,则排名为 21%,第 240 根 K 线触发压缩并进入观察状态。到了第 246 根,过去 100 个 ATR 中有 67 个小于或等于当前 ATR 1.65,排名变为 67%,满足扩张条件。再假设该 K 线收盘价 102.8、最低 101.8、最高 103.0,收盘位置为 (102.8−101.8)/(103.0−101.8)=0.833。如果当前 EMA(34)=102.1、上一根 EMA=102.0,则满足多头确认,在最低价下方两个 Tick 绘制绿点。如果 EMA 没有上升,即使 ATR 扩张也不会显示多头信号。这些数字仅为假设示例,不代表真实回测结果。

参数及其影响
| 参数 | 默认值 | 作用 |
|---|---|---|
| ATR Period | 14 | 真实波幅的平滑周期 |
| Rank Lookback | 100 | 不包含当前 K 线的历史排名窗口 |
| Compression / Expansion | 25 / 60 | 压缩触发和扩张确认阈值 |
| Arming Bars / Cooldown | 20 / 8 | 观察有效期和信号冷却间隔 |
| Trend EMA | 34 | 趋势方向与斜率过滤 |
排名窗口越长,对波动结构变化的适应速度通常越慢;提高扩张阈值会减少信号,但也可能错过较早的扩张阶段。缩短观察窗口,则要求压缩与扩张更快衔接。不要把这些默认值当作所有品种的最佳设置,应当在不同市场、周期和样本外数据中验证。
完整 NinjaScript C# 指标源码
在 NinjaTrader 8 中创建名为 PSVolatilityRegimeTransition 的新指标,将模板代码完整替换为下面的程序。程序在 OnStateChange 生命周期中设置参数,在 State.DataLoaded 初始化 ATR 和 EMA,并以 Calculate.OnBarClose 在每根 K 线收盘后计算。两个 Plot 分别绘制多头和空头信号;没有信号时写入 double.NaN,避免把点连成连续曲线。
// NT8 closed-bar volatility compression/expansion state machine
// Indicator: PSVolatilityRegimeTransition
#region Using declarations
using System;
using System.ComponentModel;
using System.ComponentModel.DataAnnotations;
using System.Windows.Media;
using NinjaTrader.NinjaScript;
using NinjaTrader.NinjaScript.Indicators;
using NinjaTrader.Gui.Chart;
#endregion
namespace NinjaTrader.NinjaScript.Indicators
{
public class PSVolatilityRegimeTransition : Indicator
{
private ATR atr;
private EMA ema;
private int armedBar = -1;
private int lastSignalBar = -100000;
[NinjaScriptProperty]
[Range(2, 100)]
[Display(Name = "ATR Period", Order = 1, GroupName = "Parameters")]
public int AtrPeriod { get; set; }
[NinjaScriptProperty]
[Range(20, 500)]
[Display(Name = "Rank Lookback", Order = 2, GroupName = "Parameters")]
public int RankLookback { get; set; }
[NinjaScriptProperty]
[Range(1, 100)]
[Display(Name = "Compression Percentile", Order = 3, GroupName = "Parameters")]
public int CompressionPercentile { get; set; }
[NinjaScriptProperty]
[Range(1, 100)]
[Display(Name = "Expansion Percentile", Order = 4, GroupName = "Parameters")]
public int ExpansionPercentile { get; set; }
[NinjaScriptProperty]
[Range(1, 100)]
[Display(Name = "Arming Bars", Order = 5, GroupName = "Parameters")]
public int ArmingBars { get; set; }
[NinjaScriptProperty]
[Range(1, 100)]
[Display(Name = "Cooldown Bars", Order = 6, GroupName = "Parameters")]
public int CooldownBars { get; set; }
[NinjaScriptProperty]
[Range(2, 200)]
[Display(Name = "Trend EMA", Order = 7, GroupName = "Parameters")]
public int TrendEma { get; set; }
protected override void OnStateChange()
{
if (State == State.SetDefaults)
{
Description = "Closed-bar ATR percentile compression-to-expansion detector.";
Name = "PSVolatilityRegimeTransition";
Calculate = Calculate.OnBarClose;
IsOverlay = true;
IsSuspendedWhileInactive = true;
AtrPeriod = 14;
RankLookback = 100;
CompressionPercentile = 25;
ExpansionPercentile = 60;
ArmingBars = 20;
CooldownBars = 8;
TrendEma = 34;
AddPlot(Brushes.LimeGreen, PlotStyle.Dot, "BullSignal");
AddPlot(Brushes.IndianRed, PlotStyle.Dot, "BearSignal");
}
else if (State == State.DataLoaded)
{
atr = ATR(AtrPeriod);
ema = EMA(TrendEma);
}
}
protected override void OnBarUpdate()
{
Values[0][0] = double.NaN;
Values[1][0] = double.NaN;
int warmup = Math.Max(RankLookback + AtrPeriod + 1, TrendEma + 2);
if (CurrentBar < warmup || High[0] <= Low[0])
return;
// Compare today's ATR against PREVIOUS RankLookback ATR values.
// Ties count as lower-or-equal, making the percentile deterministic.
double currentAtr = atr[0];
if (currentAtr <= 0)
return;
int lessOrEqual = 0;
for (int i = 1; i <= RankLookback; i++)
if (atr[i] <= currentAtr)
lessOrEqual++;
double percentile = 100.0 * lessOrEqual / RankLookback;
// A compression bar arms a finite-lived watch window.
if (percentile <= CompressionPercentile)
armedBar = CurrentBar;
if (armedBar < 0)
return;
if (CurrentBar - armedBar > ArmingBars)
{
armedBar = -1;
return;
}
// Never trigger on the same compression bar.
if (CurrentBar == armedBar || percentile < ExpansionPercentile)
return;
if (CurrentBar - lastSignalBar < CooldownBars)
return;
double closeLocation = (Close[0] - Low[0]) / (High[0] - Low[0]);
bool bull = Close[0] > ema[0] && ema[0] > ema[1]
&& closeLocation >= 0.70;
bool bear = Close[0] < ema[0] && ema[0] < ema[1]
&& closeLocation <= 0.30;
if (bull)
Values[0][0] = Low[0] - TickSize * 2;
else if (bear)
Values[1][0] = High[0] + TickSize * 2;
else
return;
lastSignalBar = CurrentBar;
armedBar = -1;
}
}
}
安装、检查和验证步骤
- 打开 NinjaTrader 8 → New → NinjaScript Editor,在 Indicators 上新建同名指标。
- 替换完整代码,在编辑器内编译,然后添加到具有足够历史 K 线的图表。
- 先选择流动性较好的品种和固定 K 线类型,分别比较 5 分钟和 15 分钟图,不要假设参数可以直接跨周期复用。
- 抽查历史 K 线,人工验证 ATR 百分位计数、压缩是否先于扩张、EMA 斜率以及收盘位置。
- 确认零波幅 K 线没有信号,压缩当根不会立即确认,20 根有效期和 8 根冷却期均正确执行,重新加载图表后结果可解释。
实际使用时容易忽略的边界条件
排名分布变化:波动率结构突然变化后,ATR 排名可能持续偏高。收盘确认延迟:只有 K 线结束才会显示信号,快速行情可能已经运行了一段。K 线类型差异:时间、Tick 和 Range 图的 ATR 分布并不相同。预热要求:历史数据不足时程序会主动跳过。状态重建:重新加载图表会根据现有历史重新计算;如果加载的历史长度不同,最早期信号也可能不同。交易执行差异:指标圆点不是可成交价格,点差、滑点、交易时段和风控仍需独立评估。
本示例尚未在真实 NinjaTrader 环境中完成编译和实盘测试,使用前应自行检查 API 兼容性并编译验证。研究时应固定参数,比较样本外表现,记录误报和漏报,避免仅根据漂亮的历史图形优化参数。任何技术信号都不能保证盈利。
如果你对这个免费指标感兴趣,希望增加交易时段过滤、报警或策略集成功能,欢迎通过我们的 交易软件定制开发服务 讨论具体需求。