TA-Lib 技術文件：形態識別呼叫函式使用說明 [Pattern Recognition Functions]

# Pattern Recognition Functions 形態識別

### CDL2CROWS - Two Crows

> 函數名：CDL2CROWS  

名稱：Two Crows 兩隻烏鴉  

簡介：三日K線模式，第一天長陽，第二天高開收陰，第三天再次高開繼續收陰，

收盤比前一日收盤價低，預示股價下跌。

```python

integer = CDL2CROWS(open, high, low, close)

```

### CDL3BLACKCROWS - Three Black Crows

> 函數名：CDL3BLACKCROWS  

名稱：Three Black Crows 三隻烏鴉  

簡介：三日K線模式，連續三根陰線，每日收盤價都下跌且接近最低價，

每日開盤價都在上根K線實體內，預示股價下跌。  

```python

integer = CDL3BLACKCROWS(open, high, low, close)

```

### CDL3INSIDE - Three Inside Up/Down

> 函數名：CDL3INSIDE  

名稱： Three Inside Up/Down 三內部上漲和下跌  

簡介：三日K線模式，母子信號+長K線，以三內部上漲為例，K線為陰陽陽，

第三天收盤價高於第一天開盤價，第二天K線在第一天K線內部，預示著股價上漲。

```python

integer = CDL3INSIDE(open, high, low, close)

```

### CDL3LINESTRIKE - Three-Line Strike

> 函數名：CDL3LINESTRIKE  

名稱： Three-Line Strike 三線打擊  

簡介：四日K線模式，前三根陽線，每日收盤價都比前一日高，

開盤價在前一日實體內，第四日市場高開，收盤價低於第一日開盤價，預示股價下跌。

```python

integer = CDL3LINESTRIKE(open, high, low, close)

```

### CDL3OUTSIDE - Three Outside Up/Down

> 函數名：CDL3OUTSIDE 

名稱：Three Outside Up/Down 三外部上漲和下跌  

簡介：三日K線模式，與三內部上漲和下跌類似，K線為陰陽陽，但第一日與第二日的K線形態相反，

以三外部上漲為例，第一日K線在第二日K線內部，預示著股價上漲。 

```python

integer = CDL3OUTSIDE(open, high, low, close)

```

### CDL3STARSINSOUTH - Three Stars In The South

> 函數名：CDL3STARSINSOUTH 

名稱：Three Stars In The South 南方三星 

簡介：三日K線模式，與大敵當前相反，三日K線皆陰，第一日有長下影線，

第二日與第一日類似，K線整體小於第一日，第三日無下影線實體信號，

成交價格都在第一日振幅之內，預示下跌趨勢反轉，股價上升。 

```python

integer = CDL3STARSINSOUTH(open, high, low, close)

```

### CDL3WHITESOLDIERS - Three Advancing White Soldiers

> 函數名：CDL3WHITESOLDIERS  

名稱：Three Advancing White Soldiers 三個白兵 

簡介：三日K線模式，三日K線皆陽，

每日收盤價變高且接近最高價，開盤價在前一日實體上半部，預示股價上升。

```python

integer = CDL3WHITESOLDIERS(open, high, low, close)

```

### CDLABANDONEDBABY - Abandoned Baby

> 函數名：CDLABANDONEDBABY 

名稱：Abandoned Baby 棄嬰 

簡介：三日K線模式，第二日價格跳空且收十字星（開盤價與收盤價接近，

最高價最低價相差不大），預示趨勢反轉，發生在頂部下跌，底部上漲。 

```python

integer = CDLABANDONEDBABY(open, high, low, close, penetration=0)

```

### CDLADVANCEBLOCK - Advance Block

> 函數名：CDLADVANCEBLOCK  

名稱：Advance Block 大敵當前  

簡介：三日K線模式，三日都收陽，每日收盤價都比前一日高，

開盤價都在前一日實體以內，實體變短，上影線變長。  

```python

integer = CDLADVANCEBLOCK(open, high, low, close)

```

### CDLBELTHOLD - Belt-hold

> 函數名：CDLBELTHOLD  

名稱：Belt-hold 捉腰帶線  

簡介：兩日K線模式，下跌趨勢中，第一日陰線，

第二日開盤價為最低價，陽線，收盤價接近最高價，預示價格上漲。  

```python

integer = CDLBELTHOLD(open, high, low, close)

```

### CDLBREAKAWAY - Breakaway

> 函數名：CDLBREAKAWAY 

名稱：Breakaway 脫離 

簡介：五日K線模式，以看漲脫離為例，下跌趨勢中，第一日長陰線，第二日跳空陰線，延續趨勢開始震盪，

第五日長陽線，收盤價在第一天收盤價與第二天開盤價之間，預示價格上漲。  

```python

integer = CDLBREAKAWAY(open, high, low, close)

```

### CDLCLOSINGMARUBOZU - Closing Marubozu

> 函數名：CDLCLOSINGMARUBOZU  

名稱：Closing Marubozu 收盤缺影線 

簡介：一日K線模式，以陽線為例，最低價低於開盤價，收盤價等於最高價，

預示著趨勢持續。

```python

integer = CDLCLOSINGMARUBOZU(open, high, low, close)

```

### CDLCONCEALBABYSWALL - Concealing Baby Swallow

> 函數名：CDLCONCEALBABYSWALL  

名稱： Concealing Baby Swallow 藏嬰吞沒  

簡介：四日K線模式，下跌趨勢中，前兩日陰線無影線

，第二日開盤、收盤價皆低於第二日，第三日倒錘頭，

第四日開盤價高於前一日最高價，收盤價低於前一日最低價，預示著底部反轉。  

```python

integer = CDLCONCEALBABYSWALL(open, high, low, close)

```

### CDLCOUNTERATTACK - Counterattack

> 函數名：CDLCOUNTERATTACK 

名稱：Counterattack 反擊線 

簡介：二日K線模式，與分離線類似。 

```python

integer = CDLCOUNTERATTACK(open, high, low, close)

```

### CDLDARKCLOUDCOVER - Dark Cloud Cover

> 函數名：CDLDARKCLOUDCOVER 

名稱：Dark Cloud Cover 烏雲壓頂 

簡介：二日K線模式，第一日長陽，第二日開盤價高於前一日最高價，

收盤價處於前一日實體中部以下，預示著股價下跌。 

```python

integer = CDLDARKCLOUDCOVER(open, high, low, close, penetration=0)

```

### CDLDOJI - Doji

> 函數名：CDLDOJI 

名稱：Doji 十字 

簡介：一日K線模式，開盤價與收盤價基本相同。 

```python

integer = CDLDOJI(open, high, low, close)

```

### CDLDOJISTAR - Doji Star

> 函數名：CDLDOJISTAR 

名稱：Doji Star 十字星 

簡介：一日K線模式，開盤價與收盤價基本相同，上下影線不會很長，預示著當前趨勢反轉。 

```python

integer = CDLDOJISTAR(open, high, low, close)

```

### CDLDRAGONFLYDOJI - Dragonfly Doji

> 函數名：CDLDRAGONFLYDOJI 

名稱：Dragonfly Doji 蜻蜓十字/T形十字 

簡介：一日K線模式，開盤後價格一路走低，

之後收復，收盤價與開盤價相同，預示趨勢反轉。 

```python

integer = CDLDRAGONFLYDOJI(open, high, low, close)

```

### CDLENGULFING - Engulfing Pattern

> 函數名：CDLENGULFING 

名稱：Engulfing Pattern 吞噬模式 

簡介：兩日K線模式，分多頭吞噬和空頭吞噬，以多頭吞噬為例，第一日為陰線，

第二日陽線，第一日的開盤價和收盤價在第二日開盤價收盤價之內，但不能完全相同。 

```python

integer = CDLENGULFING(open, high, low, close)

```

### CDLEVENINGDOJISTAR - Evening Doji Star

> 函數名：CDLEVENINGDOJISTAR 

名稱：Evening Doji Star 十字暮星 

簡介：三日K線模式，基本模式為暮星，第二日收盤價和開盤價相同，預示頂部反轉。 

```python

integer = CDLEVENINGDOJISTAR(open, high, low, close, penetration=0)

```

### CDLEVENINGSTAR - Evening Star

> 函數名：CDLEVENINGSTAR 

名稱：Evening Star 暮星 

簡介：三日K線模式，與晨星相反，上升趨勢中,

第一日陽線，第二日價格振幅較小，第三日陰線，預示頂部反轉。 

```python

integer = CDLEVENINGSTAR(open, high, low, close, penetration=0)

```

### CDLGAPSIDESIDEWHITE - Up/Down-gap side-by-side white lines

>函數名：CDLGAPSIDESIDEWHITE 

名稱：Up/Down-gap side-by-side white lines 向上/下跳空並列陽線 

簡介：二日K線模式，上升趨勢向上跳空，下跌趨勢向下跳空,

第一日與第二日有相同開盤價，實體長度差不多，則趨勢持續。 

```python

integer = CDLGAPSIDESIDEWHITE(open, high, low, close)

```

### CDLGRAVESTONEDOJI - Gravestone Doji

> 函數名：CDLGRAVESTONEDOJI 

名稱：Gravestone Doji 墓碑十字/倒T十字 

簡介：一日K線模式，開盤價與收盤價相同，上影線長，無下影線，預示底部反轉。 

```python

integer = CDLGRAVESTONEDOJI(open, high, low, close)

```

### CDLHAMMER - Hammer

> 函數名：CDLHAMMER 

名稱：Hammer 錘頭 

簡介：一日K線模式，實體較短，無上影線，

下影線大於實體長度兩倍，處於下跌趨勢底部，預示反轉。 

```python

integer = CDLHAMMER(open, high, low, close)

```

### CDLHANGINGMAN - Hanging Man

> 函數名：CDLHANGINGMAN 

名稱：Hanging Man 上吊線 

簡介：一日K線模式，形狀與錘子類似，處於上升趨勢的頂部，預示著趨勢反轉。 

```python

integer = CDLHANGINGMAN(open, high, low, close)

```

### CDLHARAMI - Harami Pattern

> 函數名：CDLHARAMI 

名稱：Harami Pattern 母子線 

簡介：二日K線模式，分多頭母子與空頭母子，兩者相反，以多頭母子為例，在下跌趨勢中，第一日K線長陰，

第二日開盤價收盤價在第一日價格振幅之內，為陽線，預示趨勢反轉，股價上升。 

```python

integer = CDLHARAMI(open, high, low, close)

```

### CDLHARAMICROSS - Harami Cross Pattern

> 函數名：CDLHARAMICROSS 

名稱：Harami Cross Pattern 十字孕線 

簡介：二日K線模式，與母子縣類似，若第二日K線是十字線，

便稱為十字孕線，預示著趨勢反轉。 

```python

integer = CDLHARAMICROSS(open, high, low, close)

```

### CDLHIGHWAVE - High-Wave Candle

> 函數名：CDLHIGHWAVE 

名稱：High-Wave Candle 風高浪大線 

簡介：三日K線模式，具有極長的上/下影線與短的實體，預示著趨勢反轉。 

```python

integer = CDLHIGHWAVE(open, high, low, close)

```

### CDLHIKKAKE - Hikkake Pattern

> 函數名：CDLHIKKAKE 

名稱：Hikkake Pattern 陷阱 

簡介：三日K線模式，與母子類似，第二日價格在前一日實體範圍內,

第三日收盤價高於前兩日，反轉失敗，趨勢繼續。 

```python

integer = CDLHIKKAKE(open, high, low, close)

```

### CDLHIKKAKEMOD - Modified Hikkake Pattern

> 函數名：CDLHIKKAKEMOD 

名稱：Modified Hikkake Pattern 修正陷阱 

簡介：三日K線模式，與陷阱類似，上升趨勢中，第三日跳空高開；

下跌趨勢中，第三日跳空低開，反轉失敗，趨勢繼續。

```python

integer = CDLHIKKAKEMOD(open, high, low, close)

```

### CDLHOMINGPIGEON - Homing Pigeon

> 函數名：CDLHOMINGPIGEON 

名稱：Homing Pigeon 家鴿 

簡介：二日K線模式，與母子線類似，不同的的是二日K線顏色相同，

第二日最高價、最低價都在第一日實體之內，預示著趨勢反轉。 

```python

integer = CDLHOMINGPIGEON(open, high, low, close)

```

### CDLIDENTICAL3CROWS - Identical Three Crows

> 函數名：CDLIDENTICAL3CROWS 

名稱：Identical Three Crows 三胞胎烏鴉 

簡介：三日K線模式，上漲趨勢中，三日都為陰線，長度大致相等，

每日開盤價等於前一日收盤價，收盤價接近當日最低價，預示價格下跌。 

```python

integer = CDLIDENTICAL3CROWS(open, high, low, close)

```

### CDLINNECK - In-Neck Pattern

>函數名：CDLINNECK 

名稱：In-Neck Pattern 頸內線 

簡介：二日K線模式，下跌趨勢中，第一日長陰線，

第二日開盤價較低，收盤價略高於第一日收盤價，陽線，實體較短，預示著下跌繼續。 

```python

integer = CDLINNECK(open, high, low, close)

```

### CDLINVERTEDHAMMER - Inverted Hammer

> 函數名：CDLINVERTEDHAMMER 

名稱：Inverted Hammer 倒錘頭 

簡介：一日K線模式，上影線較長，長度為實體2倍以上，

無下影線，在下跌趨勢底部，預示著趨勢反轉。 

```python

integer = CDLINVERTEDHAMMER(open, high, low, close)

```

### CDLKICKING - Kicking

> 函數名：CDLKICKING 

名稱：Kicking 反沖形態 

簡介：二日K線模式，與分離線類似，兩日K線為禿線，顏色相反，存在跳空缺口。 

```python

integer = CDLKICKING(open, high, low, close)

```

### CDLKICKINGBYLENGTH - Kicking - bull/bear determined by the longer marubozu

> 函數名：CDLKICKINGBYLENGTH 

名稱：Kicking - bull/bear determined by the longer marubozu 由較長缺影線決定的反沖形態 

簡介：二日K線模式，與反沖形態類似，較長缺影線決定價格的漲跌。 

```python

integer = CDLKICKINGBYLENGTH(open, high, low, close)

```

### CDLLADDERBOTTOM - Ladder Bottom

> 函數名：CDLLADDERBOTTOM 

名稱：Ladder Bottom 梯底 

簡介：五日K線模式，下跌趨勢中，前三日陰線，

開盤價與收盤價皆低於前一日開盤、收盤價，第四日倒錘頭，第五日開盤價高於前一日開盤價，

陽線，收盤價高於前幾日價格振幅，預示著底部反轉。 

```python

integer = CDLLADDERBOTTOM(open, high, low, close)

```

### CDLLONGLEGGEDDOJI - Long Legged Doji

> 函數名：CDLLONGLEGGEDDOJI 

名稱：Long Legged Doji 長腳十字 

簡介：一日K線模式，開盤價與收盤價相同居當日價格中部，上下影線長，

表達市場不確定性。 

```python

integer = CDLLONGLEGGEDDOJI(open, high, low, close)

```

### CDLLONGLINE - Long Line Candle

> 函數名：CDLLONGLINE 

名稱：Long Line Candle 長蠟燭 

簡介：一日K線模式，K線實體長，無上下影線。 

```python

integer = CDLLONGLINE(open, high, low, close)

```

### CDLMARUBOZU - Marubozu

函數名：CDLMARUBOZU  

名稱：Marubozu 光頭光腳/缺影線 

簡介：一日K線模式，上下兩頭都沒有影線的實體，

陰線預示著熊市持續或者牛市反轉，陽線相反。 

```python

integer = CDLMARUBOZU(open, high, low, close)

```

### CDLMATCHINGLOW - Matching Low

> 函數名：CDLMATCHINGLOW 

名稱：Matching Low 相同低價 

簡介：二日K線模式，下跌趨勢中，第一日長陰線，

第二日陰線，收盤價與前一日相同，預示底部確認，該價格為支撐位。 

```python

integer = CDLMATCHINGLOW(open, high, low, close)

```

### CDLMATHOLD - Mat Hold

> 函數名：CDLMATHOLD 

名稱：Mat Hold 鋪墊 

簡介：五日K線模式，上漲趨勢中，第一日陽線，第二日跳空高開影線，

第三、四日短實體影線，第五日陽線，收盤價高於前四日，預示趨勢持續。 

```python

integer = CDLMATHOLD(open, high, low, close, penetration=0)

```

### CDLMORNINGDOJISTAR - Morning Doji Star

>函數名：CDLMORNINGDOJISTAR 

名稱：Morning Doji Star 十字晨星 

簡介：三日K線模式，

基本模式為晨星，第二日K線為十字星，預示底部反轉。 

```python

integer = CDLMORNINGDOJISTAR(open, high, low, close, penetration=0)

```

### CDLMORNINGSTAR - Morning Star

> 函數名：CDLMORNINGSTAR 

名稱：Morning Star 晨星 

簡介：三日K線模式，下跌趨勢，第一日陰線，

第二日價格振幅較小，第三天陽線，預示底部反轉。 

```python

integer = CDLMORNINGSTAR(open, high, low, close, penetration=0)

```

### CDLONNECK - On-Neck Pattern

> 函數名：CDLONNECK 

名稱：On-Neck Pattern 頸上線 

簡介：二日K線模式，下跌趨勢中，第一日長陰線，第二日開盤價較低，

收盤價與前一日最低價相同，陽線，實體較短，預示著延續下跌趨勢。 

```python

integer = CDLONNECK(open, high, low, close)

```

### CDLPIERCING - Piercing Pattern

> 函數名：CDLPIERCING 

名稱：Piercing Pattern 刺透形態 

簡介：兩日K線模式，下跌趨勢中，第一日陰線，第二日收盤價低於前一日最低價，

收盤價處在第一日實體上部，預示著底部反轉。

```python

integer = CDLPIERCING(open, high, low, close)

```

### CDLRICKSHAWMAN - Rickshaw Man

> 函數名：CDLRICKSHAWMAN 

名稱：Rickshaw Man 黃包車夫 

簡介：一日K線模式，與長腿十字線類似，

若實體正好處於價格振幅中點，稱為黃包車夫。 

```python

integer = CDLRICKSHAWMAN(open, high, low, close)

```

### CDLRISEFALL3METHODS - Rising/Falling Three Methods

> 函數名：CDLRISEFALL3METHODS

名稱：Rising/Falling Three Methods 上升/下降三法 

簡介： 五日K線模式，以上升三法為例，上漲趨勢中，

第一日長陽線，中間三日價格在第一日範圍內小幅震盪，

第五日長陽線，收盤價高於第一日收盤價，預示股價上升。 

```python

integer = CDLRISEFALL3METHODS(open, high, low, close)

```

### CDLSEPARATINGLINES - Separating Lines

> 函數名：CDLSEPARATINGLINES 

名稱：Separating Lines 分離線 

簡介：二日K線模式，上漲趨勢中，第一日陰線，第二日陽線，

第二日開盤價與第一日相同且為最低價，預示著趨勢繼續。 

```python

integer = CDLSEPARATINGLINES(open, high, low, close)

```

### CDLSHOOTINGSTAR - Shooting Star

> 函數名：CDLSHOOTINGSTAR 

名稱：Shooting Star 射擊之星 

簡介：一日K線模式，上影線至少為實體長度兩倍，

沒有下影線，預示著股價下跌 

```python

integer = CDLSHOOTINGSTAR(open, high, low, close)

```

### CDLSHORTLINE - Short Line Candle

> 函數名：CDLSHORTLINE 

名稱：Short Line Candle 短蠟燭 

簡介：一日K線模式，實體短，無上下影線 

```python

integer = CDLSHORTLINE(open, high, low, close)

```

### CDLSPINNINGTOP - Spinning Top

> 函數名：CDLSPINNINGTOP 

名稱：Spinning Top 紡錘 

簡介：一日K線，實體小。 

```python

integer = CDLSPINNINGTOP(open, high, low, close)

```

### CDLSTALLEDPATTERN - Stalled Pattern

> 函數名：CDLSTALLEDPATTERN 

名稱：Stalled Pattern 停頓形態 

簡介：三日K線模式，上漲趨勢中，第二日長陽線，

第三日開盤於前一日收盤價附近，短陽線，預示著上漲結束 

```python

integer = CDLSTALLEDPATTERN(open, high, low, close)

```

### CDLSTICKSANDWICH - Stick Sandwich

> 函數名：CDLSTICKSANDWICH 

名稱：Stick Sandwich 條形三明治 

簡介：三日K線模式，第一日長陰線，第二日陽線，開盤價高於前一日收盤價，

第三日開盤價高於前兩日最高價，收盤價於第一日收盤價相同。 

```python

integer = CDLSTICKSANDWICH(open, high, low, close)

```

### CDLTAKURI - Takuri (Dragonfly Doji with very long lower shadow)

> 函數名：CDLTAKURI 

名稱：Takuri (Dragonfly Doji with very long lower shadow)

探水竿 

簡介：一日K線模式，大致與蜻蜓十字相同，下影線長度長。 

```python

integer = CDLTAKURI(open, high, low, close)

```

### CDLTASUKIGAP - Tasuki Gap

> 函數名：CDLTASUKIGAP 

名稱：Tasuki Gap 跳空並列陰陽線 

簡介：三日K線模式，分上漲和下跌，以上升為例，

前兩日陽線，第二日跳空，第三日陰線，收盤價於缺口中，上升趨勢持續。 

```python

integer = CDLTASUKIGAP(open, high, low, close)

```

### CDLTHRUSTING - Thrusting Pattern

> 函數名：CDLTHRUSTING 

名稱：Thrusting Pattern 插入 

簡介：二日K線模式，與頸上線類似，下跌趨勢中，第一日長陰線，第二日開盤價跳空，

收盤價略低於前一日實體中部，與頸上線相比實體較長，預示著趨勢持續。 

```python

integer = CDLTHRUSTING(open, high, low, close)

```

### CDLTRISTAR - Tristar Pattern

> 函數名：CDLTRISTAR 

名稱：Tristar Pattern 三星 

簡介：三日K線模式，由三個十字組成，

第二日十字必須高於或者低於第一日和第三日，預示著反轉。 

```python

integer = CDLTRISTAR(open, high, low, close)

```

### CDLUNIQUE3RIVER - Unique 3 River

> 函數名：CDLUNIQUE3RIVER 

名稱：Unique 3 River 奇特三河床 

簡介：三日K線模式，下跌趨勢中，第一日長陰線，第二日為錘頭，最低價創新低，第三日開盤價低於第二日收盤價，收陽線，

收盤價不高於第二日收盤價，預示著反轉，第二日下影線越長可能性越大。 

```python

integer = CDLUNIQUE3RIVER(open, high, low, close)

```

### CDLUPSIDEGAP2CROWS - Upside Gap Two Crows

> 函數名：CDLUPSIDEGAP2CROWS 

名稱：Upside Gap Two Crows 向上跳空的兩隻烏鴉 

簡介：三日K線模式，第一日陽線，第二日跳空以高於第一日最高價開盤，

收陰線，第三日開盤價高於第二日，收陰線，與第一日比仍有缺口。 

```python

integer = CDLUPSIDEGAP2CROWS(open, high, low, close)

```

### CDLXSIDEGAP3METHODS - Upside/Downside Gap Three Methods

> 函數名：CDLXSIDEGAP3METHODS 

名稱：Upside/Downside Gap Three Methods 上升/下降跳空三法 

簡介：五日K線模式，以上升跳空三法為例，上漲趨勢中，第一日長陽線，第二日短陽線，第三日跳空陽線，第四日陰線，開盤價與收盤價於前兩日實體內，

第五日長陽線，收盤價高於第一日收盤價，預示股價上升。 

```python

integer = CDLXSIDEGAP3METHODS(open, high, low, close)

```

[文檔](../doc_index.md)

[FLOAT_RIGHTAll Function Groups](../funcs.md)