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 的指标数值,而不是未来一根数据。
对照两个拒绝情形:若缺口只有 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 | 限制指标对象数量,超出上限删除最早生成的区域,以维持图表整洁。 |
安装、使用与检查步骤
- 打开 cTrader Algo,新建 C# Indicator,把完整源码替换默认模板并执行 Build;根据本机安装版本确认相关 API 可用。
- 把该指标附加到普通蜡烛图,初始使用默认参数,并加载足够历史 K 线确保 ATR 有效。
- 选取连续三根蜡烛,记录 A 的最高价和最低价、B 的开收方向,以及 C 的最高价和最低价;先用 Symbol.PipSize 手动算出缺口。
- 把缺口与 ATR 的比值逐项对照门槛;检查只出现对应的看涨或看跌矩形。切换 B 方向过滤,观察候选区域如何变化。
- 在实时图表中观察未完成 C 的高低价变化:确认期间不应产生一个后来凭空消失的已确认区域;等新 K 线开始再验证前一根的结果。
- 将 MaximumZones 暂时改小,确认旧的指标矩形逐一清理,而其他手工图形仍在。
常见误区:这个指标没有证明什么
两项代码细节值得特别核对。第一,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 和波动率过滤不能保证任何走势或盈利;尤其在杠杆市场中,亏损可能很大。切勿只凭未经验证的图形指标决定实盘仓位。