PATTERNSMART / cTRADER AUTOMATE / 免费 C# 指标源码

cTrader 收盘确认 FVG 指标:使用 ATR 过滤三根 K 线价格缺口的 C# 源码

难度:交易技巧 | 平台:cTrader Automate | 程序类型:叠加式指标 | 案例为示意数据,不代表真实历史行情

三根 K 线的价格缺口在历史图表上容易辨认,真正困难的却是程序实现:第三根 K 线何时才算确认?多宽的缺口值得记录?怎样避免图表上的未完成 K 线造成事后消失的信号?本文以一套完整的 cTrader Automate C# 指标,将这三个问题连接成可以逐项核对的检测流程。程序只画研究区域,不下单、不管理仓位,也不暗示价格必然回补。

首先分清:FVG 不是交易所意义上的跳空

Fair Value Gap(FVG)在此采用常见的三根 K 线定义:把第一根记为 A,中间一根记为 B,第三根记为 C。若 C 的最低价严格高于 A 的最高价,则出现看涨候选区间;若 C 的最高价严格低于 A 的最低价,则出现看跌候选区间。两者之间的 B 可能已经交易过相关价位,因此 FVG 表示分析框架下的三根 K 线不平衡形态,而不是证明市场在该区域完全没有成交。

尤其要注意 C 的生命周期:未收盘时的最低价或最高价仍会变化。某个看涨缺口在盘中暂时成立,但若 C 随后跌回 A 的区间,它就会消失。把这种临时状态当作已确认信号,会使复盘与实时观察不一致。本文采用只对已完成的 C 进行检测的规则,并绘制长度受限的静态区域,便于验证。

判断顺序:几何关系 → 点数门槛 → ATR 门槛

看涨缺口宽度 = Low(C) − High(A);看跌缺口宽度 = Low(A) − High(C)。候选宽度必须严格大于零,并同时达到固定 pip 门槛及波动率门槛。源码中的等价形式是:minimumWidth = max(MinimumGapPips × Symbol.PipSize, MinimumAtrRatio × ATR)。此外,可选择要求中间 K 线 B 与缺口方向一致:看涨时 B 收阳,看跌时 B 收阴;十字星不符合任何方向。ATR 读取已确认 C 的指标数值,而不是未来一根数据。

三根K线FVG示意:A最高价1.2040、C最低价1.2049,9 pip缺口,相当于0.75 ATR,同时通过绝对及ATR双重阈值
图 1|EURUSD 假设示意:9 pip 的价格缺口通过固定点数与 ATR 双重过滤。本图不是下载的历史市场数据,也不是获利策略回测。
可复算示例:假设 EURUSD 的 PipSize = 0.0001,A 的最高价为 1.2040,已经收盘的 C 最低价为 1.2049。看涨缺口宽度 = 0.0009 = 9 pips。若 ATR(14) = 0.0012,即 12 pips,则缺口的标准化宽度为 9 ÷ 12 = 0.75 ATR。默认 MinimumGapPips=4、MinimumAtrRatio=0.40,要求宽度为 max(4, 12×0.40)=4.8 pips。9 pips 达标;若启用 B 方向过滤,还须 B 收阳才能画出看涨区。

对照两个拒绝情形:若缺口只有 3 pips 而 ATR 为 12 pips,先被 4-pip 下限排除;若缺口为 9 pips,但 ATR 达 30 pips,虽然固定门槛通过,标准化宽度仅为 0.30 ATR,低于 0.40,也会被排除。这说明两个门槛回答的是不同问题:其一是“对这个交易品种而言是否够大”,其二是“与近期行情波动相比是否足够明显”。两者都不等于交易进场建议。

为何需要明确的已收盘 K 线游标

在 cTrader 中,指标的 Calculate(int index) 会处理历史数据,也可能随着最新 K 线变化而多次调用。源码不直接把当前 index 认作“收盘 C”,而是计算 lastClosed = Math.Min(index, Bars.Count - 2),确保不会把最后一根尚在形成的 K 线交给检测流程。内部变量 _lastProcessedClosedBar 记录最近处理过的收盘序号;只有新的已完成 K 线出现,才继续调用检测函数。

历史加载时使用循环检查符合条件的已收盘 K 线,实时阶段每根确认 K 线也只检查一次,避免因为盘中反复刷新而重复绘制同一个 FVG。注意,这属于基于当前历史数据的可重复检测逻辑;若数据源后来修订历史 K 线、增补旧历史或重新加载整个指标,图形仍可能重建,不能把它误解成对所有行情数据修订的绝对不重绘保证。

每个有效区域采用方向和 C 的开盘时间构成对象名称;矩形从 A 所在位置开始,向 C 之后延伸指定的 K 线数量。程序使用队列保存自己创建的图形名称,超过 MaximumZones 时删除最早一个。它不会主动删除用户手工绘制的无关对象,也不会保存永久事件数据库。区域向右延伸只是便于观察,不代表价格目标、止损位或预言未来。

完整 cTrader Automate C# 指标源码

在 cTrader Algo 中新建 Indicator(指标),命名为 PSConfirmedFvgAtrZones,将下方整个程序粘贴进项目并编译。源码使用 cTrader 的 Indicator.Calculate、Indicators.AverageTrueRange、Chart.DrawRectangle 与 Chart.RemoveObject 接口;不是 cBot,不会发出任何交易指令。

// cTrader Automate C# indicator: PS Confirmed FVG / ATR Zones
// Visual research tool. It never submits orders.
using System;
using System.Collections.Generic;
using cAlgo.API;
using cAlgo.API.Indicators;

namespace cAlgo.Indicators
{
    [Indicator(IsOverlay = true, TimeZone = TimeZones.UTC,
        AccessRights = AccessRights.None)]
    public class PSConfirmedFvgAtrZones : Indicator
    {
        [Parameter("ATR Period", DefaultValue = 14, MinValue = 2)]
        public int AtrPeriod { get; set; }

        [Parameter("Minimum Gap (pips)", DefaultValue = 4.0,
            MinValue = 0.1, Step = 0.1)]
        public double MinimumGapPips { get; set; }

        [Parameter("Minimum Gap / ATR", DefaultValue = 0.40,
            MinValue = 0.0, Step = 0.05)]
        public double MinimumAtrRatio { get; set; }

        [Parameter("Require Middle Candle Direction", DefaultValue = true)]
        public bool RequireMiddleDirection { get; set; }

        [Parameter("Extend Zone (bars)", DefaultValue = 8,
            MinValue = 1, MaxValue = 100)]
        public int ExtendBars { get; set; }

        [Parameter("Maximum Drawn Zones", DefaultValue = 60,
            MinValue = 1, MaxValue = 500)]
        public int MaximumZones { get; set; }

        private AverageTrueRange _atr;
        private int _lastProcessedClosedBar = -1;
        private readonly Queue<string> _objectNames = new Queue<string>();

        protected override void Initialize()
        {
            _atr = Indicators.AverageTrueRange(
                AtrPeriod, MovingAverageType.Exponential);
        }

        public override void Calculate(int index)
        {
            // Calculate can be called many times for the forming bar.
            // Evaluate the last completed bar, never the forming bar.
            int lastClosed = Math.Min(index, Bars.Count - 2);
            if (lastClosed <= _lastProcessedClosedBar)
                return;

            int first = Math.Max(_lastProcessedClosedBar + 1,
                AtrPeriod + 2);
            for (int k = first; k <= lastClosed; k++)
                DetectAtClosedBar(k);

            _lastProcessedClosedBar = lastClosed;
        }

        private void DetectAtClosedBar(int k)
        {
            double atr = _atr.Result[k];
            if (double.IsNaN(atr) || atr <= 0.0)
                return;

            // A = k-2, B = k-1, C = k (now fully closed).
            double aHigh = Bars.HighPrices[k - 2];
            double aLow = Bars.LowPrices[k - 2];
            double cHigh = Bars.HighPrices[k];
            double cLow = Bars.LowPrices[k];

            double minimumWidth = Math.Max(
                MinimumGapPips * Symbol.PipSize,
                MinimumAtrRatio * atr);

            double bullishWidth = cLow - aHigh;
            double bearishWidth = aLow - cHigh;

            bool middleBullish = Bars.ClosePrices[k - 1] >
                                 Bars.OpenPrices[k - 1];
            bool middleBearish = Bars.ClosePrices[k - 1] <
                                 Bars.OpenPrices[k - 1];

            // First test geometric separation; then size and direction.
            bool bull = bullishWidth > 0.0 &&
                        bullishWidth >= minimumWidth &&
                        (!RequireMiddleDirection || middleBullish);
            bool bear = bearishWidth > 0.0 &&
                        bearishWidth >= minimumWidth &&
                        (!RequireMiddleDirection || middleBearish);

            if (!bull && !bear)
                return;

            // Bull gap: A high..C low. Bear gap: C high..A low.
            double lower = bull ? aHigh : cHigh;
            double upper = bull ? cLow : aLow;
            string name = "PS_FVG_" + (bull ? "B_" : "S_") +
                          Bars.OpenTimes[k].Ticks;
            Color zoneColor = Color.FromArgb(
                60, bull ? Color.Green : Color.Red);

            var rectangle = Chart.DrawRectangle(
                name, k - 2, lower, k + ExtendBars, upper, zoneColor);
            rectangle.IsFilled = true;
            rectangle.IsInteractive = false;

            // Bound chart-object count; do not delete objects we do not own.
            _objectNames.Enqueue(name);
            while (_objectNames.Count > MaximumZones)
                Chart.RemoveObject(_objectNames.Dequeue());
        }
    }
}

参数选择与研究取舍

参数 默认值 作用与权衡
ATR Period 14 更短的周期适应波动变化较快,但计算结果也更加敏感;必须有足够数据供 ATR 初始化。
Minimum Gap (pips) 4.0 以品种实际 PipSize 转换为价格距离,避免极小的价差也被误识别。
Minimum Gap / ATR 0.40 要求缺口相对平均真实波幅达到一定比例;提高门槛通常会减少候选数量。
Require Middle Candle Direction true 看涨 FVG 要求 B 收阳;看跌 FVG 要求 B 收阴;十字星不通过。
Extend Zone (bars) 8 控制矩形向右绘制多少根 K 线;不是持仓时间或目标预测。
Maximum Drawn Zones 60 限制指标对象数量,超出上限删除最早生成的区域,以维持图表整洁。

安装、使用与检查步骤

  1. 打开 cTrader Algo,新建 C# Indicator,把完整源码替换默认模板并执行 Build;根据本机安装版本确认相关 API 可用。
  2. 把该指标附加到普通蜡烛图,初始使用默认参数,并加载足够历史 K 线确保 ATR 有效。
  3. 选取连续三根蜡烛,记录 A 的最高价和最低价、B 的开收方向,以及 C 的最高价和最低价;先用 Symbol.PipSize 手动算出缺口。
  4. 把缺口与 ATR 的比值逐项对照门槛;检查只出现对应的看涨或看跌矩形。切换 B 方向过滤,观察候选区域如何变化。
  5. 在实时图表中观察未完成 C 的高低价变化:确认期间不应产生一个后来凭空消失的已确认区域;等新 K 线开始再验证前一根的结果。
  6. 将 MaximumZones 暂时改小,确认旧的指标矩形逐一清理,而其他手工图形仍在。

常见误区:这个指标没有证明什么

重要限制:三根 K 线的不平衡区间可能在随后震荡中被反复触及或全部穿越。本教学指标不追踪回补、局部成交、区域失效、交易时段、点差、手续费、趋势过滤或真实成交模型。固定长度的矩形只是历史识别结果的可视化,并不意味着自动交易信号。

两项代码细节值得特别核对。第一,ATR 的单位为价格,而 MinimumGapPips 的单位为 pip;源码通过 Symbol.PipSize 转换,不能把 EURUSD 例子中的 0.0001 套用到所有外汇、指数或差价合约。第二,历史和实时数据在服务器补历史、数据供应商修正或某些交易品种报价规则变化时可能出现差异;这并不是仅靠“等待 C 收盘”就能消除的。

MaximumZones 只保护图表对象数量,并不等于记录了全部合格 FVG。如需要永久保存研究数据,应该额外记录时间戳、品种、图表周期、缺口边界、ATR 值与参数版本;如果将来扩展成自动策略,还必须明确进场规则、区域失效条件、止损、仓位规模、滑点、执行模型与最大允许回撤。

发布或依赖信号前的验证清单

  • 手动复算看涨、看跌 FVG 的几何条件,尤其确认 A 与 C 的边界相等时不应产生零宽度缺口。
  • 分别检验 4 pip 固定下限、0.40 ATR 相对下限及 B 的阴阳方向条件,勿只检查其中一个门槛。
  • 观察实时未收盘 C 的最高价与最低价变化,确认它不会产生或删除“已收盘确认”区域。
  • 测试历史数据不足、ATR 无效或波动极低、短暂断线、不同 PipSize 以及短时间连续出现多个缺口的情况。
  • 跨多个时间周期重复测试,确认指标仅使用当前图表周期的已收盘价格,不引用未来数据。
  • 在实际安装的 cTrader 版本上完成编译,检查平台警告、对象名称冲突和超出 MaximumZones 时的矩形清理。

如果你对这套免费 FVG 指标或检测思路感兴趣,希望根据自己的需要扩展提醒、持久化记录或与策略结合,欢迎通过 交易软件定制开发服务 联系我们,讨论具体的定制与修改需求。

风险声明:此代码是教学研究示例,尚未在你的特定 cTrader 版本上完成编译或前瞻测试。请自行编译、检查参数单位、在模拟环境中观察与复算。FVG 和波动率过滤不能保证任何走势或盈利;尤其在杠杆市场中,亏损可能很大。切勿只凭未经验证的图形指标决定实盘仓位。

发表回复

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

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