vortex

类别:趋势强度 · 复合指标 · 关键词:vortex, VI, 涡旋指标, VI+, VI-, 趋势运动, 正负趋势

返回说明

需要解读说明时，使用 POST /api/indicators?explain=true，读取 indicators[响应key].explain。指标数值位于同一对象的 columns 和 data 中。

涡旋指标，VI+/VI-衡量正负趋势运动，交叉产生趋势方向信号

参数

参数	类型	默认值
period	int	14

输出列

列名	含义
vim	VI-，负趋势指标
vip	VI+，正趋势指标

特征信号

在计算请求顶层设置 signals: true，读取 indicators[响应key].signals。默认仅在收盘后判断。true 表示事件发生或状态成立，false 表示可判断但不成立，null 表示不可判断。这些不是买卖指令。

本指标支持 include_forming: true：将末根当前 OHLCV 作为完整样本按下表原规则试算，仍输出同一份数值、特征与对象。信号表末尾增加 bar_status 列：closed 为收盘计算，forming 为盘中试算，后者 confirmed_at_ms=null，特征可在后续更新或收盘时消失。BYO 末根形成中仍需设置 last_bar_closed: false。下表及附注中的收盘要求描述默认模式；试算只放开末根参与资格，不缩短结构窗口或降低模型确认条件。盘中试算用法。

下表历史长度为最低判断要求，不保证平滑值已完全收敛。前后比较使用未舍入数值；阈值恰好相等时按表中边界处理。输入缺口、依赖值无效或默认模式下未收盘时不要把 null 转为 false。

特征列	类型	判断逻辑	代表含义	所需历史 / 有效条件
vortex.cross_up	event	前根 vip <= vim，本根 vip > vim。	正向与负向涡旋强度的相对优势发生交叉。	period + 2 根连续输入且前后依赖值有效
vortex.cross_down	event	前根 vip >= vim，本根 vip < vim。	正向与负向涡旋强度的相对优势发生交叉。	period + 2 根连续输入且前后依赖值有效

格式与示例见特征调用说明。/api/chart 同样可设置 signals: true，默认只标记已确认事件；开启 include_forming 后盘中事件也可生成标记，并带 bar_status=forming，状态不逐根绘制。参见信号绘图。

注意事项

交叉信号类似均线系统，可能在震荡行情中频繁翻转

调用示例

curl -X POST -H "Authorization: Bearer mq_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "exchange": "binance",
    "market":   "perp",
    "symbol":   "BTCUSDT",
    "interval": "5m",
    "limit":    100,
    "signals":  true,
    "calc":     [{"name": "vortex", "params": {"period": 14}}]
  }' \
  https://api.mobiusquant.ai/api/indicators

同类指标

adx · aroon_oscillator · choppiness_index