六玛三价 API 接口文档（MT5-EX5 二次开发版）

本文档对应 2025-12-30 发布的“六玛三价API.ex5”开发版指标（编译后文件：SixSigma三价API.ex5）。

指标已将 79 条缓冲区全部开放。用户可在自己的 EA/脚本/指标中 直接读取缓冲区 进行二次开发。

一、缓冲区速查表（79 条，按索引 0~78）

二、输入参数

三、枚举定义

enum BOOL {是=1,否=0};
enum SIGMACLASS {１σ=1,２σ=2,３σ=3,４σ=4,５σ=5};
enum ENUM_MA_CLASS {１简单平均（SMA）=0,２指数平均（EMA）=1,３光滑平均（SMMA）=2,４加权平均（LWMA）=3,５离差均线（DEA）=4,６多空均线（Diff）=5};//,７自适均线（AMA）=6};
enum ENUM_BANDCLASS {分数堆积=0,倍数堆积=1};
enum PRICECLASS {CLOSE=1,OPEN=2,HIGH=3,LOW=4};
enum ENUM_VCP_VIEW_MODE {孤岛模式=0,矩形模式=1,终态模式=2,原生模式=3};
//常见率:指特定走势形态出现的频次占所有形态总频次的比例，体现该形态出现的普遍性。
//延续率:指走势形态出现后，其趋势得以延续的概率，反映该形态对后续走势的引导性。
//显著度:是延续率与常见率的比值，综合体现走势形态的重要性和可靠性。
enum ENUM_PERCENT_MODE {常见率=0,延续率=1,显著度=3};
enum ENUM_FIRSTBS_AT_STEP {启动阶段=1,加速阶段=2,衰竭阶段=3,恐慌阶段=4};
enum ENUM_MARKOV_MX {一阶矩阵=1,二阶矩阵=2,三阶矩阵=3,综合矩阵=4};

四、关键信号详解与引用缓冲区示例

1. 三价封闭信号（最常用）

MQL5 示例：EA 开仓过滤（引用缓冲区）

// 假设指标已加载到图表
int handle = iCustom(_Symbol, PERIOD_CURRENT, "SixSigma_VCP.ex5", 0, 0, 0, 0, 0, 0, 0, 0, "API_202512"); 
if(handle == INVALID_HANDLE) return;

// 获取当前K线索引
int currentBarIndex = 0; // 0 是最新K线

// 从句柄读取缓冲区数据
double priceClosureBuffer[], costClosureBuffer[];
CopyBuffer(handle, 23, currentBarIndex, 1, priceClosureBuffer); // 读取台阶封闭标志
CopyBuffer(handle, 24, currentBarIndex, 1, costClosureBuffer); // 读取中枢封闭标志

// 获取当前值
double currentPriceFlag = priceClosureBuffer[0];
double currentCostFlag = costClosureBuffer[0];

// 只做“中枢向上封闭”后的多单，且台阶未向下封闭
if(currentCostFlag == 1 && currentPriceFlag != -1) {
    // 执行开多逻辑
    // ...
}
// 记得在程序结束或不需要时释放句柄
// IndicatorRelease(handle);

2. 移动序数（量化“位移了几次”）

示例：动态止损（引用缓冲区）

// ... (获取句柄 handle 和 currentBarIndex 如上)
double priceTurningBuffer[], stepDownBuffer[];
CopyBuffer(handle, 29, currentBarIndex, 1, priceTurningBuffer); // 读取台阶移动序数
CopyBuffer(handle, 2, currentBarIndex, 1, stepDownBuffer); // 读取台阶下沿

double currentStepCount = priceTurningBuffer[0];
double currentStepBottom = stepDownBuffer[0];

double stepOffset = 50 * _Point;
// 如果台阶移动到加速阶段（假设为+2），则将止损设在台阶下沿下方一定距离
if(currentStepCount == 2) { 
    double newStopLoss = currentStepBottom - stepOffset;
    // 应用止损逻辑
    // ...
}

3. 九种形态（ 索引 57）

示例：只做“一买”与“即将反弹”（引用缓冲区）

// ... (获取句柄 handle 和 currentBarIndex 如上)
double stateBuffer[];
CopyBuffer(handle, 57, currentBarIndex, 1, stateBuffer); // 读取形态编码

int currentState = (int)stateBuffer[0];

// 如果形态是“一买建构”或“即将反弹”，则允许做多
if(currentState == 1 || currentState == 6) {
    // 执行开多逻辑
    // ...
}

4. 封闭倒计时（以K线数为单位）（引用缓冲区）

// ... (获取句柄 handle 和 currentBarIndex 如上)
double costUpTimeBuffer[], costDnTimeBuffer[];
CopyBuffer(handle, 16, currentBarIndex, 1, costUpTimeBuffer); // 读取上新中枢预计K线数
CopyBuffer(handle, 17, currentBarIndex, 1, costDnTimeBuffer); // 读取下新中枢预计K线数

int upK = (int)costUpTimeBuffer[0];
int dnK = (int)costDnTimeBuffer[0];
if(upK >= 0 && dnK >= 0) { // 检查是否有效预测
    int minLeft = MathMin(upK, dnK) * PeriodSeconds(PERIOD_CURRENT) / 60; // 转换为分钟
    Print("中枢预计", minLeft, "分钟后（或", MathMin(upK, dnK), "根K线后）封闭");
} else {
    Print("中枢封闭时间无法预测");
}

五、常见二次开发场景速查

六、性能与注意事项

1. 缓冲区 79 条全部常驻内存，每根 K 线一次计算，复杂度 O(n)。
2. PeriodN 默认 21，越大越代表走势级别越大；
3. 使用 iCustom 或 CopyBuffer 引用缓冲区时，确保指标文件名和参数与API_ID_STRING一致，避免数据冲突。
4. 读取缓冲区时，注意区分实时更新（每根K线）和事件触发（仅在特定条件下更新）的数据。

七、版本记录

如需进一步帮助，请参考 MetaTrader 5 的 MQL5 文档，特别是 iCustom 和 CopyBuffer 函数的使用。