Struct CandleStream 

pub struct CandleStream<'s, T> { /* private fields */ }

The CandleStream provides detection capabilities for powerful multi-candle patterns

• Reversal Patterns: Engulfing, Harami, Morning/Evening Stars, Doji Stars
• Continuation Patterns: Three White Soldiers, Three Black Crows
• Top/Bottom Formations: Dark Cloud Cover and other significant reversal signals

These formations often provide stronger trading signals than single-candle patterns, offering insights into potential trend reversals, continuations, or exhaustion points. Each pattern detection method includes detailed documentation about market context and trading significance.

Examples

use candlestick_rs::{CandleStick, CandleStream};

// Create a new stream and add candles
let candle1 = (100.0, 105.0, 99.0, 104.0, 0.0);
let candle2 = (104.5, 110.0, 104.0, 109.0, 0.0);

let mut stream = CandleStream::new();
stream.push(&candle1).push(&candle2);

// Check for patterns
if stream.is_bullish_engulfing() {
    println!("Bullish engulfing pattern detected!");
}

Implementations

impl<'s, T> CandleStream<'s, T>

pub fn new() -> Self

Returns a new candle series

pub fn push(&mut self, candle: &'s T) -> &mut Self

Pushes a candle to the series

impl<T: CandleStick> CandleStream<'_, T>

pub fn is_bullish_doji_star(&self) -> bool

Identifies a Bullish Doji Star pattern, a potential reversal signal in downtrends.

This two-candle pattern occurs when a bearish candle is followed by a Doji that gaps below the prior candle’s low. The Doji represents market indecision after a dominant downtrend.

Trading Significance:

• Signals potential exhaustion of selling pressure
• Often precedes bullish price movements when confirmed
• Traders typically wait for a third bullish candle before entering long positions
• Most effective when appearing at support levels or after extended downtrends

Example

use candlestick_rs::CandleStream;
let prev = (52.0, 52.5, 48.0, 48.5, 0.0);      
let curr = (47.0, 47.5, 46.8, 47.0, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev).push(&curr).is_bullish_doji_star());

pub fn is_bearish_doji_star(&self) -> bool

Identifies a Bearish Doji Star pattern, a potential reversal signal in uptrends.

This two-candle pattern occurs when a bullish candle is followed by a Doji that gaps above the prior candle’s high. The Doji represents market indecision after a dominant uptrend.

Trading Significance:

• Signals potential exhaustion of buying pressure
• Often precedes bearish price movements when confirmed
• Traders typically wait for a third bearish candle before entering short positions
• Most effective when appearing at resistance levels or after extended uptrends

Example

use candlestick_rs::CandleStream;
let prev = (48.0, 52.5, 47.8, 52.0, 0.0);
let curr = (52.6, 53.2, 52.6, 52.6, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev).push(&curr).is_bearish_doji_star());

pub fn is_bullish_engulfing(&self) -> bool

Identifies a Bullish Engulfing pattern, a strong reversal signal at the end of downtrends.

This two-candle pattern occurs when a bearish candle is completely engulfed by a larger bullish candle (open lower than prior close, close higher than prior open). It shows buyers overwhelmingly defeating sellers.

Trading Significance:

• Indicates strong shift from selling to buying pressure
• More reliable than single-candle patterns due to the decisive price action
• Often used as an immediate entry signal, especially when volume increases
• Higher reliability when occurring at support zones or after extended downtrends

Example

use candlestick_rs::CandleStream;
let prev = (101.0, 102.0, 99.5, 100.5, 0.0); // bearish: open > close
let curr = (99.0, 103.0, 98.5, 102.5, 0.0);  // bullish: open < close, engulfs prev body
let mut series = CandleStream::new();
assert!(series.push(&prev).push(&curr).is_bullish_engulfing());

pub fn is_bearish_engulfing(&self) -> bool

Identifies a Bearish Engulfing pattern, a strong reversal signal at the end of uptrends.

This two-candle pattern occurs when a bullish candle is completely engulfed by a larger bearish candle (open higher than prior close, close lower than prior open). It shows sellers overwhelmingly defeating buyers.

Trading Significance:

• Indicates strong shift from buying to selling pressure
• More reliable than single-candle patterns due to the decisive price action
• Often used as an immediate exit signal for longs or entry for shorts
• Higher reliability when occurring at resistance zones or after extended uptrends

Example

use candlestick_rs::CandleStream;
let prev = (99.0, 100.5, 98.5, 100.0, 0.0);  // bullish: open < close
let curr = (101.5, 102.0, 97.0, 98.5, 0.0);  // bearish: open > close, engulfs prev body
let mut series = CandleStream::new();
assert!(series.push(&prev).push(&curr).is_bearish_engulfing());

pub fn is_bullish_harami(&self) -> bool

Identifies a Bullish Harami pattern, indicating potential reversal or continuation in downtrends.

This two-candle pattern occurs when a small bullish candle is contained within the trading range of a preceding larger bearish candle. The Japanese word “harami” means pregnant, describing the visual appearance.

Trading Significance:

• Signals indecision after a bearish move and possible loss of downward momentum
• Less powerful than engulfing patterns but still a notable reversal signal
• Traders typically wait for additional confirmation before entering long positions
• Part of contingent trading strategies where position size increases after confirmation

Example

use candlestick_rs::CandleStream;
let prev = (129.0, 130.0, 124.0, 125.0, 0.0);
let curr = (125.2, 127.0, 124.8, 126.5, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev).push(&curr).is_bullish_harami());

pub fn is_bearish_harami(&self) -> bool

Identifies a Bearish Harami pattern, indicating potential reversal or continuation in uptrends.

This two-candle pattern occurs when a small bearish candle is contained within the trading range of a preceding larger bullish candle. The Japanese word “harami” means pregnant, describing the visual appearance.

Trading Significance:

• Signals indecision after a bullish move and possible loss of upward momentum
• Less powerful than engulfing patterns but still a notable reversal warning
• Often used to protect profits on long positions or tighten stop losses
• Sometimes precedes a period of consolidation rather than immediate reversal

Example

use candlestick_rs::CandleStream;
let prev = (124.0, 129.0, 122.0, 127.0, 0.0);
let curr = (126.9, 129.7, 125.0, 124.8, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev).push(&curr).is_bearish_harami());

pub fn is_dark_cloud_cover(&self) -> bool

Identifies a Dark Cloud Cover pattern, a bearish reversal signal in uptrends.

This two-candle pattern occurs when a bearish candle opens above the prior bullish candle’s close but closes below the midpoint of the prior candle’s body. It shows rejection of higher prices.

Trading Significance:

• Signals strong selling pressure after an uptrend
• More significant when the bearish candle closes deep into the prior bullish candle
• Often used by traders to exit long positions or initiate short positions
• Particularly effective when appearing at historical resistance levels

Example

use candlestick_rs::CandleStream;
let prev = (100.0, 105.0, 99.5, 104.5, 0.0);
let curr = (105.5, 106.0, 102.0, 101.5, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev).push(&curr).is_dark_cloud_cover());

pub fn is_evening_star(&self) -> bool

Identifies an Evening Star pattern, a bearish reversal formation at market tops.

This three-candle pattern consists of:

1. A strong bullish candle extending the uptrend
2. A small-bodied candle showing indecision (star), often with a gap
3. A bearish candle closing well into the first candle’s body

Trading Significance:

• Represents a complete shift from bullish to bearish sentiment
• Considered one of the most reliable bearish reversal patterns
• Traders often exit longs or enter shorts when the third candle confirms
• Effectiveness increases with the size of the third bearish candle

Example

use candlestick_rs::CandleStream;
let prev2 = (100.0, 106.0, 99.5, 105.5, 0.0);
let prev1 = (106.2, 107.0, 105.8, 106.5, 0.0);
let curr = (105.5, 106.0, 102.0, 101.5, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev2).push(&prev1).push(&curr).is_evening_star());

pub fn is_evening_star_doji(&self) -> bool

Identifies an Evening Star Doji variant, a strong bearish reversal pattern at market tops.

This three-candle pattern is similar to the Evening Star, but the middle candle is specifically a Doji (open ≈ close), emphasizing the perfect equilibrium between buyers and sellers before bears take control.

Trading Significance:

• Considered stronger than the standard Evening Star due to the Doji’s stronger indecision signal
• Often precedes significant price declines when confirmed by the third candle
• Used by traders as a high-probability signal to exit long positions
• Particularly powerful when occurring after an extended uptrend with high momentum

Example

use candlestick_rs::CandleStream;
let prev2 =  (100.0, 106.0, 99.5, 105.5, 0.0);
let prev1 =  (106.1, 107.0, 105.8, 106.1, 0.0);
let curr = (105.0, 105.2, 99.8, 101.0, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev2).push(&prev1).push(&curr).is_evening_star_doji());

pub fn is_morning_star(&self) -> bool

Identifies a Morning Star pattern, a bullish reversal formation at market bottoms.

This three-candle pattern consists of:

1. A strong bearish candle extending the downtrend
2. A small-bodied candle showing indecision (star), often with a gap
3. A bullish candle closing well into the first candle’s body

Trading Significance:

• Represents a complete shift from bearish to bullish sentiment
• Considered one of the most reliable bullish reversal patterns
• Traders often enter long positions when the third candle confirms
• Effectiveness increases with the size of the third bullish candle and supporting volume

Example

use candlestick_rs::CandleStream;
let prev2 = (52.0, 52.5, 48.0, 48.5, 0.0);
let prev1 = (48.2, 48.9, 47.5, 48.3, 0.0);
let curr = (48.7, 51.5, 48.5, 51.2, 0.0);   
let mut series = CandleStream::new();
assert!(series.push(&prev2).push(&prev1).push(&curr).is_morning_star());

pub fn is_morning_star_doji(&self) -> bool

Identifies a Morning Star Doji variant, a strong bullish reversal pattern at market bottoms.

This three-candle pattern is similar to the Morning Star, but the middle candle is specifically a Doji (open ≈ close), emphasizing the perfect equilibrium between buyers and sellers before bulls take control.

Trading Significance:

• Considered stronger than the standard Morning Star due to the Doji’s stronger indecision signal
• Often precedes significant price rallies when confirmed by the third candle
• Used by traders as a high-probability entry point for long positions
• Particularly powerful when occurring at support levels with increasing volume

Example

use candlestick_rs::CandleStream;
let prev2 = (52.0, 52.5, 48.0, 48.5, 0.0);
let prev1 = (48.3, 48.9, 47.5, 48.4, 0.0);
let curr =  (48.7, 51.5, 48.5, 51.2, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev2).push(&prev1).push(&curr).is_morning_star_doji());

pub fn is_three_white_soldiers(&self) -> bool

Identifies Three White Soldiers, a powerful bullish reversal or continuation pattern.

This three-candle pattern consists of consecutive bullish candles, each opening within the previous candle’s body and closing higher, creating a stair-step appearance. Each candle shows progressively stronger buying pressure overtaking sellers.

Trading Significance:

• Indicates sustained buying pressure and strong bullish momentum
• Shows buyers controlling the market over multiple time periods
• Traders use it to confirm bullish trend reversals or continuations
• Most reliable when candles have minimal upper shadows (little selling pressure at highs)

Example

use candlestick_rs::CandleStream;
let prev2 = (48.0, 50.5, 47.8, 50.2, 0.0);
let prev1 = (50.3, 52.7, 50.1, 52.4, 0.0);
let curr =  (52.5, 54.8, 52.3, 54.5, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev2).push(&prev1).push(&curr).is_three_white_soldiers());

pub fn is_three_black_crows(&self) -> bool

Identifies Three Black Crows, a powerful bearish reversal or continuation pattern.

This three-candle pattern consists of consecutive bearish candles, each opening within the previous candle’s body and closing lower, creating a downward stair-step appearance. Each candle shows progressively stronger selling pressure overtaking buyers.

Trading Significance:

• Indicates sustained selling pressure and strong bearish momentum
• Shows sellers controlling the market over multiple time periods
• Traders use it to confirm bearish trend reversals or continuations
• Most reliable when candles have minimal lower shadows (little buying pressure at lows)

Example

use candlestick_rs::CandleStream;
let prev2 = (54.0, 54.5, 51.8, 52.2, 0.0);
let prev1 = (52.0, 52.3, 49.7, 50.4, 0.0);
let curr =  (50.2, 50.5, 47.9, 48.3, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev2).push(&prev1).push(&curr).is_three_black_crows());

pub fn is_three_inside_up(&self) -> bool

Identifies the Three Inside Up pattern, a bullish reversal.

This three-candle pattern typically appears in a downtrend and signals a potential shift from bearish to bullish momentum. This pattern can be seen as a confirmation or continuation of a bullish harami.

Trading Significance:

• Suggests that prior selling pressure is weakening
• Indicates buyers are starting to regain control
• Often used as an early sign of a bullish reversal after a down move
• Considerably stronger when combined with support levels, volume confirmation, or higher-timeframe confluence

Example

use candlestick_rs::CandleStream;

let prev2 = (54.0, 54.5, 51.8, 52.0, 0.0);
let prev1 = (52.2, 53.0, 52.0, 52.8, 0.0);
let curr  = (52.9, 55.0, 52.7, 54.5, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev2).push(&prev1).push(&curr).is_three_inside_up());

pub fn is_three_inside_down(&self) -> bool

Identifies the Three Inside Down pattern, a bearish reversal.

This three-candle pattern typically appears in an uptrend and signals a potential shift from bullish to bearish momentum. This pattern can be seen as a confirmation or continuation of a bearish harami.

Trading Significance:

• Suggests that prior buying pressure is weakening
• Indicates sellers are starting to regain control
• Often used as an early sign of a bearish reversal after an up move
• Considerably stronger when combined with resistance levels, volume confirmation, or higher-timeframe confluence

Example

use candlestick_rs::CandleStream;
let prev2 = (48.0, 50.5, 47.8, 50.0, 0.0);
let prev1 = (49.5, 49.8, 48.5, 49.0, 0.0);
let curr  = (48.8, 49.0, 47.5, 47.9, 0.0);
let mut series = CandleStream::new();
assert!(series.push(&prev2).push(&prev1).push(&curr).is_three_inside_down());

Trait Implementations

impl<'s, T: Debug> Debug for CandleStream<'s, T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T> Default for CandleStream<'_, T>

fn default() -> Self

Returns the “default value” for a type.