缠论形态识别

用途

基于缠中说禅理论的价格形态识别。缠论是一套完全基于价格结构的技术分析方法，核心链路：

原始K线 → 去包含处理 → 分型识别 → 笔检测 → 中枢构建 → 买卖点判定

适用于任何有 OHLCV 数据的市场（A股、加密货币、期货等）。

核心概念

| 概念 | 说明 | 详细文档 |

| --- | --- | --- |

| 分型（FX） | 顶分型：中间K线最高；底分型：中间K线最低 | 分型 |

| 笔（BI） | 相邻顶底分型之间的一段走势，最小单元 | 笔 |

| 中枢（ZS） | 至少3笔构成的价格重叠区域，趋势的核心 | 中枢 |

买卖点体系

| 买卖点 | 含义 | 详细文档 |

| --- | --- | --- |

| 一买/一卖 | 趋势结束后的第一个反转信号（背驰点） | 一买一卖 |

| 二买/二卖 | 一买/一卖后回调不破底/顶的确认信号 | 二买二卖 |

| 三买/三卖 | 中枢上移/下移后回调不进入前中枢的信号 | 三买三卖 |

依赖安装

pip install czsc requests pandas

快速上手

from czsc import CZSC, RawBar, Freq
from datetime import datetime

# 准备 RawBar 列表（需按时间正序排列）
bars = [
    RawBar(symbol="BTC-USDT", id=0, dt=datetime(2026,1,1),
           freq=Freq.D, open=70000, close=71000,
           high=72000, low=69000, vol=1000, amount=71000000),
    # ... 更多K线
]

# 创建分析器，自动检测分型/笔/中枢
c = CZSC(bars)

# 访问结果
print(c.bi_list)    # 已完成的笔
print(c.bars_ubi)   # 未完成笔中的K线

可用信号函数（czsc.signals.cxt）

czsc 内置 43 个缠论信号函数，核心如下：

| 函数 | 说明 | 类型 |

| --- | --- | --- |

| cxt_first_buy_V221126 | 一买信号 | 买卖点 |

| cxt_first_sell_V221126 | 一卖信号 | 买卖点 |

| cxt_second_bs_V230320 | 均线辅助二买二卖 | 买卖点 |

| cxt_third_bs_V230318 | 均线辅助三买三卖 | 买卖点 |

| cxt_third_buy_V230228 | 笔三买辅助 | 买卖点 |

| cxt_double_zs_V230311 | 两中枢组合判断BS1 | 中枢 |

| cxt_three_bi_V230618 | 三笔形态分类 | 形态 |

| cxt_five_bi_V230619 | 五笔形态分类 | 形态 |

| cxt_seven_bi_V230620 | 七笔形态分类 | 形态 |

| cxt_nine_bi_V230621 | 九笔形态分类 | 形态 |

| cxt_eleven_bi_V230622 | 十一笔形态分类 | 形态 |

| cxt_bi_base_V230228 | BI基础信号（方向/转折） | 基础 |

| cxt_bi_end_V230312 | MACD辅助笔结束 | 辅助 |

| cxt_range_oscillation_V230620 | 区间震荡判断 | 辅助 |

| cxt_zhong_shu_gong_zhen_V221221 | 大小级别中枢共振 | 中枢 |

信号约定

• 信号引擎输出：1=做多，-1=做空，0=观望
• 做多条件：一买信号 或 三笔向上盘背 或 五笔类一买
• 做空条件：一卖信号 或 三笔向下盘背 或 五笔类一卖
• 中枢辅助：价格在中枢下沿附近做多优势，上沿附近做空优势

数据格式

czsc 接受 List[RawBar]，每个 RawBar 包含：

| 字段 | 类型 | 说明 |

| --- | --- | --- |

| symbol | str | 标的代码 |

| id | int | 序号（从0开始） |

| dt | datetime | 时间 |

| freq | Freq | 频率：Freq.F1/F5/F15/F30/F60/D/W/M |

| open | float | 开盘价 |

| close | float | 收盘价 |

| high | float | 最高价 |

| low | float | 最低价 |

| vol | float | 成交量 |

| amount | float | 成交额 |

实现方式

使用 czsc 库（v0.9.68+），基于纯 Python 实现（可选 Rust 加速后端）。支持增量更新，适合实时分析。