跳转至

第6章 技术指标

本章详细介绍 Lean 中的技术指标使用,包括内置指标、自定义指标和指标预热。

6.1 指标概览

Lean 提供了丰富的技术指标库,位于 QuantConnect.Indicators 命名空间。

6.1.1 指标分类

类别 常用指标
趋势 SMA, EMA, MACD
动量 RSI, Stochastic, ROC
波动率 ATR, Bollinger Bands, Standard Deviation
成交量 OBV, VWAP, Money Flow Index

6.2 内置指标使用

6.2.1 移动平均线

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

    # 简单移动平均线
    self.sma_20 = self.SMA(self.spy, 20, Resolution.Daily)
    self.sma_50 = self.SMA(self.spy, 50)

    # 指数移动平均线
    self.ema_12 = self.EMA(self.spy, 12)
    self.ema_26 = self.EMA(self.spy, 26)

    # 加权移动平均线(API 名为 LWMA)
    self.lwma = self.LWMA(self.spy, 20)

    # 三角移动平均线(API 名为 TRIMA)
    self.trima = self.TRIMA(self.spy, 20)

6.2.2 趋势指标

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

    # MACD (12, 26, 9)
    self.macd = self.MACD(self.spy, 12, 26, 9, MovingAverageType.Exponential)

    # 访问 MACD 组件
    # self.macd.Fast       # 快线
    # self.macd.Slow       # 慢线
    # self.macd.Signal     # 信号线
    # self.macd.Histogram  # 柱状图

def OnData(self, data):
    if not self.macd.IsReady:
        return

    # 金叉:MACD 上穿信号线
    if self.macd.Current.Value > self.macd.Signal.Current.Value:
        # ...

6.2.3 动量指标

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

    # RSI (14)
    self.rsi = self.RSI(self.spy, 14, MovingAverageType.Simple)

    # 随机指标 (14, 3, 3)(API 名为 STO,成员为 StochK / StochD)
    self.stoch = self.STO(self.spy, 14, 3, 3, Resolution.Daily)

    # 变化率
    self.roc = self.ROC(self.spy, 10)

    # 威廉指标(API 名为 WILR)
    self.wilr = self.WILR(self.spy, 14)

6.2.4 波动率指标

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

    # ATR (平均真实波幅)
    self.atr = self.ATR(self.spy, 14, MovingAverageType.Simple)

    # 布林带 (20, 2)
    self.bb = self.BB(self.spy, 20, 2, MovingAverageType.Simple)

    # 标准差
    self.std = self.STD(self.spy, 20)

def OnData(self, data):
    if not self.bb.IsReady:
        return

    # 布林带组件
    middle_band = self.bb.MiddleBand.Current.Value
    upper_band = self.bb.UpperBand.Current.Value
    lower_band = self.bb.LowerBand.Current.Value
    bandwidth = self.bb.BandWidth.Current.Value  # 注意是大写 W:BandWidth

    # 布林带挤压
    if bandwidth < 0.1:  # 低波动率
        self.Debug("Bollinger Band Squeeze detected")

6.2.5 成交量指标

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

    # 成交量加权平均价
    self.vwap = self.VWAP(self.spy)

    # 能量潮
    self.obv = self.OBV(self.spy)

    # 资金流量指数
    self.mfi = self.MFI(self.spy, 14)

6.3 指标属性和方法

6.3.1 常用属性

def OnData(self, data):
    indicator = self.sma_20

    # 检查是否就绪
    if indicator.IsReady:
        # 获取当前值
        current_value = indicator.Current.Value

        # 获取历史值
        samples = indicator.Samples      # 样本数
        warm_up_period = indicator.WarmUpPeriod  # 预热期

        # 获取多个历史值
        for i in range(5):
            value = indicator.Current.Value  # 最新的值

6.3.2 指标更新

# 指标自动更新(默认行为)
def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol
    self.sma = self.SMA(self.spy, 20)  # 自动更新

# 手动更新指标
def Initialize(self):
    self.sma = SimpleMovingAverage(20)
    self.RegisterIndicator("SPY", self.sma, Resolution.Daily)

def OnData(self, data):
    if data.ContainsKey("SPY") and data["SPY"] is not None:
        # 手动更新
        self.sma.Update(data["SPY"].EndTime, data["SPY"].Close)

6.4 指标预热

6.4.1 全局预热

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

    # 方式1:设置时间预热
    self.SetWarmUp(TimeSpan.FromDays(100))

    # 方式2:设置柱数预热
    self.SetWarmUp(100)

    # 预热后,所有指标立即就绪
    self.sma = self.SMA(self.spy, 50)  # 立即可用

6.4.2 单个指标预热

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

    self.sma = SMA(self.spy, 50, Resolution.Daily)

    # 预热特定指标
    self.WarmUpIndicator(self.spy, self.sma, TimeSpan.FromDays(50))

def OnData(self, data):
    # sma 立即可用
    if self.sma.IsReady:
        pass

6.4.3 使用历史数据预热

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol
    self.sma = self.SMA(self.spy, 50)

    # 获取历史数据预热
    history = self.History(self.spy, 50, Resolution.Daily)

    # 注意:Python 的 History 返回 pandas DataFrame,
    # 不能按 bar 对象迭代;用 iterrows 逐行遍历,
    # 行索引是每根 bar 的 EndTime,列名为小写('close' 等)
    for index, row in history.iterrows():
        self.sma.Update(index, row['close'])

6.5 自定义指标

6.5.1 简单自定义指标

class CustomIndicator(PythonIndicator):
    """
    自定义指标示例:价格动量指标
    计算价格相对于 N 天前的变化百分比
    """

    def __init__(self, period):
        self.Period = period
        self.Value = 0
        self._prices = RollingWindow[float](period)

    def Update(self, input):
        """
        更新指标

        Args:
            input: IBaseData 对象,通常是 TradeBar
        """
        # 添加新价格
        self._prices.Add(input.Value)

        # 如果窗口未满,返回 False
        if not self._prices.IsReady:
            return False

        # 计算动量
        current_price = self._prices[0]           # 最新价格
        past_price = self._prices[self.Period-1]  # N 天前价格

        self.Value = (current_price / past_price - 1) * 100
        return True

6.5.2 使用自定义指标

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

    # 创建自定义指标
    self.momentum = CustomIndicator(20)

    # 注册指标
    self.RegisterIndicator(self.spy, self.momentum, Resolution.Daily)

6.5.3 复杂自定义指标

class AdaptiveMovingAverage(PythonIndicator):
    """
    自适应移动平均线 (AMA)
    根据市场波动率调整移动平均速度
    """

    def __init__(self, fast_period=2, slow_period=30):
        self.Value = 0
        self._fast_alpha = 2 / (fast_period + 1)
        self._slow_alpha = 2 / (slow_period + 1)
        self._prev_value = 0
        self._is_ready = False

        # 用于计算效率比率
        self._price_changes = RollingWindow[float](10)

    @property
    def IsReady(self):
        return self._is_ready

    @property
    def WarmUpPeriod(self):
        return 10

    def Update(self, input):
        if not self._is_ready:
            self._prev_value = input.Value
            self._price_changes.Add(input.Value)
            if self._price_changes.IsReady:
                self._is_ready = True
            return self._is_ready

        # 计算方向性
        direction = abs(input.Value - self._price_changes[self._price_changes.Count-1])
        volatility = sum(abs(input.Value - self._price_changes[i])
                        for i in range(self._price_changes.Count))

        # 效率比率
        er = direction / volatility if volatility != 0 else 0

        # 自适应平滑系数
        sc = (er * (self._fast_alpha - self._slow_alpha) + self._slow_alpha) ** 2

        # 计算 AMA
        self.Value = self._prev_value + sc * (input.Value - self._prev_value)
        self._prev_value = self.Value

        self._price_changes.Add(input.Value)
        return True

6.6 指标组合

6.6.1 复合指标

def Initialize(self):
    self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

    # 创建多个指标
    self.sma = self.SMA(self.spy, 20)
    self.std = self.STD(self.spy, 20)

    # 创建布林带组件(手动)
    # 注意:类名是 IndicatorExtensions(复数,没有单数的 IndicatorExtension);
    # 它也没有接收 lambda 的组合方法,四则组合用 Plus / Minus / Times / Over
    two_std = IndicatorExtensions.Times(self.std, 2)      # 2 倍标准差
    self.upper_band = IndicatorExtensions.Plus(self.sma, two_std)  # SMA + 2×STD

6.6.2 指标信号组合

def OnData(self, data):
    # 获取多个指标信号
    signals = []

    # MA 信号
    if self.sma_20.Current.Value > self.sma_50.Current.Value:
        signals.append("MA_Bullish")

    # RSI 信号
    if self.rsi.Current.Value < 30:
        signals.append("RSI_Oversold")
    elif self.rsi.Current.Value > 70:
        signals.append("RSI_Overbought")

    # MACD 信号
    if self.macd.Histogram.Current.Value > 0:
        signals.append("MACD_Positive")

    # 综合信号
    if len(signals) >= 2:
        self.Debug(f"Combined signals: {signals}")

6.7 完整示例:多指标策略

from AlgorithmImports import *

class MultiIndicatorStrategy(QCAlgorithm):
    """
    多指标组合策略

    条件:
    1. 短期 MA > 长期 MA (趋势向上)
    2. RSI < 70 (不超买)
    3. 价格 > 布林带中轨 (不在弱势)
    4. MACD 柱状图 > 0 (动量向上)
    """

    def Initialize(self):
        self.SetStartDate(2020, 1, 1)
        self.SetEndDate(2023, 12, 31)
        self.SetCash(100000)

        self.spy = self.AddEquity("SPY", Resolution.Daily).Symbol

        # 指标
        self.sma_20 = self.SMA(self.spy, 20)
        self.sma_50 = self.SMA(self.spy, 50)
        self.rsi = self.RSI(self.spy, 14)
        self.bb = self.BB(self.spy, 20, 2)
        self.macd = self.MACD(self.spy, 12, 26, 9)

        # 预热
        self.SetWarmUp(TimeSpan.FromDays(60))

    def OnData(self, data):
        if not self.IsIndicatorsReady():
            return

        price = data[self.spy].Price

        # 检查买入条件
        if self.CheckBuyConditions():
            if not self.Portfolio[self.spy].IsLong:
                self.SetHoldings(self.spy, 1)
                self.Debug(f"Buy at {price}")

        # 检查卖出条件
        elif self.CheckSellConditions():
            if self.Portfolio[self.spy].IsLong:
                self.Liquidate(self.spy)
                self.Debug(f"Sell at {price}")

    def IsIndicatorsReady(self):
        """检查所有指标是否就绪"""
        return (self.sma_20.IsReady and
                self.sma_50.IsReady and
                self.rsi.IsReady and
                self.bb.IsReady and
                self.macd.IsReady)

    def CheckBuyConditions(self):
        """检查买入条件"""
        conditions = [
            self.sma_20.Current.Value > self.sma_50.Current.Value,
            self.rsi.Current.Value < 70,
            self.Securities[self.spy].Price > self.bb.MiddleBand.Current.Value,
            self.macd.Histogram.Current.Value > 0
        ]
        return all(conditions)

    def CheckSellConditions(self):
        """检查卖出条件"""
        conditions = [
            self.sma_20.Current.Value < self.sma_50.Current.Value,
            self.rsi.Current.Value > 70
        ]
        return any(conditions)