# 指标参考

TechKit 实现了 **189 个技术指标**，与 TA-Lib 100% 兼容。

## 快速导航

| 类别 | 数量 | 描述 | 链接 |
|------|------|------|------|
| [叠加指标](overlap.md) | 17 | 移动平均、布林带、SAR | [详情](overlap.md) |
| [动量指标](momentum.md) | 30 | RSI、MACD、随机指标、ADX | [详情](momentum.md) |
| [波动率指标](volatility.md) | 3 | ATR、NATR、真实波幅 | [详情](volatility.md) |
| [成交量指标](volume.md) | 3 | OBV、A/D、ADOSC | [详情](volume.md) |
| [统计函数](statistics.md) | 9 | 回归、相关性、方差 | [详情](statistics.md) |
| [形态识别](patterns.md) | 61 | K线形态 | [详情](patterns.md) |
| [数学函数](math.md) | 26 | 算术、三角函数 | [详情](math.md) |
| [周期指标](cycle.md) | 5 | 希尔伯特变换 | [详情](cycle.md) |

## 输入类型

### 仅需收盘价
这些指标只需要收盘价：
- **移动平均**：SMA、EMA、WMA、DEMA、TEMA、KAMA、TRIMA、T3、MA、MAVP
- **动量**：RSI、MOM、ROC、ROCP、ROCR、ROCR100、APO、PPO、CMO、TRIX
- **统计**：STDDEV、VAR、LINEARREG*、TSF、BETA、CORREL
- **数学**：所有数学运算和变换
- **周期**：所有 HT_* 指标

### 需要 OHLCV
这些指标需要完整的 OHLCV K线数据：
- **波动率**：ATR、NATR、TRANGE
- **方向性运动**：ADX、ADXR、DX、PLUS_DI、MINUS_DI、PLUS_DM、MINUS_DM
- **振荡器**：CCI、WILLR、MFI、STOCH、STOCHF、ULTOSC
- **成交量**：OBV、AD、ADOSC
- **叠加**：SAR、SAREXT、MIDPRICE、BOP
- **形态**：所有 CDL* 形态函数

## 输出类型

### 单输出
大多数指标每个K线返回一个值。

### 多输出

| 指标 | 输出 | 描述 |
|------|------|------|
| MACD | macd, signal, histogram | MACD 线、信号线、柱状图 |
| MACDEXT | macd, signal, histogram | 扩展 MACD，可配置 MA 类型 |
| MACDFIX | macd, signal, histogram | 固定周期 MACD (12/26) |
| BBANDS | upper, middle, lower | 上轨、中轨（SMA）、下轨 |
| STOCH | slowk, slowd | %K 线（平滑后）、%D 线（%K 的 SMA） |
| STOCHF | fastk, fastd | 快速 %K、快速 %D |
| STOCHRSI | fastk, fastd | RSI 的随机指标 |
| ADX | plus_di, minus_di, adx | +DI、-DI、ADX |
| AROON | aroon_up, aroon_down | Aroon 上升（0-100）、Aroon 下降（0-100） |
| HT_PHASOR | inphase, quadrature | 同相和正交分量 |
| HT_SINE | sine, leadsine | 主导周期的正弦和领先正弦 |
| MINMAX | min, max | 周期内的最小值和最大值 |
| DRAWDOWN | drawdown, max_drawdown, duration, max_duration | 当前和最大回撤指标 |

## 完整指标列表

### 叠加指标 (17)

| 指标 | 函数 | 输入 | 输出 | 默认周期 | 回看期 |
|------|------|------|------|----------|--------|
| SMA | 简单移动平均 | Close | 1 | 20 | period - 1 |
| EMA | 指数移动平均 | Close | 1 | 20 | period - 1 |
| WMA | 加权移动平均 | Close | 1 | 30 | period - 1 |
| DEMA | 双重指数移动平均 | Close | 1 | 30 | 2×(period-1) |
| TEMA | 三重指数移动平均 | Close | 1 | 30 | 3×(period-1) |
| TRIMA | 三角移动平均 | Close | 1 | 30 | period - 1 |
| KAMA | 考夫曼自适应移动平均 | Close | 1 | 30 | period |
| T3 | T3 移动平均 | Close | 1 | 5 | 6×(period-1) |
| MA | 通用移动平均 | Close | 1 | 30 | varies |
| MAVP | 可变周期移动平均 | Close | 1 | - | max_period-1 |
| MAMA | MESA 自适应移动平均 | Close | 2 | - | - |
| BBANDS | 布林带 | Close | 3 | 5, 2.0 | period - 1 |
| SAR | 抛物线转向 | OHLC | 1 | 0.02, 0.20 | 1 |
| SAREXT | 扩展抛物线转向 | OHLC | 1 | - | 1 |
| MIDPOINT | 周期中点 | Close | 1 | 14 | period - 1 |
| MIDPRICE | 中点价格 | OHLC | 1 | 14 | period - 1 |
| HT_TRENDLINE | 希尔伯特趋势线 | Close | 1 | - | 63 |

### 动量指标 (30)

| 指标 | 函数 | 输入 | 输出 | 默认周期 | 回看期 |
|------|------|------|------|----------|--------|
| RSI | 相对强弱指标 | Close | 1 | 14 | period |
| MACD | MACD | Close | 3 | 12, 26, 9 | slow+signal-2 |
| MACDEXT | 扩展 MACD | Close | 3 | 12, 26, 9 | varies |
| MACDFIX | 固定 MACD | Close | 3 | 9 | 25+signal-1 |
| STOCH | 随机振荡器 | OHLC | 2 | 5, 3, 3 | k+k_slow+d-3 |
| STOCHF | 快速随机指标 | OHLC | 2 | 5, 3 | k+d-2 |
| STOCHRSI | 随机 RSI | Close | 2 | 14, 14, 3, 3 | rsi+stoch+k+d-4 |
| ADX | 平均趋向指标 | OHLC | 3 | 14 | 2×period-1 |
| ADXR | ADX 评级 | OHLC | 1 | 14 | 3×period-2 |
| DX | 方向性运动指数 | OHLC | 1 | 14 | 2×period-1 |
| PLUS_DI | 正向方向指标 | OHLC | 1 | 14 | period |
| MINUS_DI | 负向方向指标 | OHLC | 1 | 14 | period |
| PLUS_DM | 正向方向性运动 | OHLC | 1 | 14 | period |
| MINUS_DM | 负向方向性运动 | OHLC | 1 | 14 | period |
| CCI | 商品通道指标 | OHLC | 1 | 20 | period-1 |
| CMO | 钱德动量振荡器 | Close | 1 | 14 | period |
| MFI | 资金流量指标 | OHLCV | 1 | 14 | period |
| MOM | 动量 | Close | 1 | 10 | period |
| ROC | 变动率 | Close | 1 | 10 | period |
| ROCP | 变动率百分比 | Close | 1 | 10 | period |
| ROCR | 变动率比率 | Close | 1 | 10 | period |
| ROCR100 | 变动率比率 × 100 | Close | 1 | 10 | period |
| APO | 绝对价格振荡器 | Close | 1 | 12, 26 | slow-1 |
| PPO | 百分比价格振荡器 | Close | 1 | 12, 26 | slow-1 |
| TRIX | 三重指数平均 | Close | 1 | 30 | 3×(period-1) |
| ULTOSC | 终极振荡器 | OHLC | 1 | 7, 14, 28 | period3 |
| WILLR | 威廉指标 | OHLC | 1 | 14 | period-1 |
| AROON | Aroon | OHLC | 2 | 14 | period |
| AROONOSC | Aroon 振荡器 | OHLC | 1 | 14 | period |
| BOP | 多空平衡 | OHLC | 1 | - | 0 |

### 波动率指标 (3)

| 指标 | 函数 | 输入 | 输出 | 默认周期 | 回看期 |
|------|------|------|------|----------|--------|
| ATR | 平均真实波幅 | OHLC | 1 | 14 | period |
| NATR | 标准化 ATR | OHLC | 1 | 14 | period |
| TRANGE | 真实波幅 | OHLC | 1 | - | 1 |

### 成交量指标 (3)

| 指标 | 函数 | 输入 | 输出 | 默认周期 | 回看期 |
|------|------|------|------|----------|--------|
| OBV | 能量潮 | OHLCV | 1 | - | 0 |
| AD | 累积/派发 | OHLCV | 1 | - | 0 |
| ADOSC | 蔡金 A/D 振荡器 | OHLCV | 1 | 3, 10 | slow-1 |

### 统计函数 (9)

| 指标 | 函数 | 输入 | 输出 | 默认周期 | 回看期 |
|------|------|------|------|----------|--------|
| STDDEV | 标准差 | Close | 1 | 5 | period-1 |
| VAR | 方差 | Close | 1 | 5 | period-1 |
| LINEARREG | 线性回归 | Close | 1 | 14 | period-1 |
| LINEARREG_SLOPE | 线性回归斜率 | Close | 1 | 14 | period-1 |
| LINEARREG_INTERCEPT | 线性回归截距 | Close | 1 | 14 | period-1 |
| LINEARREG_ANGLE | 线性回归角度 | Close | 1 | 14 | period-1 |
| TSF | 时间序列预测 | Close | 1 | 14 | period-1 |
| BETA | 贝塔系数 | Close×2 | 1 | 5 | period-1 |
| CORREL | 皮尔逊相关系数 | Close×2 | 1 | 30 | period-1 |

### 形态识别 (61)

所有形态函数返回：
- `+100`：检测到看涨形态
- `-100`：检测到看跌形态
- `0`：无形态

| 形态 | 函数 | 类型 | 回看期 |
|------|------|------|--------|
| 十字星 | CDL_DOJI | 中性 | 0 |
| 蜻蜓十字星 | CDL_DRAGONFLYDOJI | 看涨 | 0 |
| 墓碑十字星 | CDL_GRAVESTONEDOJI | 看跌 | 0 |
| 长腿十字星 | CDL_LONGLEGGEDDOJI | 中性 | 0 |
| 锤子线 | CDL_HAMMER | 看涨 | 0 |
| 倒锤子线 | CDL_INVERTEDHAMMER | 看涨 | 0 |
| 上吊线 | CDL_HANGINGMAN | 看跌 | 0 |
| 流星线 | CDL_SHOOTINGSTAR | 看跌 | 0 |
| 光头光脚 | CDL_MARUBOZU | 持续 | 0 |
| 收盘光头光脚 | CDL_CLOSINGMARUBOZU | 持续 | 0 |
| 纺锤线 | CDL_SPINNINGTOP | 中性 | 0 |
| 高浪线 | CDL_HIGHWAVE | 中性 | 0 |
| 吞没形态 | CDL_ENGULFING | 反转 | 1 |
| 孕线 | CDL_HARAMI | 反转 | 1 |
| 十字孕线 | CDL_HARAMICROSS | 反转 | 1 |
| 刺透形态 | CDL_PIERCING | 看涨 | 1 |
| 乌云盖顶 | CDL_DARKCLOUDCOVER | 看跌 | 1 |
| 捉腰带线 | CDL_BELTHOLD | 反转 | 0 |
| 反击线 | CDL_COUNTERATTACK | 反转 | 1 |
| 家鸽 | CDL_HOMINGPIGEON | 看涨 | 1 |
| 颈内线 | CDL_INNECK | 看跌 | 1 |
| 颈上线 | CDL_ONNECK | 看跌 | 1 |
| 相同低价 | CDL_MATCHINGLOW | 看涨 | 1 |
| 反冲形态 | CDL_KICKING | 反转 | 1 |
| 按长度反冲 | CDL_KICKINGBYLENGTH | 反转 | 1 |
| 分离线 | CDL_SEPARATINGLINES | 反转 | 1 |
| 插入形态 | CDL_THRUSTING | 看跌 | 1 |
| 晨星 | CDL_MORNINGSTAR | 看涨 | 2 |
| 暮星 | CDL_EVENINGSTAR | 看跌 | 2 |
| 晨星十字 | CDL_MORNINGDOJISTAR | 看涨 | 2 |
| 暮星十字 | CDL_EVENINGDOJISTAR | 看跌 | 2 |
| 三内升 | CDL_3INSIDE | 反转 | 2 |
| 三外升 | CDL_3OUTSIDE | 反转 | 2 |
| 三白兵 | CDL_3WHITESOLDIERS | 看涨 | 2 |
| 三只乌鸦 | CDL_3BLACKCROWS | 看跌 | 2 |
| 三线打击 | CDL_3LINESTRIKE | 持续 | 3 |
| 弃婴形态 | CDL_ABANDONEDBABY | 反转 | 2 |
| 三星 | CDL_TRISTAR | 反转 | 2 |
| 相同三乌鸦 | CDL_IDENTICAL3CROWS | 看跌 | 2 |
| 两只乌鸦 | CDL_2CROWS | 看跌 | 2 |
| 前进受阻 | CDL_ADVANCEBLOCK | 看跌 | 2 |
| 脱离形态 | CDL_BREAKAWAY | 反转 | 4 |
| 藏婴吞没 | CDL_CONCEALBABYSWALL | 看涨 | 3 |
| 十字星 | CDL_DOJISTAR | 反转 | 1 |
| 并排白色缺口 | CDL_GAPSIDESIDEWHITE | 持续 | 2 |
| 陷阱形态 | CDL_HIKKAKE | 反转 | 2 |
| 修正陷阱 | CDL_HIKKAKEMOD | 反转 | 2 |
| 梯底 | CDL_LADDERBOTTOM | 看涨 | 4 |
| 黄包车夫 | CDL_RICKSHAWMAN | 中性 | 0 |
| 停滞形态 | CDL_STALLEDPATTERN | 看跌 | 2 |
| 棒形三明治 | CDL_STICKSANDWICH | 看涨 | 2 |
| 南方三星 | CDL_3STARSINSOUTH | 看涨 | 2 |
| 长线 | CDL_LONGLINE | 持续 | 0 |
| 短线 | CDL_SHORTLINE | 持续 | 0 |
| 垫子形态 | CDL_MATHOLD | 持续 | 4 |
| 上升/下降三法 | CDL_RISEFALL3METHODS | 持续 | 4 |
| 探水竿 | CDL_TAKURI | 看涨 | 0 |
| 跳空并列 | CDL_TASUKIGAP | 持续 | 2 |
| 独特三河 | CDL_UNIQUE3RIVER | 看涨 | 2 |
| 向上跳空两只乌鸦 | CDL_UPSIDEGAP2CROWS | 看跌 | 2 |
| 向上/向下跳空三法 | CDL_XSIDEGAP3METHODS | 持续 | 2 |

### 数学函数 (26)

| 函数 | 描述 | 输入 | 回看期 |
|------|------|------|--------|
| AVGPRICE | 平均价格 | OHLC | 0 |
| MEDPRICE | 中位价格 | OHLC | 0 |
| TYPPRICE | 典型价格 | OHLC | 0 |
| WCLPRICE | 加权收盘价 | OHLC | 0 |
| ADD | 加法 | Close×2 | 0 |
| SUB | 减法 | Close×2 | 0 |
| MULT | 乘法 | Close×2 | 0 |
| DIV | 除法 | Close×2 | 0 |
| MAX | 最大值 | Close | period-1 |
| MIN | 最小值 | Close | period-1 |
| SUM | 求和 | Close | period-1 |
| MAXINDEX | 最大值索引 | Close | period-1 |
| MININDEX | 最小值索引 | Close | period-1 |
| MINMAX | 最小值和最大值 | Close | period-1 |
| MINMAXINDEX | 最小/最大索引 | Close | period-1 |
| SIN | 正弦 | Close | 0 |
| COS | 余弦 | Close | 0 |
| TAN | 正切 | Close | 0 |
| ASIN | 反正弦 | Close | 0 |
| ACOS | 反余弦 | Close | 0 |
| ATAN | 反正切 | Close | 0 |
| SINH | 双曲正弦 | Close | 0 |
| COSH | 双曲余弦 | Close | 0 |
| TANH | 双曲正切 | Close | 0 |
| CEIL | 向上取整 | Close | 0 |
| FLOOR | 向下取整 | Close | 0 |
| EXP | 指数 | Close | 0 |
| LN | 自然对数 | Close | 0 |
| LOG10 | 常用对数 | Close | 0 |
| SQRT | 平方根 | Close | 0 |

### 周期指标 (5)

| 指标 | 函数 | 输入 | 输出 | 回看期 |
|------|------|------|------|--------|
| HT_DCPERIOD | 主导周期 | Close | 1 | 63 |
| HT_DCPHASE | 主导周期相位 | Close | 1 | 63 |
| HT_PHASOR | 相量分量 | Close | 2 | 63 |
| HT_SINE | 正弦波 | Close | 2 | 63 |
| HT_TRENDMODE | 趋势与周期模式 | Close | 1 | 63 |

## 常用周期

### 移动平均
- **10**：短期趋势
- **20**：标准短期（最常用）
- **50**：中期趋势
- **100**：长期趋势
- **200**：主要趋势，机构级别

### 动量
- **14**：标准周期（RSI、ADX、随机指标等）
- **12/26/9**：MACD 默认值
- **5/3/3**：快速随机指标默认值
- **7/14/28**：终极振荡器默认值

### 波动率
- **14**：标准 ATR 周期

## 相关文档

- [Python API 参考](../api/python-api.md)
- [C API 参考](../api/c-api.md)
- [实现说明](../../IMPLEMENTATION_NOTES.md)

```{toctree}
:maxdepth: 2

overlap
momentum
volatility
volume
statistics
patterns
math
cycle
```