TA-Lib 蜡烛图形态识别实战：61 个 CDL 函数，从三态信号到实时逐根更新

TA-Lib 蜡烛图形态识别实战61 个 CDL 函数从三态信号到实时逐根更新【免费下载链接】ta-lib-pythonPython wrapper for TA-Lib (http://ta-lib.org/).项目地址: https://gitcode.com/gh_mirrors/ta/ta-lib-python策略回测里想自动捕捉底部的晨星、顶部的黄昏星但让 TA-Lib 形态识别蜡烛图形态模块逐一手写 61 种判定规则显然不现实——调用talib.CDLMORNINGSTAR(...)就能直接拿到 -100 / 0 / 100 之一。下面把信号模型、按意图选函数、三种调用方式一次讲清。先读懂信号模型四个输入、三态输出61 个 CDL 函数的接口长得一模一样传入open, high, low, close四个等长一维 float64 数组返回一个与输入等长的 int32 数组 [talib/_ta_lib.pyi#L650-L657]。有三点值得先记住没有timeperiod参数。判定窗口由形态本身决定单根、两根或三根 K 线封装层不暴露周期概念这是它和均线类指标最大的区别。输出是三态整数相当于给每根 K 线贴一个红 / 中性 / 绿标签取值含义-100该根 K 线触发看跌形态0未触发任何形态100该根 K 线触发看涨形态信号索引对应的是形态的最后一根K 线所以拿到 100 之后往前数几根才是完整的形态区间。前段是 0 而不是 NaN。每个函数都有 lookback——触发首个有效信号前需要的最少历史 K 线数由底层 C 库的TA_CDLXXX_Lookback()决定封装层用make_int_array把前 lookback 个位置预填为 0因此输出数组不会有 NaN 需要你先填坑 [talib/_func.pxi#L131-L139]。 按交易意图挑函数按几根 K 线分组不如按你想解决什么问题分组实用。下面每类挑代表函数速查完整 61 个放在文末附录。趋势反转探测CDLENGULFING— 第二根 K 线实体完全包住前一根实体多空双向的反转高频信号CDLMORNINGSTAR— 底部三 K 反转大阴线、小 K 线、大阳线CDLEVENINGSTAR— 晨星的镜像顶部反转CDL3BLACKCROWS— 三根连跌阴线每根在前一根实体内开盘空头趋势确认CDL3WHITESOLDIERS— 三只乌鸦的镜像多头趋势确认CDL3STARSINSOUTH— 长阴线后出现一组小 K 线强底部信号CDLHAMMER— 单根锤子线底部拐点的初步探测动量衰竭与中继CDLHARAMI— 第二根实体被包进第一根实体动能衰竭CDLHARAMICROSS— 孕线 中间十字星衰竭信号进一步放大CDLPIERCING— 阴线后阳线反穿前一根实体过半底部试探CDLDARKCLOUDCOVER— 阴线深入前一根阳线实体顶部预警带penetrationCDLRISEFALL3METHODS— 经典三法整理趋势延续确认CDLTHRUSTING— 第二根阴线收于第一根实体中点下方偏弱的乌云变体CDLSEPARATINGLINES— 两根同开盘价、异色 K 线趋势延续缺口、跳空与特殊 K 线CDLKICKING— 异色光头光脚 K 线之间出现跳空CDLKICKINGBYLENGTH— 同上但方向由较长的那根 marubozu 决定CDLABANDONEDBABY— 两侧跳空 中间十字星的弃婴极端反转带penetrationCDLGAPSIDESIDEWHITE— 两根同色 K 线中间隔一个跳空CDLTASUKIGAP— 脱节缺口始终未回补趋势延续CDLUNIQUE3RIVER— 三根长实体同色 K 线加两个缺口强势确认CDLHIKKAKE/CDLHIKKAKEMOD— 基于五根 K 线高低价的陷阱反转CDLMARUBOZU— 无影单根光头光脚单边力量确认十字星家族CDLDOJI、CDLDRAGONFLYDOJI等 17 个单根形态更像基础配料单独用信噪比一般实际中多与其他形态信号做组合过滤。 penetration 到底在控制什么TA-Lib 晨星形态调用第三根要咬进多少CDLMORNINGSTAR的三 K 条件是第一根大阴线、第二根向下跳空的小 K 线、第三根阳线且收盘必须咬进第一根阴线实体。咬多深正是penetration设定的传 0默认时 C 库走内置的默认比例显式传值则以该值作为穿透比例下限取值越大判定越松 [talib/_ta_lib.pyi#L701-L707]。容易踩的坑penetration0不等于允许 0% 穿透它的语义是回退到默认比例。回测里如果觉得晨星触发太稀疏可以显式传penetration0.2放宽高波动品种则相反收紧一点能滤掉大量假信号。整个封装里只有 7 个函数带这个参数函数形态CDLMORNINGSTAR/CDLMORNINGDOJISTAR晨星 / 早晨十字星CDLEVENINGSTAR/CDLEVENINGDOJISTAR黄昏星 / 黄昏十字星CDLDARKCLOUDCOVER乌云盖顶CDLABANDONEDBABY弃婴形态CDLMATHOLD垫住形态其余 54 个函数签名里只有四个 OHLC 数组多传参数会直接报错。吞没没有 penetration只比谁包住谁CDLENGULFING的判定更干脆两根 K 线颜色相反第二根的实体要完全覆盖第一根实体第二根是阳线输出 100阴线输出 -100 [docs/func_groups/pattern_recognition.md]。它不关心穿透比例坑点换了一个位置吞没触发极其频繁单拿它当入场点会被来回打脸常见做法是叠加趋势过滤比如只在大级别均线之上才看看涨吞没。 三种 API 三步上手从历史批量到 TA-Lib Stream API 逐根更新步骤 1一次性扫描历史行情Function API。这是蜡烛图 Python 批量识别最直接的入口适合回测import numpy as np import talib o np.random.random(120) h np.maximum(o, np.random.random(120)) 0.05 l np.minimum(o, np.random.random(120)) - 0.05 c np.random.random(120) morning talib.CDLMORNINGSTAR(o, h, l, c, penetration0.2) print(np.where(morning 100)[0]) # 看涨信号位置步骤 2在 pandas / polars 管道中复用Abstract API。数据已经是 DataFrame 时更顺手输入可以直接是dict键为open/high/low/close或 DataFrame且能先查lookback确定有效区间 [tests/test_abstract.py#L115-L116]from talib import abstract f abstract.Function(CDL3BLACKCROWS) print(f.lookback) # 首个有效信号前的最少 K 线数 sig f.run(df) # df 可为 DataFrame 或四数组 dict步骤 3实时逐根更新Stream API。实盘场景建一次句柄新 K 线到来时调handle.update(o, h, l, c)只增量计算最新一根的信号不重算历史handle.value以 Python int 标量返回当前值句柄支持 pickle 传递 [tests/test_stream.py#L311-L313]from talib import stream handle stream.CDLENGULFING(o, h, l, c) print(handle.value) # -100 / 0 / 100 signal handle.update(o_new, h_new, l_new, c_new)一句话取舍批量回测用 FunctionDataFrame 管道用 Abstract实时行情用 Stream。⚠️ 常见坑与排错Q传入不等长的数组会怎样A封装层的check_length4先行校验四个数组长度不一致直接抛错不会返回部分结果让你自己消化 [talib/_func.pxi#L932]。Q输出前段为什么是 0 而不是 NaNA这是 lookback 机制make_int_array预填 0浮点类指标才是填 NaN。做信号对齐时别把前段 0 误当成确认无形态 [talib/_func.pxi#L131-L139]。Qpenetration在 Python 层做了什么A什么都没做。Cython 封装只把这个 float 透传给底层 C 函数具体比例阈值由 C 库定义 [talib/_ta_lib.pyi#L701-L707]。Q能用 -100 / 100 的幅值做仓位分级吗A不能。取值固定 ±100信息量在索引位置哪根 K 线触发而不在幅值。Q历史数据很短时能识别三 K 形态吗A能调用但 lookback 之前的位置恒为 0仓库测试用真实样例 K 线断言了前段全为 0、触发位置精确等于 -100 [tests/test_func.py#L288-L295]。延伸阅读Function API 总览docs/func.mdAbstract API 指南docs/abstract.md61 个蜡烛图形态完整清单docs/func_groups/pattern_recognition.md全部函数组docs/funcs.md文档索引docs/doc_index.md附录61 个 CDL 函数完整速查点击展开单根17 个CDLDOJI、CDLDRAGONFLYDOJI、CDLGRAVESTONEDOJI、CDLLONGLEGGEDDOJI、CDLRICKSHAWMAN、CDLSPINNINGTOP、CDLHIGHWAVE、CDLHAMMER、CDLINVERTEDHAMMER、CDLHANGINGMAN、CDLSHOOTINGSTAR、CDLTAKURI、CDLMARUBOZU、CDLCLOSINGMARUBOZU、CDLLONGLINE、CDLSHORTLINE、CDLBELTHOLD双根16 个CDL2CROWS、CDLENGULFING、CDLHARAMI、CDLHARAMICROSS、CDLDOJISTAR、CDLPIERCING、CDLDARKCLOUDCOVER*、CDLHOMINGPIGEON、CDLMATCHINGLOW、CDLONNECK、CDLINNECK、CDLCOUNTERATTACK、CDLTHRUSTING、CDLSEPARATINGLINES、CDLUPSIDEGAP2CROWS、CDLCONCEALBABYSWALL三根及以上28 个CDL3BLACKCROWS、CDL3WHITESOLDIERS、CDLIDENTICAL3CROWS、CDL3INSIDE、CDL3OUTSIDE、CDL3LINESTRIKE、CDL3STARSINSOUTH、CDLABANDONEDBABY、CDLADVANCEBLOCK、CDLBREAKAWAY、CDLEVENINGDOJISTAR、CDLEVENINGSTAR、CDLMORNINGDOJISTAR、CDLMORNINGSTAR、CDLGAPSIDESIDEWHITE、CDLHIKKAKE、CDLHIKKAKEMOD、CDLKICKING、CDLKICKINGBYLENGTH、CDLLADDERBOTTOM、CDLMATHOLD、CDLRISEFALL3METHODS、CDLSTALLEDPATTERN、CDLSTICKSANDWICH、CDLTASUKIGAP、CDLTRISTAR、CDLUNIQUE3RIVER、CDLXSIDEGAP3METHODS带 * 号者含penetration参数默认 0。【免费下载链接】ta-lib-pythonPython wrapper for TA-Lib (http://ta-lib.org/).项目地址: https://gitcode.com/gh_mirrors/ta/ta-lib-python创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考