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 扩张也不会显示多头信号。这些数字仅为假设示例,不代表真实回测结果。

NinjaTrader 8 ATR 百分位波动率阶段转换与 EMA 趋势确认
图 1:把压缩、等待和扩张确认拆成独立阶段。示意图不代表历史市场数据。

参数及其影响

参数 默认值 作用
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;
        }
    }
}

安装、检查和验证步骤

  1. 打开 NinjaTrader 8 → New → NinjaScript Editor,在 Indicators 上新建同名指标。
  2. 替换完整代码,在编辑器内编译,然后添加到具有足够历史 K 线的图表。
  3. 先选择流动性较好的品种和固定 K 线类型,分别比较 5 分钟和 15 分钟图,不要假设参数可以直接跨周期复用。
  4. 抽查历史 K 线,人工验证 ATR 百分位计数、压缩是否先于扩张、EMA 斜率以及收盘位置。
  5. 确认零波幅 K 线没有信号,压缩当根不会立即确认,20 根有效期和 8 根冷却期均正确执行,重新加载图表后结果可解释。

实际使用时容易忽略的边界条件

排名分布变化:波动率结构突然变化后,ATR 排名可能持续偏高。收盘确认延迟:只有 K 线结束才会显示信号,快速行情可能已经运行了一段。K 线类型差异:时间、Tick 和 Range 图的 ATR 分布并不相同。预热要求:历史数据不足时程序会主动跳过。状态重建:重新加载图表会根据现有历史重新计算;如果加载的历史长度不同,最早期信号也可能不同。交易执行差异:指标圆点不是可成交价格,点差、滑点、交易时段和风控仍需独立评估。

本示例尚未在真实 NinjaTrader 环境中完成编译和实盘测试,使用前应自行检查 API 兼容性并编译验证。研究时应固定参数,比较样本外表现,记录误报和漏报,避免仅根据漂亮的历史图形优化参数。任何技术信号都不能保证盈利。

如果你对这个免费指标感兴趣,希望增加交易时段过滤、报警或策略集成功能,欢迎通过我们的 交易软件定制开发服务 讨论具体需求。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

这个站点使用 Akismet 来减少垃圾评论。了解你的评论数据如何被处理。