Patterns

Every pattern here is a rule over stored candles, written out step by step below. Pick a name and a candle size, then one pattern to test — or let the library look for anything in progress. A hit is an observation of what the candles just did; what followed the earlier hits on the same name is counted and shown beside it, every hit included. For what the candles in progress say about the coming hours and days, open the outlook; to be told when a pattern completes, sign in and tap Alert me on any card.

Test a name

Company or symbol Candle Pattern or wave Judge after candles

Defaults shown are for weekly candles; change the candle size and re-test to see that size's defaults. Intraday candles exist only for names on a reader's watchlist, from the day they were added; daily candles go back to 2021.

PIONDIST · PIONDIST · weekly candles

110 candles on file from 30 Nov 2020 as of the close of 2 Jan 2023 last close ₹180.55 judged 4 candles after each hit the outlook for the coming hours and days →

In progress now Move of X% within M candles · down · week of 02 Jan 2023 In progress now Higher highs and higher lows · up · week of 02 Jan 2023 Just hit Gap at the open · up · week of 19 Dec 2022 Just hit Doji · neutral · week of 26 Dec 2022 Just hit Trend line: slope, length, strength · up · week of 12 Dec 2022 Just hit Bearish engulfing · down · week of 12 Dec 2022 Just hit Evening star · down · week of 12 Dec 2022 Building Impulse wave (five swings, Elliott-style) · up · wave 3 under way Building N consecutive falling candles · down · 4 of 5

The candles, with the hits marked

last 110 of 110 · shaded = the formation · triangle = the candle it completed on · dashed = a level the latest hit named

In progress now Move of X% within M candles · Runs, breaks and structure · reading down

27 hits in 110 candles · test this one alone Sign in to be alerted

Hit on the latest weekly candle — week of 02 Jan 2023

Move of X% within M candles has held from the candle of week of 19 Dec 2022 through the newest one on file (3 weeks), a down reading. It is in progress now.

What the candles did

-7.94% in the last 3 candles, 197.85 to 182.15.

What this pattern is taken to mean

A fast move: the close is at least X% away from where it was M candles ago. Read as a burst of one-sided flow.

What followed on this name's own record

After 26 earlier hits on this name's weekly candles, the close 4 weeks later went the hit's own way (up after an up reading, down after a down one) 10 times of 26 (38%). Median move in the hit's direction -0.59%; best +17.87%, worst -11.42%. Within the window the move typically reached +6.96% in the hit's favour and -7.55% against it. On this name it has more often gone the other way.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · pct = 2, candles = 3

For each candle, take the close M candles earlier.
Move % = close now / close then − 1.
The pattern completes when |move %| ≥ pct; direction is the sign.
Consecutive candles that all qualify in the same direction count once, at the first of them.

The last 12 hits on this name

week of 19 Dec 2022 down -7.94% in the last 3 candles, 197.85 to 182.15.
week of 21 Nov 2022 up +2.95% in the last 3 candles, 178.00 to 183.25.
week of 31 Oct 2022 up +7.46% in the last 3 candles, 165.65 to 178.00.
week of 10 Oct 2022 down -3.89% in the last 3 candles, 172.35 to 165.65.
week of 12 Sep 2022 up +2.18% in the last 3 candles, 163.05 to 166.60.
week of 22 Aug 2022 up +3.75% in the last 3 candles, 157.15 to 163.05.
week of 01 Aug 2022 down -5.67% in the last 3 candles, 166.60 to 157.15.
week of 04 Jul 2022 up +10.35% in the last 3 candles, 145.90 to 161.00.
week of 06 Jun 2022 down -2.78% in the last 3 candles, 160.30 to 155.85.
week of 25 Apr 2022 down -3.96% in the last 3 candles, 180.60 to 173.45.
week of 11 Apr 2022 up +4.44% in the last 3 candles, 172.45 to 180.10.
week of 14 Mar 2022 up +3.44% in the last 3 candles, 174.20 to 180.20.

In progress now Higher highs and higher lows · Runs, breaks and structure · reading up

12 hits in 110 candles · test this one alone Sign in to be alerted

Hit on the latest weekly candle — week of 02 Jan 2023

Higher highs and higher lows completed on the candle that closed at week of 02 Jan 2023, an up reading. That is the newest candle on file, so this is in progress now.

What the candles did

2 higher highs and higher lows on swings of at least 3%: lows 175.25, 176.50, 177.60; highs 187.40, 224.50.

What this pattern is taken to mean

Uptrend structure: each swing high above the last and each swing low above the last. Read as a trend that is still being confirmed by its pullbacks.

What followed on this name's own record

After 11 earlier hits on this name's weekly candles, the close 4 weeks later went the hit's way 7 times of 11 (64%). Median move in the hit's direction +4.94%; best +23.29%, worst -7.80%. Within the window the move typically reached +13.07% in the hit's favour and -4.94% against it.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · swings = 2, swing_pct = 3

Find swing highs and lows with the zigzag: a pivot is confirmed once price has moved swing_pct against it.
Take every window of 2×swings+1 consecutive confirmed pivots.
Require each swing high in the window above the previous swing high, and each swing low above the previous swing low.
The pattern completes on the candle where the last pivot in the window was confirmed.
The last swing low is reported as the level the structure stands on.

The last 12 hits on this name

week of 02 Jan 2023 up 2 higher highs and higher lows on swings of at least 3%: lows 175.25, 176.50, 177.60; highs 187.40, 224.50.
week of 14 Nov 2022 up 2 higher highs and higher lows on swings of at least 3%: lows 160.40, 160.95, 175.25; highs 178.00, 188.40.
week of 29 Aug 2022 up 2 higher highs and higher lows on swings of at least 3%: lows 142.60, 147.55, 150.90; highs 174.00, 182.00.
week of 15 Aug 2022 up 2 higher highs and higher lows on swings of at least 3%: lows 142.60, 147.55; highs 172.20, 174.00, 182.00.
week of 11 Apr 2022 up 2 higher highs and higher lows on swings of at least 3%: lows 150.20, 163.05; highs 178.00, 184.60, 192.95.
week of 06 Dec 2021 up 2 higher highs and higher lows on swings of at least 3%: lows 146.60, 163.05, 173.00; highs 192.50, 209.40.
week of 15 Nov 2021 up 2 higher highs and higher lows on swings of at least 3%: lows 146.60, 163.05; highs 158.90, 192.50, 209.40.
week of 01 Nov 2021 up 2 higher highs and higher lows on swings of at least 3%: lows 132.45, 146.60, 163.05; highs 158.90, 192.50.
week of 18 Oct 2021 up 2 higher highs and higher lows on swings of at least 3%: lows 132.45, 146.60; highs 151.95, 158.90, 192.50.
week of 13 Sep 2021 up 2 higher highs and higher lows on swings of at least 3%: lows 124.00, 132.45, 146.60; highs 151.95, 158.90.
week of 06 Sep 2021 up 2 higher highs and higher lows on swings of at least 3%: lows 124.00, 132.45; highs 133.80, 151.95, 158.90.
week of 30 Aug 2021 up 2 higher highs and higher lows on swings of at least 3%: lows 123.05, 124.00, 132.45; highs 133.80, 151.95.

Just hit Gap at the open · Runs, breaks and structure · reading up

62 hits in 110 candles · test this one alone Sign in to be alerted

Hit 2 weeks ago — week of 19 Dec 2022

Gap at the open completed on the weekly candle of week of 19 Dec 2022, an up reading, 2 weeks before the latest one (which closed at week of 02 Jan 2023 at 180.55). Since the hit the close has moved -0.88%.

What the candles did

Opened at 195.55, +1.96% above the previous close of 191.80.

What this pattern is taken to mean

The session opened at least X% away from the previous close. Read as news or flow arriving overnight.

What followed on this name's own record

After 60 earlier hits on this name's weekly candles, the close 4 weeks later went the hit's own way (up after an up reading, down after a down one) 30 times of 60 (50%). Median move in the hit's direction -0.15%; best +23.29%, worst -20.08%. Within the window the move typically reached +8.72% in the hit's favour and -7.54% against it. On this name that is a coin toss.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · pct = 1

At the first candle of each session, compare its open with the last close of the previous session.
Gap % = open / previous close − 1.
The pattern completes when |gap %| ≥ pct; direction is the gap's sign.
On daily candles this is simply open vs the previous day's close.

The last 12 hits on this name

week of 19 Dec 2022 up Opened at 195.55, +1.96% above the previous close of 191.80.
week of 12 Dec 2022 up Opened at 204.00, +2.10% above the previous close of 199.80.
week of 28 Nov 2022 up Opened at 188.00, +2.59% above the previous close of 183.25.
week of 21 Nov 2022 up Opened at 183.40, +1.83% above the previous close of 180.10.
week of 07 Nov 2022 up Opened at 180.90, +1.63% above the previous close of 178.00.
week of 31 Oct 2022 up Opened at 181.95, +1.45% above the previous close of 179.35.
week of 24 Oct 2022 up Opened at 167.65, +1.95% above the previous close of 164.45.
week of 17 Oct 2022 up Opened at 168.90, +1.96% above the previous close of 165.65.
week of 19 Sep 2022 up Opened at 169.85, +1.95% above the previous close of 166.60.
week of 15 Aug 2022 up Opened at 159.65, +1.98% above the previous close of 156.55.
week of 08 Aug 2022 up Opened at 160.15, +1.91% above the previous close of 157.15.
week of 01 Aug 2022 up Opened at 160.95, +2.00% above the previous close of 157.80.

Just hit Doji · Single-candle shapes · reading neutral

15 hits in 110 candles · test this one alone Sign in to be alerted

Hit 1 week ago — week of 26 Dec 2022

Doji completed on the weekly candle of week of 26 Dec 2022, a neutral reading, 1 week before the latest one (which closed at week of 02 Jan 2023 at 180.55). Since the hit the close has moved -0.82%.

What the candles did

Body 0.10 is 1% of the 14.35 range: open 182.15, close 182.05, high 191.95, low 177.60.

What this pattern is taken to mean

Open and close almost equal: the candle ranged but ended where it began. Read as indecision.

What followed on this name's own record

After 14 earlier hits on this name's weekly candles, the close 4 weeks later was higher 8 times of 14 (57%). Median move +1.78%; best +21.89%, worst -11.18%.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · body_pct = 10

Body = |close − open|; range = high − low.
The pattern completes when range > 0 and body ≤ body_pct of the range.

The last 12 hits on this name

week of 26 Dec 2022 neutral Body 0.10 is 1% of the 14.35 range: open 182.15, close 182.05, high 191.95, low 177.60.
week of 05 Dec 2022 neutral Body 0.80 is 3% of the 30.05 range: open 199.00, close 199.80, high 224.50, low 194.45.
week of 21 Nov 2022 neutral Body 0.15 is 2% of the 9.90 range: open 183.40, close 183.25, high 186.40, low 176.50.
week of 14 Nov 2022 neutral Body 0.15 is 2% of the 9.35 range: open 180.25, close 180.10, high 187.40, low 178.05.
week of 26 Sep 2022 neutral Body 1.60 is 10% of the 16.05 range: open 171.00, close 172.60, high 177.80, low 161.75.
week of 05 Sep 2022 neutral Body 1.50 is 8% of the 19.20 range: open 162.95, close 161.45, high 179.50, low 160.30.
week of 29 Aug 2022 neutral Body 1.05 is 7% of the 15.20 range: open 163.50, close 164.55, high 166.80, low 151.60.
week of 09 May 2022 neutral Body 1.65 is 10% of the 17.05 range: open 167.70, close 166.05, high 169.95, low 152.90.
week of 04 Apr 2022 neutral Body 1.55 is 10% of the 15.85 range: open 182.15, close 180.60, high 192.95, low 177.10.
week of 20 Dec 2021 neutral Body 1.20 is 6% of the 18.90 range: open 180.55, close 179.35, high 190.00, low 171.10.
week of 23 Aug 2021 neutral Body 0.65 is 6% of the 10.45 range: open 140.20, close 139.55, high 142.90, low 132.45.
week of 19 Jul 2021 neutral Body 0.45 is 6% of the 7.10 range: open 134.95, close 134.50, high 136.50, low 129.40.

Just hit Trend line: slope, length, strength · Trend and waves · reading up

3 hits in 110 candles · test this one alone Sign in to be alerted

Hit 3 weeks ago — week of 12 Dec 2022

Trend line: slope, length, strength completed on the weekly candle of week of 05 Dec 2022, an up reading, 3 weeks before the latest one (which closed at week of 02 Jan 2023 at 180.55). It held for 2 weeks, through week of 12 Dec 2022. Since the hit the close has moved -5.87%.

What the candles did

Over the last 20 candles the fitted line rises 1.14% per candle with R² 0.83; 17 candles since the low of the window, +27.63% from it, and the last close is still with the line.

Where it stands on the latest candle

Slope +0.84% per candle (up), R² 0.62 (choppy), 17 candles from the window's low, +11.83% from it; the last close is off the line.

What this pattern is taken to mean

The straight-line fit through the last N closes: how steep, how long, how clean. This is the slope/length/strength reading (R6) and a version of the 20-candle rule that fires on a clean run even when one close in the middle dipped.

What followed on this name's own record

Only 3 earlier hits on this name's weekly candles with 4 weeks after them — too few to say what usually follows. For what it is worth: the close 4 weeks later went the hit's way 1 of 3 times, median move -6.78%.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · n = 20, min_slope_pct = 0.25, min_r2 = 0.8

Fit a least-squares line through the last N closes (x = candle index).
Slope % = slope / mean close × 100, per candle. R² = share of the variance the line explains (1 = a ruler, 0 = chop).
Length = candles since the window's low (for a rising line) or high (falling). Magnitude = % from that extreme to the last close.
Continuing = the last close is on the slope's side of the fitted line, or the last three closes all moved with the slope.
The pattern completes when |slope %| ≥ min_slope_pct and R² ≥ min_r2; consecutive qualifying candles count once, at the first.
Progress always reports the current slope, R², length, magnitude and whether it is continuing.

The last 3 hits on this name

week of 05 Dec 2022 up Over the last 20 candles the fitted line rises 1.14% per candle with R² 0.83; 17 candles since the low of the window, +27.63% from it, and the last close is still with the line.
week of 01 Nov 2021 up Over the last 20 candles the fitted line rises 2.40% per candle with R² 0.83; 14 candles since the low of the window, +55.26% from it, and the last close is still with the line.
week of 19 Jul 2021 up Over the last 20 candles the fitted line rises 1.70% per candle with R² 0.81; 14 candles since the low of the window, +32.77% from it, and the last close is still with the line.

Just hit Bearish engulfing · Multi-candle shapes · reading down

2 hits in 110 candles · test this one alone Sign in to be alerted

Hit 3 weeks ago — week of 12 Dec 2022

Bearish engulfing completed on the weekly candle of week of 12 Dec 2022, a down reading, 3 weeks before the latest one (which closed at week of 02 Jan 2023 at 180.55). Since the hit the close has moved -5.87%.

What the candles did

An up candle (199.00→199.80) followed by a down candle (204.00→191.80) whose body covers it, after +11.15% over the 5 candles before.

What this pattern is taken to mean

An up candle followed by a down candle whose body covers it, after a rise.

What followed on this name's own record

Only 1 earlier hit on this name's weekly candles with 4 weeks after them — too few to say what usually follows. For what it is worth: the close 4 weeks later went the hit's way 0 of 1 times, median move +9.87%.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · context = 5

Take two consecutive candles.
First closes above its open; second closes below its open.
Second's open ≥ first's close and second's close ≤ first's open.
Context: the net move over the `context` candles before the pair is positive (set 0 to skip).

The last 2 hits on this name

week of 12 Dec 2022 down An up candle (199.00→199.80) followed by a down candle (204.00→191.80) whose body covers it, after +11.15% over the 5 candles before.
week of 10 Oct 2022 down An up candle (174.00→176.30) followed by a down candle (176.30→165.65) whose body covers it, after +4.89% over the 5 candles before.

Just hit Evening star · Multi-candle shapes · reading down

2 hits in 110 candles · test this one alone Sign in to be alerted

Hit 3 weeks ago — week of 12 Dec 2022

Evening star completed on the weekly candle of week of 12 Dec 2022, a down reading, 3 weeks before the latest one (which closed at week of 02 Jan 2023 at 180.55). Since the hit the close has moved -5.87%.

What the candles did

A long up candle (188.00→197.85), a small-bodied candle, then a down candle closing at 191.80, below the first candle's midpoint 192.93.

What this pattern is taken to mean

A long up candle, a small-bodied candle, then a down candle closing below the midpoint of the first.

What followed on this name's own record

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · small_pct = 30

Take three consecutive candles.
First: an up candle with a body at least the average body of the ten candles before it.
Second: a body no bigger than small_pct of the first's body.
Third: a down candle closing below the midpoint of the first candle's body.

The last 2 hits on this name

week of 12 Dec 2022 down A long up candle (188.00→197.85), a small-bodied candle, then a down candle closing at 191.80, below the first candle's midpoint 192.93.
week of 18 Oct 2021 down A long up candle (173.00→185.25), a small-bodied candle, then a down candle closing at 168.10, below the first candle's midpoint 179.12.

Building Impulse wave (five swings, Elliott-style) · Trend and waves · reading up

1 hit in 110 candles · test this one alone Sign in to be alerted

Last seen week of 15 Nov 2021

The most recent hit of Impulse wave (five swings, Elliott-style) on the weekly candles completed at week of 15 Nov 2021, 59 weeks ago, an up reading. It is not in progress now. Since then the close has moved -3.60% to 180.55.

What the candles did

Five swings up: 1 132.45→158.90, 2 back to 146.60 (above where 1 began), 3 to 192.50, 4 back to 163.05 (above the top of 1), 5 to 209.40; wave 3 is not the shortest.

Where it stands on the latest candle

Counting up: waves 1–2 confirmed, wave 3 under way (the current swing has not yet reversed by 4%). Pivots so far 176.50, 224.50, 177.60, 186.50.

What this pattern is taken to mean

Five alternating swings that obey the three classical impulse rules. A count, not a prophecy: the same swings can be counted more than one way, and this is the plain mechanical reading.

What followed on this name's own record

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · swing_pct = 4

Find swings with the zigzag at swing_pct.
Take six consecutive confirmed pivots L-H-L-H-L-H (up) or H-L-H-L-H-L (down).
Rule 1: wave 2 does not retrace past the start of wave 1.
Rule 2: wave 3 is not the shortest of waves 1, 3 and 5.
Rule 3: wave 4 does not enter the price territory of wave 1.
Each wave must make progress: 3 beyond 1, 5 beyond 3.
The pattern completes when the sixth pivot is confirmed. Progress reports 'wave 5 under way' when the first five pivots hold and the live swing is the fifth wave.

The last 1 hit on this name

week of 15 Nov 2021 up Five swings up: 1 132.45→158.90, 2 back to 146.60 (above where 1 began), 3 to 192.50, 4 back to 163.05 (above the top of 1), 5 to 209.40; wave 3 is not the shortest.

Building N consecutive falling candles · Runs, breaks and structure · reading down

0 hits in 110 candles · test this one alone Sign in to be alerted

Not seen on the weekly candles on file

N consecutive falling candles did not complete anywhere in the 110 weekly candles stored for this name (from week of 30 Nov 2020 to week of 02 Jan 2023).

Where it stands on the latest candle

4 falling closes in a row so far (-9.63%); the rule wants 5.

What this pattern is taken to mean

The mirror: every close below the one before it for N candles. Read as sellers in control while it lasts.

What followed on this name's own record

No earlier hit on this name's weekly candles has a full 4 weeks after it yet, so there is nothing to count.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · n = 5

Walk the candles in order.
Count a streak: +1 when this close is below the previous close, back to 0 otherwise.
The pattern completes on the candle where the streak first reaches N.
Report the move from the close before the run to the close that completed it.
Progress: the current streak against N.

Quiet Volume spike · Indicator-based · reading up

11 hits in 110 candles · test this one alone Sign in to be alerted

Last seen week of 05 Dec 2022

The most recent hit of Volume spike on the weekly candles completed at week of 05 Dec 2022, 4 weeks ago, an up reading. It is not in progress now. Since then the close has moved -9.63% to 180.55.

What the candles did

Volume 7.6× the average of the previous 20 candles (467,346 vs 61,896), on an up candle.

What this pattern is taken to mean

One candle traded many times the recent average volume. Read as attention arriving; the candle's colour says which way it leaned.

What followed on this name's own record

After 11 earlier hits on this name's weekly candles, the close 4 weeks later went the hit's own way (up after an up reading, down after a down one) 5 times of 11 (46%). Median move in the hit's direction -0.57%; best +13.85%, worst -11.15%. Within the window the move typically reached +9.13% in the hit's favour and -4.78% against it. On this name that is a coin toss.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · times = 3, candles = 20

Average the volume of the previous M candles (those that reported one).
The pattern completes when this candle's volume ≥ times × that average.
Direction is the candle's own: up if it closed above its open, down if below, neutral if flat.

The last 11 hits on this name

week of 05 Dec 2022 up Volume 7.6× the average of the previous 20 candles (467,346 vs 61,896), on an up candle.
week of 31 Oct 2022 down Volume 3.3× the average of the previous 20 candles (132,704 vs 39,628), on a down candle.
week of 12 Sep 2022 up Volume 3.2× the average of the previous 20 candles (116,085 vs 36,542), on an up candle.
week of 04 Oct 2021 up Volume 3.1× the average of the previous 20 candles (912,185 vs 298,478), on an up candle.
week of 20 Sep 2021 up Volume 3.8× the average of the previous 20 candles (945,754 vs 245,659), on an up candle.
week of 30 Aug 2021 up Volume 4.6× the average of the previous 20 candles (913,320 vs 199,333), on an up candle.
week of 16 Aug 2021 up Volume 7.8× the average of the previous 20 candles (1,066,568 vs 136,997), on an up candle.
week of 14 Jun 2021 up Volume 3.7× the average of the previous 20 candles (420,931 vs 112,684), on an up candle.
week of 07 Jun 2021 up Volume 4.1× the average of the previous 20 candles (396,039 vs 97,319), on an up candle.
week of 31 May 2021 up Volume 4.4× the average of the previous 20 candles (373,271 vs 84,158), on an up candle.
week of 24 May 2021 up Volume 3.0× the average of the previous 20 candles (255,574 vs 83,981), on an up candle.

Quiet Lower highs and lower lows · Runs, breaks and structure · reading down

6 hits in 110 candles · test this one alone Sign in to be alerted

Last seen week of 20 Jun 2022

The most recent hit of Lower highs and lower lows on the weekly candles completed at week of 20 Jun 2022, 28 weeks ago, a down reading. It is not in progress now. Since then the close has moved +21.13% to 180.55.

What the candles did

2 lower highs and lower lows on swings of at least 3%: lows 152.90, 144.70, 142.60; highs 179.95, 172.20.

What this pattern is taken to mean

Downtrend structure: each swing high below the last and each swing low below the last.

What followed on this name's own record

After 6 earlier hits on this name's weekly candles, the close 4 weeks later went the hit's way 3 times of 6 (50%). Median move in the hit's direction -3.17%; best +8.98%, worst -15.76%. Within the window the move typically reached +6.73% in the hit's favour and -10.55% against it. On this name that is a coin toss.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · swings = 2, swing_pct = 3

Find swing highs and lows with the zigzag (pivot confirmed after a swing_pct move against it).
Take every window of 2×swings+1 consecutive confirmed pivots.
Require each swing high below the previous swing high, and each swing low below the previous swing low.
The pattern completes on the candle where the last pivot was confirmed.
The last swing high is reported as the level the structure hangs from.

The last 6 hits on this name

week of 20 Jun 2022 down 2 lower highs and lower lows on swings of at least 3%: lows 152.90, 144.70, 142.60; highs 179.95, 172.20.
week of 16 May 2022 down 2 lower highs and lower lows on swings of at least 3%: lows 163.05, 160.00, 152.90; highs 192.95, 179.75.
week of 14 Mar 2022 down 2 lower highs and lower lows on swings of at least 3%: lows 165.35, 161.70, 150.20; highs 181.00, 178.00.
week of 07 Mar 2022 down 2 lower highs and lower lows on swings of at least 3%: lows 165.35, 161.70; highs 197.10, 181.00, 178.00.
week of 21 Feb 2022 down 2 lower highs and lower lows on swings of at least 3%: lows 171.10, 165.35, 161.70; highs 197.10, 181.00.
week of 09 Aug 2021 down 2 lower highs and lower lows on swings of at least 3%: lows 125.95, 123.05; highs 140.40, 136.50, 133.80.

Quiet Inside bar, then a breakout · Runs, breaks and structure · reading down

5 hits in 110 candles · test this one alone Sign in to be alerted

Last seen week of 13 Jun 2022

The most recent hit of Inside bar, then a breakout on the weekly candles completed at week of 13 Jun 2022, 29 weeks ago, a down reading. It is not in progress now. Since then the close has moved +23.75% to 180.55.

What the candles did

An inside candle (155.10–165.00) within the one before it (151.00–172.20), then a close at 145.90 below that range.

What this pattern is taken to mean

A candle whose whole range sat inside the one before it (a pause), then a close outside the mother candle's range. Read as a pause resolving.

What followed on this name's own record

After 5 earlier hits on this name's weekly candles, the close 4 weeks later went the hit's own way (up after an up reading, down after a down one) 3 times of 5 (60%). Median move in the hit's direction +2.64%; best +13.85%, worst -14.19%. Within the window the move typically reached +6.64% in the hit's favour and -5.78% against it.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked

Take three consecutive candles: mother, inside, break.
Inside: its high ≤ mother high and its low ≥ mother low.
The pattern completes when the third candle closes above the mother high (up) or below the mother low (down).

The last 5 hits on this name

week of 13 Jun 2022 down An inside candle (155.10–165.00) within the one before it (151.00–172.20), then a close at 145.90 below that range.
week of 18 Apr 2022 down An inside candle (178.15–190.50) within the one before it (177.10–192.95), then a close at 175.40 below that range.
week of 24 Jan 2022 down An inside candle (178.70–192.90) within the one before it (175.55–197.10), then a close at 173.20 below that range.
week of 30 Aug 2021 up An inside candle (132.45–142.90) within the one before it (127.65–151.95), then a close at 152.35 above that range.
week of 15 Mar 2021 down An inside candle (106.00–110.50) within the one before it (104.85–110.55), then a close at 104.05 below that range.

Quiet RSI into overbought / oversold · Indicator-based · reading down

4 hits in 110 candles · test this one alone Sign in to be alerted

Last seen week of 25 Oct 2021

The most recent hit of RSI into overbought / oversold on the weekly candles completed at week of 25 Oct 2021, 62 weeks ago, a down reading. It is not in progress now. Since then the close has moved -7.36% to 180.55.

What the candles did

RSI(14) rose to 75, into the overbought zone above 70.

What this pattern is taken to mean

Wilder's RSI crossed into the overbought zone (reported as a 'down' observation: stretched) or the oversold zone ('up': washed out).

What followed on this name's own record

Only 4 earlier hits on this name's weekly candles with 4 weeks after them — too few to say what usually follows. For what it is worth: the close 4 weeks later went the hit's way 3 of 4 times, median move -1.24%.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · n = 14, high = 70, low = 30

Compute RSI(n) from the closes (Wilder smoothing).
The pattern completes when RSI moves from below `high` to at or above it (overbought → down), or from above `low` to at or below it (oversold → up).
Only the crossing candle is a hit, not every candle spent inside the zone.

The last 4 hits on this name

week of 25 Oct 2021 down RSI(14) rose to 75, into the overbought zone above 70.
week of 20 Sep 2021 down RSI(14) rose to 78, into the overbought zone above 70.
week of 30 Aug 2021 down RSI(14) rose to 75, into the overbought zone above 70.
week of 07 Jun 2021 down RSI(14) rose to 72, into the overbought zone above 70.

Quiet Shooting star · Single-candle shapes · reading down

4 hits in 110 candles · test this one alone Sign in to be alerted

Last seen week of 12 Sep 2022

The most recent hit of Shooting star on the weekly candles completed at week of 12 Sep 2022, 16 weeks ago, a down reading. It is not in progress now. Since then the close has moved +8.37% to 180.55.

What the candles did

Upper wick 12.40 is 2.6× the body, the lower wick is 8% of the range, after +3.13% over the 5 candles before; high 179.00, close 166.60.

What this pattern is taken to mean

A long upper wick and a small body near the bottom, after a rise: the candle went well above and was pushed back down. Read as a high being rejected.

What followed on this name's own record

Only 4 earlier hits on this name's weekly candles with 4 weeks after them — too few to say what usually follows. For what it is worth: the close 4 weeks later went the hit's way 1 of 4 times, median move +5.24%.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · wick_times = 2, other_wick_pct = 15, context = 5

Upper wick ≥ wick_times × body.
Lower wick ≤ other_wick_pct of the range.
Context: the net move over the `context` candles before is positive (set 0 to skip).
The wick's high is reported as the level rejected.

The last 4 hits on this name

week of 12 Sep 2022 down Upper wick 12.40 is 2.6× the body, the lower wick is 8% of the range, after +3.13% over the 5 candles before; high 179.00, close 166.60.
week of 05 Sep 2022 down Upper wick 16.55 is 11.0× the body, the lower wick is 6% of the range, after +4.71% over the 5 candles before; high 179.50, close 161.45.
week of 13 Sep 2021 down Upper wick 6.10 is 3.3× the body, the lower wick is 3% of the range, after +15.76% over the 5 candles before; high 155.20, close 147.25.
week of 21 Jun 2021 down Upper wick 3.30 is 2.4× the body, the lower wick is 15% of the range, after +21.30% over the 5 candles before; high 137.50, close 132.80.

Quiet N consecutive rising candles · Runs, breaks and structure · reading up

3 hits in 110 candles · test this one alone Sign in to be alerted

Last seen week of 18 Jul 2022

The most recent hit of N consecutive rising candles on the weekly candles completed at week of 18 Jul 2022, 24 weeks ago, an up reading. It is not in progress now. Since then the close has moved +5.74% to 180.55.

What the candles did

5 consecutive rising closes, from 145.90 to 170.75 (+17.03%).

Where it stands on the latest candle

The last close was not rising; no run under way.

What this pattern is taken to mean

A momentum run: every close above the one before it for N candles. The owner's first example. Conventionally read as buyers in control for as long as it lasts.

What followed on this name's own record

Only 3 earlier hits on this name's weekly candles with 4 weeks after them — too few to say what usually follows. For what it is worth: the close 4 weeks later went the hit's way 2 of 3 times, median move +13.85%.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · n = 5

Walk the candles in order.
Count a streak: +1 when this close is above the previous close, back to 0 otherwise.
The pattern completes on the candle where the streak first reaches N.
Report the move from the close before the run to the close that completed it.
Progress: how long the current streak is against N, and whether the last close is still rising.

The last 3 hits on this name

week of 18 Jul 2022 up 5 consecutive rising closes, from 145.90 to 170.75 (+17.03%).
week of 30 Aug 2021 up 5 consecutive rising closes, from 125.95 to 152.35 (+20.96%).
week of 17 May 2021 up 5 consecutive rising closes, from 101.30 to 111.75 (+10.32%).

Quiet Moving-average cross · Indicator-based · reading up

3 hits in 110 candles · test this one alone Sign in to be alerted

Last seen week of 05 Sep 2022

The most recent hit of Moving-average cross on the weekly candles completed at week of 05 Sep 2022, 17 weeks ago, an up reading. It is not in progress now. Since then the close has moved +11.83% to 180.55.

What the candles did

The 9-candle average (161.85) crossed above the 21-candle average (161.13).

What this pattern is taken to mean

The faster simple average crossed the slower one. Read as the near-term average price overtaking (or falling behind) the longer one.

What followed on this name's own record

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · fast = 9, slow = 21

Compute SMA(fast) and SMA(slow) of the closes.
The pattern completes on a candle where fast was ≤ slow on the previous candle and is > slow now (up), or ≥ before and < now (down).
fast must be smaller than slow, else nothing is reported.

The last 3 hits on this name

week of 05 Sep 2022 up The 9-candle average (161.85) crossed above the 21-candle average (161.13).
week of 07 Feb 2022 down The 9-candle average (178.36) crossed below the 21-candle average (181.30).
week of 07 Jun 2021 up The 9-candle average (113.71) crossed above the 21-candle average (111.42).

Quiet Hammer · Single-candle shapes · reading up

3 hits in 110 candles · test this one alone Sign in to be alerted

Last seen week of 09 May 2022

The most recent hit of Hammer on the weekly candles completed at week of 09 May 2022, 34 weeks ago, an up reading. It is not in progress now. Since then the close has moved +8.73% to 180.55.

What the candles did

Lower wick 13.15 is 8.0× the body, the upper wick is 13% of the range, after -8.97% over the 5 candles before; low 152.90, close 166.05.

What this pattern is taken to mean

A long lower wick and a small body near the top, after a decline: the candle went well below and was pulled back up. Read as a low being rejected.

What followed on this name's own record

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · wick_times = 2, other_wick_pct = 15, context = 5

Lower wick ≥ wick_times × body.
Upper wick ≤ other_wick_pct of the range.
Context: the net move over the `context` candles before is negative (set 0 to skip).
The wick's low is reported as the level rejected.

The last 3 hits on this name

week of 09 May 2022 up Lower wick 13.15 is 8.0× the body, the upper wick is 13% of the range, after -8.97% over the 5 candles before; low 152.90, close 166.05.
week of 27 Dec 2021 up Lower wick 9.05 is 4.0× the body, the upper wick is 0% of the range, after -1.27% over the 5 candles before; low 171.65, close 180.70.
week of 19 Apr 2021 up Lower wick 3.95 is 3.8× the body, the upper wick is 12% of the range, after -2.64% over the 5 candles before; low 98.05, close 103.05.

Quiet Marubozu · Single-candle shapes · reading down

3 hits in 110 candles · test this one alone Sign in to be alerted

Last seen week of 06 Jun 2022

The most recent hit of Marubozu on the weekly candles completed at week of 06 Jun 2022, 30 weeks ago, a down reading. It is not in progress now. Since then the close has moved +15.85% to 180.55.

What the candles did

Body 9.15 is 92% of the range: opened near the high and closed near the low (165.00→155.85).

What this pattern is taken to mean

Almost no wicks: the candle opened at one end of its range and closed at the other. Read as one side in control for the whole candle.

What followed on this name's own record

Only 3 earlier hits on this name's weekly candles with 4 weeks after them — too few to say what usually follows. For what it is worth: the close 4 weeks later went the hit's way 0 of 3 times, median move +6.70%.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · body_pct = 90

Body = |close − open|; range = high − low.
The pattern completes when range > 0 and body ≥ body_pct of the range.
Direction is the candle's colour.

The last 3 hits on this name

week of 06 Jun 2022 down Body 9.15 is 92% of the range: opened near the high and closed near the low (165.00→155.85).
week of 28 Feb 2022 down Body 13.85 is 94% of the range: opened near the high and closed near the low (178.00→164.15).
week of 13 Dec 2021 down Body 14.25 is 96% of the range: opened near the high and closed near the low (191.85→177.60).

Quiet Bollinger squeeze, then a break · Indicator-based · reading down

1 hit in 110 candles · test this one alone Sign in to be alerted

Last seen week of 23 May 2022

The most recent hit of Bollinger squeeze, then a break on the weekly candles completed at week of 23 May 2022, 32 weeks ago, a down reading. It is not in progress now. Since then the close has moved +16.67% to 180.55.

What the candles did

Closed at 154.75, below the lower band (156.77) after the bands had narrowed to their tightest in 60 candles.

What this pattern is taken to mean

The bands had narrowed to their tightest in a while, then the close left them. Read as a quiet stretch ending.

What followed on this name's own record

Only 1 earlier hit on this name's weekly candles with 4 weeks after them — too few to say what usually follows. For what it is worth: the close 4 weeks later went the hit's way 1 of 1 times, median move -3.68%.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · n = 20, k = 2, squeeze = 60

Compute Bollinger bands: SMA(n) ± k × standard deviation of the last n closes; bandwidth = (upper − lower) / middle.
Squeeze: the smallest bandwidth in the last 6 candles is within 5% of the smallest over the last `squeeze` candles.
The pattern completes on a candle that closes above the upper band having been at or below it the candle before (up), or the mirror below the lower band (down), while squeezed.

The last 1 hit on this name

week of 23 May 2022 down Closed at 154.75, below the lower band (156.77) after the bands had narrowed to their tightest in 60 candles.

Quiet Bullish engulfing · Multi-candle shapes · reading up

1 hit in 110 candles · test this one alone Sign in to be alerted

Last seen week of 09 Aug 2021

The most recent hit of Bullish engulfing on the weekly candles completed at week of 09 Aug 2021, 73 weeks ago, an up reading. It is not in progress now. Since then the close has moved +39.10% to 180.55.

What the candles did

A down candle (128.50→126.90) followed by an up candle (126.20→129.80) whose body covers it, after -4.69% over the 5 candles before.

What this pattern is taken to mean

A down candle followed by an up candle whose body covers it, after a decline. Read as the decline being rejected in one candle.

What followed on this name's own record

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · context = 5

Take two consecutive candles.
First closes below its open; second closes above its open.
Second's open ≤ first's close and second's close ≥ first's open (its body covers the first's body).
Context: the net move over the `context` candles before the pair is negative (set 0 to skip).

The last 1 hit on this name

week of 09 Aug 2021 up A down candle (128.50→126.90) followed by an up candle (126.20→129.80) whose body covers it, after -4.69% over the 5 candles before.

Quiet Morning star · Multi-candle shapes · reading up

1 hit in 110 candles · test this one alone Sign in to be alerted

Last seen week of 27 Jun 2022

The most recent hit of Morning star on the weekly candles completed at week of 27 Jun 2022, 27 weeks ago, an up reading. It is not in progress now. Since then the close has moved +15.40% to 180.55.

What the candles did

A long down candle (155.85→145.90), a small-bodied candle, then an up candle closing at 156.45, above the first candle's midpoint 150.88.

What this pattern is taken to mean

A long down candle, a small-bodied candle, then an up candle closing above the midpoint of the first. Read as a decline stalling and turning.

What followed on this name's own record

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · small_pct = 30

Take three consecutive candles.
First: a down candle with a body at least the average body of the ten candles before it.
Second: a body no bigger than small_pct of the first's body.
Third: an up candle closing above the midpoint of the first candle's body.

The last 1 hit on this name

week of 27 Jun 2022 up A long down candle (155.85→145.90), a small-bodied candle, then an up candle closing at 156.45, above the first candle's midpoint 150.88.

Quiet Cross of a level you set · Runs, breaks and structure · reading up or down

0 hits in 110 candles · test this one alone Sign in to be alerted

Not seen on the weekly candles on file

Cross of a level you set did not complete anywhere in the 110 weekly candles stored for this name (from week of 30 Nov 2020 to week of 02 Jan 2023).

What this pattern is taken to mean

The close went through a price you chose. Read however you meant the level.

What followed on this name's own record

No earlier hit on this name's weekly candles has a full 4 weeks after it yet, so there is nothing to count.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · level = 0

Take the level you entered.
The pattern completes on a candle whose close is at or above the level while the previous close was below it (up), or at or below it while the previous close was above (down).
Nothing is reported until a level is set.

Quiet Three white soldiers · Multi-candle shapes · reading up

0 hits in 110 candles · test this one alone Sign in to be alerted

Not seen on the weekly candles on file

Three white soldiers did not complete anywhere in the 110 weekly candles stored for this name (from week of 30 Nov 2020 to week of 02 Jan 2023).

What this pattern is taken to mean

Three up candles in a row, each opening inside the previous body and closing higher, with little upper wick.

What followed on this name's own record

No earlier hit on this name's weekly candles has a full 4 weeks after it yet, so there is nothing to count.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · wick_pct = 30

Take three consecutive candles, all closing above their opens.
Each close above the previous close.
Each open inside the previous candle's body.
Each upper wick no more than wick_pct of its body.

Quiet Three black crows · Multi-candle shapes · reading down

0 hits in 110 candles · test this one alone Sign in to be alerted

Not seen on the weekly candles on file

Three black crows did not complete anywhere in the 110 weekly candles stored for this name (from week of 30 Nov 2020 to week of 02 Jan 2023).

What this pattern is taken to mean

Three down candles in a row, each opening inside the previous body and closing lower, with little lower wick.

What followed on this name's own record

No earlier hit on this name's weekly candles has a full 4 weeks after it yet, so there is nothing to count.

An observation from stored candles, not advice. Nothing here is a forecast; the decision, and the risk, are yours.

The rule, exactly as checked · wick_pct = 30

Take three consecutive candles, all closing below their opens.
Each close below the previous close.
Each open inside the previous candle's body.
Each lower wick no more than wick_pct of its body.

The library, rule by rule

What each pattern checks, in the order the code checks it, with the parameters and their defaults for weekly candles. The "meaning" is the convention the pattern is named for, stated as a convention; whether it held on a given name is what the test above measures.

Runs, breaks and structure

Rules on closes, highs and lows alone. Plain to state, plain to check.

N consecutive rising candles · reading up · any candleA momentum run: every close above the one before it for N candles. The owner's first example. Conventionally read as buyers in control for as long as it lasts.

Walk the candles in order.
Count a streak: +1 when this close is above the previous close, back to 0 otherwise.
The pattern completes on the candle where the streak first reaches N.
Report the move from the close before the run to the close that completed it.
Progress: how long the current streak is against N, and whether the last close is still rising.

n = 5: Consecutive rising closes (N) — The owner's momentum-run example uses 20.

Test this pattern on PIONDIST

N consecutive falling candles · reading down · any candleThe mirror: every close below the one before it for N candles. Read as sellers in control while it lasts.

Walk the candles in order.
Count a streak: +1 when this close is below the previous close, back to 0 otherwise.
The pattern completes on the candle where the streak first reaches N.
Report the move from the close before the run to the close that completed it.
Progress: the current streak against N.

n = 5: Consecutive falling closes (N)

Test this pattern on PIONDIST

Higher highs and higher lows · reading up · any candleUptrend structure: each swing high above the last and each swing low above the last. Read as a trend that is still being confirmed by its pullbacks.

Find swing highs and lows with the zigzag: a pivot is confirmed once price has moved swing_pct against it.
Take every window of 2×swings+1 consecutive confirmed pivots.
Require each swing high in the window above the previous swing high, and each swing low above the previous swing low.
The pattern completes on the candle where the last pivot in the window was confirmed.
The last swing low is reported as the level the structure stands on.

swings = 2: Higher highs / higher lows required
swing_pct = 3: Minimum swing size, % — Smaller on intraday candles.

Test this pattern on PIONDIST

Lower highs and lower lows · reading down · any candleDowntrend structure: each swing high below the last and each swing low below the last.

Find swing highs and lows with the zigzag (pivot confirmed after a swing_pct move against it).
Take every window of 2×swings+1 consecutive confirmed pivots.
Require each swing high below the previous swing high, and each swing low below the previous swing low.
The pattern completes on the candle where the last pivot was confirmed.
The last swing high is reported as the level the structure hangs from.

swings = 2: Lower highs / lower lows required
swing_pct = 3: Minimum swing size, %

Test this pattern on PIONDIST

Gap at the open · reading up or down · any candleThe session opened at least X% away from the previous close. Read as news or flow arriving overnight.

At the first candle of each session, compare its open with the last close of the previous session.
Gap % = open / previous close − 1.
The pattern completes when |gap %| ≥ pct; direction is the gap's sign.
On daily candles this is simply open vs the previous day's close.

pct = 1: Minimum gap, %

Test this pattern on PIONDIST

Move of X% within M candles · reading up or down · any candleA fast move: the close is at least X% away from where it was M candles ago. Read as a burst of one-sided flow.

For each candle, take the close M candles earlier.
Move % = close now / close then − 1.
The pattern completes when |move %| ≥ pct; direction is the sign.
Consecutive candles that all qualify in the same direction count once, at the first of them.

pct = 2: Minimum move, %
candles = 3: Within this many candles (M)

Test this pattern on PIONDIST

Cross of a level you set · reading up or down · any candleThe close went through a price you chose. Read however you meant the level.

Take the level you entered.
The pattern completes on a candle whose close is at or above the level while the previous close was below it (up), or at or below it while the previous close was above (down).
Nothing is reported until a level is set.

level = 0: Your level, ₹ — Required — leave at 0 and this pattern reports nothing.

Test this pattern on PIONDIST

Inside bar, then a breakout · reading up or down · any candleA candle whose whole range sat inside the one before it (a pause), then a close outside the mother candle's range. Read as a pause resolving.

Take three consecutive candles: mother, inside, break.
Inside: its high ≤ mother high and its low ≥ mother low.
The pattern completes when the third candle closes above the mother high (up) or below the mother low (down).

Test this pattern on PIONDIST

Indicator-based

Rules on a derived line: moving averages, VWAP, volume, RSI, Bollinger bands.

Moving-average cross · reading up or down · any candleThe faster simple average crossed the slower one. Read as the near-term average price overtaking (or falling behind) the longer one.

Compute SMA(fast) and SMA(slow) of the closes.
The pattern completes on a candle where fast was ≤ slow on the previous candle and is > slow now (up), or ≥ before and < now (down).
fast must be smaller than slow, else nothing is reported.

fast = 9: Fast average, candles
slow = 21: Slow average, candles

Test this pattern on PIONDIST

Volume spike · reading up or down · any candleOne candle traded many times the recent average volume. Read as attention arriving; the candle's colour says which way it leaned.

Average the volume of the previous M candles (those that reported one).
The pattern completes when this candle's volume ≥ times × that average.
Direction is the candle's own: up if it closed above its open, down if below, neutral if flat.

times = 3: Multiple of the average
candles = 20: Average over this many candles (M)

Test this pattern on PIONDIST

RSI into overbought / oversold · reading up or down · any candleWilder's RSI crossed into the overbought zone (reported as a 'down' observation: stretched) or the oversold zone ('up': washed out).

Compute RSI(n) from the closes (Wilder smoothing).
The pattern completes when RSI moves from below `high` to at or above it (overbought → down), or from above `low` to at or below it (oversold → up).
Only the crossing candle is a hit, not every candle spent inside the zone.

n = 14: RSI length
high = 70: Overbought above
low = 30: Oversold below

Test this pattern on PIONDIST

Bollinger squeeze, then a break · reading up or down · any candleThe bands had narrowed to their tightest in a while, then the close left them. Read as a quiet stretch ending.

Compute Bollinger bands: SMA(n) ± k × standard deviation of the last n closes; bandwidth = (upper − lower) / middle.
Squeeze: the smallest bandwidth in the last 6 candles is within 5% of the smallest over the last `squeeze` candles.
The pattern completes on a candle that closes above the upper band having been at or below it the candle before (up), or the mirror below the lower band (down), while squeezed.

n = 20: Band length
k = 2: Standard deviations
squeeze = 60: Tightest in this many candles

Test this pattern on PIONDIST

Trend and waves

The fitted trend line and the swing count. A wave count is a reading of the swings, not a prophecy.

Trend line: slope, length, strength · reading up or down · any candleThe straight-line fit through the last N closes: how steep, how long, how clean. This is the slope/length/strength reading (R6) and a version of the 20-candle rule that fires on a clean run even when one close in the middle dipped.

Fit a least-squares line through the last N closes (x = candle index).
Slope % = slope / mean close × 100, per candle. R² = share of the variance the line explains (1 = a ruler, 0 = chop).
Length = candles since the window's low (for a rising line) or high (falling). Magnitude = % from that extreme to the last close.
Continuing = the last close is on the slope's side of the fitted line, or the last three closes all moved with the slope.
The pattern completes when |slope %| ≥ min_slope_pct and R² ≥ min_r2; consecutive qualifying candles count once, at the first.
Progress always reports the current slope, R², length, magnitude and whether it is continuing.

n = 20: Candles in the fit (N)
min_slope_pct = 0.25: Minimum slope, % per candle
min_r2 = 0.8: Minimum R²

Test this pattern on PIONDIST

Impulse wave (five swings, Elliott-style) · reading up or down · any candleFive alternating swings that obey the three classical impulse rules. A count, not a prophecy: the same swings can be counted more than one way, and this is the plain mechanical reading.

Find swings with the zigzag at swing_pct.
Take six consecutive confirmed pivots L-H-L-H-L-H (up) or H-L-H-L-H-L (down).
Rule 1: wave 2 does not retrace past the start of wave 1.
Rule 2: wave 3 is not the shortest of waves 1, 3 and 5.
Rule 3: wave 4 does not enter the price territory of wave 1.
Each wave must make progress: 3 beyond 1, 5 beyond 3.
The pattern completes when the sixth pivot is confirmed. Progress reports 'wave 5 under way' when the first five pivots hold and the live swing is the fifth wave.

swing_pct = 4: Minimum swing size, %

Test this pattern on PIONDIST

Multi-candle shapes

Two- and three-candle shapes from the classical catalogue.

Bullish engulfing · reading up · any candleA down candle followed by an up candle whose body covers it, after a decline. Read as the decline being rejected in one candle.

Take two consecutive candles.
First closes below its open; second closes above its open.
Second's open ≤ first's close and second's close ≥ first's open (its body covers the first's body).
Context: the net move over the `context` candles before the pair is negative (set 0 to skip).

context = 5: Decline measured over this many candles before

Test this pattern on PIONDIST

Bearish engulfing · reading down · any candleAn up candle followed by a down candle whose body covers it, after a rise.

Take two consecutive candles.
First closes above its open; second closes below its open.
Second's open ≥ first's close and second's close ≤ first's open.
Context: the net move over the `context` candles before the pair is positive (set 0 to skip).

context = 5: Rise measured over this many candles before

Test this pattern on PIONDIST

Morning star · reading up · any candleA long down candle, a small-bodied candle, then an up candle closing above the midpoint of the first. Read as a decline stalling and turning.

Take three consecutive candles.
First: a down candle with a body at least the average body of the ten candles before it.
Second: a body no bigger than small_pct of the first's body.
Third: an up candle closing above the midpoint of the first candle's body.

small_pct = 30: Middle candle body, % of the first's

Test this pattern on PIONDIST

Evening star · reading down · any candleA long up candle, a small-bodied candle, then a down candle closing below the midpoint of the first.

Take three consecutive candles.
First: an up candle with a body at least the average body of the ten candles before it.
Second: a body no bigger than small_pct of the first's body.
Third: a down candle closing below the midpoint of the first candle's body.

small_pct = 30: Middle candle body, % of the first's

Test this pattern on PIONDIST

Three white soldiers · reading up · any candleThree up candles in a row, each opening inside the previous body and closing higher, with little upper wick.

Take three consecutive candles, all closing above their opens.
Each close above the previous close.
Each open inside the previous candle's body.
Each upper wick no more than wick_pct of its body.

wick_pct = 30: Maximum upper wick, % of body

Test this pattern on PIONDIST

Three black crows · reading down · any candleThree down candles in a row, each opening inside the previous body and closing lower, with little lower wick.

Take three consecutive candles, all closing below their opens.
Each close below the previous close.
Each open inside the previous candle's body.
Each lower wick no more than wick_pct of its body.

wick_pct = 30: Maximum lower wick, % of body

Test this pattern on PIONDIST

Single-candle shapes

One candle's body and wicks. Weak on their own; shown with what followed on this name.

Doji · reading neutral · any candleOpen and close almost equal: the candle ranged but ended where it began. Read as indecision.

Body = |close − open|; range = high − low.
The pattern completes when range > 0 and body ≤ body_pct of the range.

body_pct = 10: Body no more than this % of the range

Test this pattern on PIONDIST

Hammer · reading up · any candleA long lower wick and a small body near the top, after a decline: the candle went well below and was pulled back up. Read as a low being rejected.

Lower wick ≥ wick_times × body.
Upper wick ≤ other_wick_pct of the range.
Context: the net move over the `context` candles before is negative (set 0 to skip).
The wick's low is reported as the level rejected.

wick_times = 2: Lower wick at least this many × body
other_wick_pct = 15: Upper wick at most this % of range
context = 5: Decline measured over this many candles before

Test this pattern on PIONDIST

Shooting star · reading down · any candleA long upper wick and a small body near the bottom, after a rise: the candle went well above and was pushed back down. Read as a high being rejected.

Upper wick ≥ wick_times × body.
Lower wick ≤ other_wick_pct of the range.
Context: the net move over the `context` candles before is positive (set 0 to skip).
The wick's high is reported as the level rejected.

wick_times = 2: Upper wick at least this many × body
other_wick_pct = 15: Lower wick at most this % of range
context = 5: Rise measured over this many candles before

Test this pattern on PIONDIST

Marubozu · reading up or down · any candleAlmost no wicks: the candle opened at one end of its range and closed at the other. Read as one side in control for the whole candle.

Body = |close − open|; range = high − low.
The pattern completes when range > 0 and body ≥ body_pct of the range.
Direction is the candle's colour.

body_pct = 90: Body at least this % of the range

Test this pattern on PIONDIST

Indicator definitions: SMA(n) is the mean of the last n closes. RSI(n) is Wilder's — average gain over average loss, smoothed by (previous × (n−1) + now) / n. ATR(n) is the Wilder-smoothed mean of the true range. Bollinger bands are SMA(n) ± k standard deviations of the same n closes. VWAP is Σ(typical price × volume) / Σ volume within the session, typical price = (high + low + close) / 3. The trend line is ordinary least squares on close against candle index. Swings come from a zigzag that confirms a pivot once price has moved the swing size against it.