Orderflow Footprint

Asa Orderflow Footprint v3 — 产品说明书

概述

Asa Orderflow Footprint 是一款专为 MetaTrader 5 开发的专业级订单流脚印图（Footprint）指标。它可以在每个 K 线内部的每个价格水平上实时渲染 Bid/Ask（买设价/卖设价）量（或 Tick 计数）。该指标专为严肃的订单流交易者打造，远远超越了基础的脚印图功能，集成了 POC 迁移分析、一目了然的订单流仪表盘、堆叠不平衡检测、吸收标记以及未缓解的控制点（Naked POC）线条——所有这些功能均在主图窗口内呈现，无需占用副图窗口。

该指标针对黄金（XAUUSD）数据源进行了深度设计与测试。在提供主动攻击方（Aggressor）数据的行情源上，指标使用基于标志的 Tick 分类引擎来区分买方主导和卖方主导的交易活动；在不提供该数据的行情源上，则会自动平稳切换至纯粹的价格量能（Volume-by-Price）分析（参见注意事项）。

核心功能

📊 脚印图表（每格显示 Bid | Ask）
- 在每根 K 线内部的每个价格区间并排显示卖方量（Bid）和买方量（Ask）。
- 单元格大小可通过图表上的 < / > 按钮自由调节，无需重新打开设置窗口。
- 支持在 Tick 计数模式（传统模式）或真实交易量模式（Real Volume，若无则自动降级采用常规 Volume）之间进行选择。
- 固定网格价格区间：在当前未收盘 K 线更新时，单元格绝不会发生移位。
- 每根 K 线的控制点（POC）会自动高亮显示。

🧭 POC 迁移分析（全新功能）
- 追踪每根 K 线的 POC 评估较前序 K 线的漂移路径——这是洞察“价值”实际移动方向最清晰的方式。
- 支持跨三个可配置的回溯窗口（例如：3 / 5 / 15 根 K 线）进行测量。
- 瞬间揭示健康的趋势（POC 阶梯式上升/下降）、停滞（POC 趋于平缓）或背离（价格创出新高/新低，但 POC 未能跟随）。
- 适用于任何行情源——基于价格量能计算，不依赖 Delta 数据。

📋 智能仪表盘（全新功能）
- 一体化直观面板，提炼出完整的订单流核心：一眼即可看清方向、动能和关键水平。
- 多空偏向标题（Bias headline）——由短期权重的 POC 迁移（权重可配置）驱动的整体方向，通过颜色编码显示为 UP（上涨）/ DOWN（下跌）/ RANGE（震荡）。
- 动能计量器（Conviction meter）——分为 strong（强）/ medium（中）/ thin（弱），由相对交易量驱动，让您明确行情移动背后是否有真实的资金参与。
- POC 迁移计量器——显示 3 / 5 / 15 根 K 线的窗口，可选显示模式：净步长、涨跌计数或百分比。
- POC 轨迹迷你图（Sparkline）——将最近几根 K 线的 POC 绘制为迷你轮廓图，以便一目了然地读取迁移形态。
- 未缓解 POC（Naked POC）读数——显示价格上方和下方最近的未填充 POC，带有距离显示以及价格接近时的靠近高亮提示。
- 末端 K 线特征——形态轮廓（P 型 / b 型 / 平衡型）和吸收状态（买方吸收 / 卖方吸收）。
- 内置缩放控制—— < / > 单元格大小调节按钮整洁地收纳在面板底部。
- 位置完全可移动——可将仪表盘放置在图表的任意角落，并支持自定义 X / Y 轴像素偏移；在图表缩放时会自动重新定位。

🔴🟢 不平衡与吸收检测
- 吸收 K 线（Absorption Candle）——标记出主导方 POC 发生偏斜的 K 线，在条形上方/下方带有彩色菱形标记（绿色 = 买方吸收，鲑鱼红 = 卖方吸收）。
- 堆叠对角不平衡（Stacked Diagonal Imbalance）——高亮显示 Ask 主导下方一格的 Bid（或反之）达到配置比例的连续价格水平，以独特的买入/卖出不平衡颜色标出。
- 不平衡堆叠长度和比例完全可配置（ImbRatio 比例，ImbStack 最小行数）。

📌 未缓解控制点线条（Naked POC Lines）
- 自动在每根 K 线的控制点（Bid+Ask 结合交易量最高的单元格）处绘制一条水平线。
- 线条向右延伸，并在后续 K 线的价格范围触及该价格水平时自动消失。
- 颜色、样式和宽度完全可自定义——充当价格磁铁和动态支撑/阻力位。

🎯 K 线内 POC 标记（全新功能）
- 可选标记，精准绘制在每根 K 线的 POC 价格正中心，让您一眼即可扫视整个图表上的迁移阶梯。
- 可配置字形/文本、颜色和字体大小。

📋 每根 K 线数据摘要行
- K 线下方可选的一行摘要：B: [买入] S: [卖出] T: [总量] [delta%]。
- 无需阅读单个单元格即可快速获取瞬时背景上下文。

🔔 智能警报
- 支持弹窗和/或推送通知警报，触发条件包括：
  - POC 迁移对齐——当 3 / 5 / 15 窗口方向达成一致时触发（强趋势信号）（全新功能）。
  - 检测到不平衡 / 吸收 K 线。
  - 刚刚收盘的 K 线发生 Delta 正负符号翻转（适用于提供主动攻击方数据的行情源）。
- 每根 K 线收盘时仅触发一次警报——拒绝每个 Tick 变动时的重复骚扰。

⚡ 性能优化
- 增量重绘：每个 Tick 仅重新计算正在形成的 K 线（Shift 0）；所有历史 K 线仅在条形开盘时绘制一次。
- 对象复用：图表对象采用就地更新，而非删除后重新创建，即使显示 100+ 根 K 线也能保持极低的 CPU 占用率。
- 重度计算（未缓解 POC 扫描、迁移分析）仅在 K 线收盘时运行；Tick 内部仅更新相对交易量和临近触发。

输入参数

常规设置 (Main)
- ShowFootprint — 显示/隐藏脚印图单元格文本。
- ShowSummary — 显示每根 K 线底部的 B/S/Total/Delta% 摘要行。
- TPointScale — 初始单元格大小（点数）；可通过仪表盘按钮进行实时调节。
- CountMode — 单元格数值模式：Tick 计数或真实交易量。
- OFPercent — 吸收 K 线阈值 (%)。
- CountCandle — 渲染的 K 线数量（最多 100 根）。
- FontSize — 单元格文本字体大小。
- MBidColor / MAskColor — 最大 Bid / 最大 Ask 单元格的高亮颜色。
- sameColor — 当最大 Bid 和最大 Ask 位于同一单元格时的颜色。
- NormalColor / BlankDataColor — 正常单元格和无数据空单元格的颜色。

不平衡设置 (Imbalance)
- ShowAbsorbCandle — 显示吸收 K 线的菱形标记。
- ShowImbalance — 启用堆叠对角不平衡高亮。
- ImbRatio — 触发对角不平衡的最小 Ask/Bid 比例。
- ImbStack — 区域高亮所需的最小连续不平衡单元格数量。
- ImbBuyColor / ImbSellColor — 买入/卖出不平衡区域的高亮颜色。

警报设置 (Alert)
- AlertPopup / AlertPush — 启用弹窗 / 推送通知警报。
- AlertOnImb / AlertOnFlip — 警报触发源：不平衡 K 线 / Delta 翻转。

未缓解 POC 线条 (Naked POC lines)
- ShowPOC — 显示未缓解 POC 的延伸线条。
- POCColor / POCStyle / POCWidth — POC 线条的外观设置。

K 线内 POC 标记 (POC marker in candle)
- ShowPOCInCandle — 显示 K 线内部中心的 POC 标记。
- POCInText — 标记字形/文本。
- POCInColor — 标记颜色。
- POCInFontSize — 标记字体大小。

仪表盘设置 (Dashboard)
- ShowDashboard — 显示/隐藏订单流仪表盘。
- DashCorner — 仪表盘锚定角落（4 个角落任选）。
- DashX / DashY — 仪表盘距离角落的偏移量（像素）。
- MigMode — 迁移单元格显示模式：净步长 / 涨跌计数 / 百分比。
- MigW1 / MigW2 / MigW3 — POC 迁移回溯窗口（K 线数），默认 3 / 5 / 15。
- BiasWgt1 / BiasWgt2 / BiasWgt3 — 每个窗口的偏向权重（默认赋予短期更高权重，3 / 2 / 1）。
- RelVolPeriod — 相对交易量平均周期（K 线数）。
- RelVolStrong / RelVolMedium — 强/中等动能的相对交易量阈值。
- ProximityPts — 未缓解 POC 算作“临近”的距离（点数）。
- AlertOnAlign — 当 3 个迁移窗口全部对齐时发出警报。

使用方法

1. 将指标加载到任意图表和周期（推荐 XAUUSD M1）。
2. 使用仪表盘底部的 < > 按钮增加或减少单元格大小，直到每根 K 线显示出清晰易读的价格行数。
3. 首先阅读仪表盘：Bias 标题提供方向 + 动能；3 / 5 / 15 迁移计量器和 POC 轨迹显示趋势是健康、停滞还是背离。
4. 顺着迁移方向交易——在价格回调至前一 K 线的 POC 或守住的未缓解 POC 水平时介入；当迁移停滞/背离或出现逆趋势的吸收菱形时，注意寻找反转机会。
5. 留意 Naked POC 读数，获取价格上方/下方最近的未测试高量水平——这些是天然的目标位和反应区。
6. 关注青色高亮区域（堆叠买入不平衡）和洋红色高亮区域（堆叠卖出不平衡），它们是潜在的机构订单集群。
7. 开启警报功能，以便在迁移对齐、不平衡/吸收 K 线或 Delta 翻转时获得通知，无需时刻紧盯屏幕。

注意事项与要求

- 需要经纪商通过 `CopyTicksRange()` 提供 Tick 历史数据——MT5 上的大多数 ECN/STP 经纪商均满足此条件。
- 依赖 Delta 的功能（Delta %、Delta 翻转警报以及适用的 CVD）需要行情源能够标记 Tick 的主动攻击方（Bid/Ask）。部分账户（在某些 CFD 行情源上很常见）发送的是合并的 Bid+Ask Tick，这会导致 Delta 读取值接近 0。在这些行情源上，该指标仍可通过其价格量能、POC、POC 迁移、未缓解 POC 以及相对交易量工具完美工作，这些功能不依赖主动方数据。
- 真实交易量（Real Volume）模式要求经纪商在 Tick 数据中提供 `volume_real`；若不可用，指标会自动降级采用 Tick 交易量。
- 推荐在 M1 到 H1 周期上运行，以获得有意义的订单流细粒度。
- 在低时间周期上请保守设置 CountCandle（30-50），以保持图表对象数量在可控范围内。
- 本指标为分析工具——它不会自动下单，且没有任何指标能保证获利。请务必执行严格的风险管理。