Mat Hold (CDLMATHOLD)

Summary

A five-candle bullish continuation pattern: a long white candle, an upside real-body-gapped small black candle, two more small falling candles that hold within the first body, and a final white candle closing above the reaction days' highs. Signals continuation of the prior uptrend. Hit = bullish continuation of the existing uptrend.

Chart

Reference data (CSV) · Chart (SVG)

Chart metadata i

Outputs

outInteger: pattern_bull_bear · zero · positive

Notes

The colors of the third and fourth (reaction) candles are not checked, although they are classically black.
The continuation reading assumes a prior uptrend, which is not verified.
Bulkowski's own dataset contains only 52 Mat Hold occurrences out of 4.7 million candle lines; he explicitly warns the 78% continuation rate he measured "will likely be wrong or at least subject to large change as additional samples become available." (thepatternsite.com)
Rare: a few years of one symbol's daily bars may show none. Bulkowski ranks it 93rd of 103 patterns by how often it occurs (Mat Hold), and it fires once in about 16,000 daily crypto bars.

Inputs

inOpen — Open price of each bar
inHigh — High price of each bar
inLow — Low price of each bar
inClose — Close price of each bar

Outputs

outInteger — +100 when the bullish Mat Hold is detected, 0 otherwise. Never emits -100

Output Values

What candlestick values mean: Candlestick Outputs. The function's flags declare which values it can return: rW7.

Value	Meaning
0	No pattern
100	Mat Hold detected — bullish continuation signal

Parameters

Parameter	Type	Default	Accepted values	Description
`optInPenetration`	real	0.5	≥ 0	Max fraction of the 1st white body the reaction days (3rd, 4th) may penetrate

Properties

Numerical Stability: Start-Independent


☐ Overlap Input
✅ Independent Y-Axis i
✅ Candlestick i
☐ Display Shift


☐ Can Output NaN or ±Inf
☐ Identity at Period 1
☐ Uses Transcendental
☐ Input Must Be Positive

Example

#include <stdio.h>
#include <ta_libc.h>

int n = 252;
double open[252]; /* your data, oldest first */
double high[252]; /* your data, oldest first */
double low[252]; /* your data, oldest first */
double close[252]; /* your data, oldest first */
int out[252];
int outBegIdx, outNBElement;

TA_Initialize();
TA_CDLMATHOLD( 0, n - 1, open, high, low, close, 0.5, &outBegIdx, &outNBElement, out );
printf( "%d values from bar %d; last out = %d\n", outNBElement, outBegIdx, out[outNBElement - 1] );

Rust

use ta_lib::Core;

let open = vec![0.0; 252]; // your data, oldest first
let high = vec![0.0; 252]; // your data, oldest first
let low = vec![0.0; 252]; // your data, oldest first
let close = vec![0.0; 252]; // your data, oldest first
let mut out = vec![0i32; 252];

let core = Core::new();
let range = core.cdlmathold(0, open.len() - 1, &open, &high, &low, &close, 0.5, &mut out)?;
println!("{} values from bar {}; last out = {}", range.count, range.beg_idx, out[range.count - 1]);

Java

import io.github.talib.Core;
import io.github.talib.OutRange;

double[] open = new double[252]; // your data, oldest first
double[] high = new double[252]; // your data, oldest first
double[] low = new double[252]; // your data, oldest first
double[] close = new double[252]; // your data, oldest first
int[] out = new int[252];

Core core = Core.DEFAULT;
OutRange r = core.cdlmathold(0, open.length - 1, open, high, low, close, 0.5, out);
System.out.println(r.count() + " values from bar " + r.begIdx() + "; last out = " + out[r.count() - 1]);

using System;
using TALib;

var open = new double[252]; // your data, oldest first
var high = new double[252]; // your data, oldest first
var low = new double[252]; // your data, oldest first
var close = new double[252]; // your data, oldest first
var outInteger = new int[252];

var core = Core.Default;
OutRange r = core.Cdlmathold(0, open.Length - 1, open, high, low, close, 0.5, outInteger);
Console.WriteLine($"{r.Count} values from bar {r.BegIdx}; last outInteger = {outInteger[r.Count - 1]}");

TypeScript

import { cdlmathold } from 'ta-lib';

const open = new Float64Array(252); // your data, oldest first
const high = new Float64Array(252); // your data, oldest first
const low = new Float64Array(252); // your data, oldest first
const close = new Float64Array(252); // your data, oldest first

const { begIdx, values } = cdlmathold({ open, high, low, close }, {
  penetration: 0.5,
});
console.log(values.length + ' values from bar ' + begIdx + '; last values = ' + values[values.length - 1]);

Implementation

Added in 0.4.0.

TA-Lib Definition: cdlmathold.c · cdlmathold.yaml

Native	File
C	`ta_CDLMATHOLD.c`
Rust	`cdlmathold.rs`
Java	`Core_CDLMATHOLD.java`
C#	`Core_CDLMATHOLD.cs`
TypeScript	`cdlmathold.ts`

Python: talib.CDLMATHOLD, see ta-lib-python.

TA-Lib is also available for R and more using a wrapper.

Aliases

Mat Hold