Tool
Candlestick Interpretor
interpretor.candlestick_pattern
Inputs
The candlestick-pattern bundle from a market.candlestick_patterns node: the patterns found on each bar, with their names, directions, kinds, and strengths.
Outputs
A candlestick.interpreted bundle: a `matched` gate (true when a pattern you care about appeared) plus values like strength, direction, and kind you can tap into filters or order confidence.
Reads the output of a candlestick-pattern detector and turns it into something your strategy can act on: a yes/no gate (did a pattern you care about appear?) plus simple values like the pattern's strength, direction, and kind. Use it to trade only the candlestick patterns you trust, instead of every one the detector finds.
How it works
Wire the `info` handle from a market.candlestick_patterns node, then pick a mode: match by pattern name, by direction (bullish/bearish), by kind (reversal/continuation/etc.), or by confluence (several patterns at once). It exposes a `matched` gate for filters and signals, and a `strength` value you can feed into order confidence.
Modes
Mode options
Fires only when one of the specific named patterns in your codes list appears (for example hammer or bullish engulfing).
When to use: Pick this when you trust a short list of named patterns and want to ignore everything else.
Fires when a pattern of the chosen side appears — bullish, bearish, neutral, or any — regardless of its exact name.
When to use: Pick this when you only care which way a pattern points, not which specific pattern it is.
Fires when a pattern of the chosen type appears — reversal, continuation, indecision, or false breakout.
When to use: Pick this when you trade by pattern role (e.g. only reversals at a level) rather than by name.
Fires only when at least min_pattern_count patterns appear together on the same bar, stacking the evidence.
When to use: Pick this when you want a stronger signal that several patterns agree before acting.
Code match mode options
Treats the codes list as an allow-list: only the patterns you listed can fire the gate.
When to use: Use when you have a short, trusted set of patterns and want everything else ignored.
Treats the codes list as a block-list: any pattern except the ones you listed can fire the gate.
When to use: Use when most patterns are fine but you want to mute a few noisy ones.
Direction options
Admits only patterns that point up (potential buy setups).
When to use: Use for long-only entries that should fire on upward patterns.
Admits only patterns that point down (potential sell setups).
When to use: Use for short-only entries that should fire on downward patterns.
Admits only sideways / indecision patterns that take no clear side.
When to use: Use to detect hesitation (e.g. a doji) for a wait-and-see filter.
Admits patterns of any side — bullish, bearish, or neutral all count.
When to use: Use when direction does not matter and you only want a pattern to be present.
Kinds options
Admits reversal patterns that suggest the prior trend is turning.
When to use: Use to catch tops and bottoms where price may flip direction.
Admits continuation patterns that suggest the current trend resumes.
When to use: Use to add to or join a move you already believe is in force.
Admits indecision patterns (small bodies, long wicks) where neither side wins.
When to use: Use to flag pause / balance zones before a possible breakout.
Admits false-breakout patterns where price pokes past a level then snaps back.
When to use: Use to fade traps and trade the reversal after a failed break.
Require trend options
Only admits patterns that formed while the prior trend was up.
When to use: Use to keep continuation longs in context and skip counter-trend noise.
Only admits patterns that formed while the prior trend was down.
When to use: Use to keep continuation shorts in context and skip counter-trend noise.
Disables the trend check — patterns are admitted no matter the prior trend.
When to use: Use when you do not want to gate on context, just on the pattern itself.
Configuration
Picks which test to run: by pattern name, by direction, by kind, or by confluence (a minimum count of patterns).
In name_filter mode, the list of pattern slugs to match; empty means any pattern counts.
Whether the codes list is an allow-list (include) or a block-list (exclude).
In direction_filter mode, which side to admit — bullish, bearish, neutral, or any.
In kind_filter mode, which pattern types to admit (reversal, continuation, indecision, false_breakout).
In confluence_filter mode, how many patterns must appear together for the gate to fire.
Only admit patterns that formed in the matching trend (up, down, or any to disable the check).
Off fires only on the pattern's completion bar; on keeps firing on later bars using the last pattern's saved values.
Connects to
Examples
- Filter: only allow long signals when `matched` is true for a bullish engulfing or hammer.
- Tap `strength` into an ORDER_EXIT confidence input so stronger patterns size up the trade.
Common mistakes
- Leaving the codes list empty in name_filter mode, which matches any pattern instead of the one you wanted.
- Forgetting that with `live_after_last_pattern` off, the gate only fires on the exact bar the pattern completes, not on later bars.