Charting tools for forex and gold traders

Five candle shapes, named in plain words.

Candle Reader is a charting indicator that names five well-known candle shapes on your chart the moment the candle closes: engulfing, long wick (low or high), inside, outside and doji. The label says only what the candle did, for example that its body covers the whole body of the previous candle, and the exact numeric rule behind every shape is written down and can be changed in the settings. A small panel shows the last pattern with its meaning in one sentence and a plain count of each pattern over the last 100 candles. It does not say what a shape means for the price and it gives no buy or sell signals: it shows the picture, and you make the decision. You get the TradingView version (Pine Script) and the cTrader version (indicator file and C# source).

  • Five candle shapes, named when they close
  • TradingView and cTrader
  • No buy or sell signals
  • No promise of profit

US$17 per month, or US$179 per year · Educational charting tool, not financial advice.

Candle Reader on a TradingView EURUSD M15 chart: small candle-shape labels on the candles at the right and a panel at the top right with the last pattern and counts of each pattern
The indicator on a EURUSD M15 chart (TradingView version, November 2026).

What it does

Learn to read candles, with the rule shown.

Candle names are easy to mix up, and two people rarely agree on what counts as a doji or a long wick. Candle Reader uses fixed, written numeric rules, labels a candle only after it has closed, and shows the one-sentence meaning of the last pattern in a panel, so you can see why a label is there. It does not say what a shape means for the price, it does not predict anything and it never says what to trade.

Five shapes, named when they close

Engulfing, long wick (low or high), inside, outside and doji. A label appears next to a candle only after that candle has closed, so it never appears and disappears while a candle is still forming.

The rule is written down

Every shape has a numeric rule you can read in the guide and change in the settings, for example: a doji is a candle whose body is at most 10% of its range. Nothing is a black box.

Tiny candles are skipped

A candle smaller than 0.5 ATR (average true range, 14 candles; both are settings) is not labelled, so small noise candles do not fill the chart.

A panel in plain words

The last pattern with how many candles ago it closed and its meaning in one sentence, and a plain count of each pattern over the last 100 candles (a setting). The counts are only occurrences, not results.

Settings you can change

Switch each pattern on or off, change the numbers of the rules, choose how many recent candles are labelled (40 by default), the count window and where the panel sits.

An information-only alert

An alert for each shape, saying only that a candle of that shape closed on the symbol. It never tells you to buy or sell.

The words

Five terms, in plain words.

Engulfing

The candle's body covers the whole body of the previous candle, is bigger than it, and the two candles closed in opposite directions. The panel says "up-close" or "down-close", not bullish or bearish.

Long wick

One wick is at least 2 times the body and at least 60% of the candle's range, and the other wick is at most 20% of the range. The label says which side the long wick is on.

Inside / outside

An inside candle lies inside the previous candle's range. An outside candle's high is above the previous high and its low is below the previous low.

Doji

A candle whose body (open to close) is at most 10% of its range: open and close are almost the same.

ATR

Average true range, the usual size of a candle on that chart. Candles smaller than half of it are skipped.

How it works

Three steps.

  1. Add it to your chart

    Paste the Pine script into TradingView, or install the indicator file in cTrader. A free TradingView account is enough, because it takes one indicator slot.

  2. Open any forex or gold chart

    It uses the candles of the chart you have open, so it works on any symbol. Pick a timeframe such as M15 or H1 and, if you like, change the rules or the patterns.

  3. Read the labels

    Look at the labels and the panel before you decide anything. The indicator never places trades and never says what to trade.

On the chart

Real screenshots.

TradingView screenshot of Candle Reader on EURUSD M15: small grey candle-shape labels on the candles at the right of the chart and a panel at the top right saying the last pattern was an engulfing candle, with counts of each pattern over the last 100 candles
Screenshot of the TradingView version on EURUSD (ICE), M15, 18 November 2026, with the default settings. The panel says the last pattern was an engulfing (up-close) candle 5 candles ago, with the plain meaning, and counts 14 engulfing, 11 long wick, 14 inside, 8 outside and 9 doji over the last 100 candles. The labels on the right are crowded where many candles in a row print a pattern. Counts are only occurrences; a label names a candle that has already closed and does not predict what comes next.
Candle Reader running in cTrader on an XAUUSD H1 chart: short labels on the candles at the right of the chart and a panel at the top right saying the last pattern was an inside candle with counts of each pattern
The cTrader version on XAUUSD, H1, 18 November 2026 (Spotware demo feed). The panel says the last pattern was an inside candle, 0 candles ago, with its plain meaning, and counts 9 engulfing, 12 long wick, 14 inside, 11 outside and 8 doji over the last 100 candles. On the same stretch TradingView counted 11 / 11 / 15 / 12 / 7 on its own feed, so counts differ a little between platforms. Labels are crowded on busy stretches. Example only, not a signal.

What you get

One bundle, both platforms.

  • TradingView: the Pine Script file (candle-reader.pine) and an install guide.
  • cTrader: the indicator file (CandleReader.algo), the C# source code and an install guide.
  • The licence terms: personal use on your own accounts, no resale, no sharing.
  • Updates while your plan is active. A file you already downloaded stays yours under the licence.

Honest limits

What it does not do.

  • It is not a signals service and it does not tell you when to buy or sell. A label names the shape of a candle that has already closed.
  • It does not say what a shape means for the price, it does not call anything bullish, bearish or a reversal, and it does not count how often a pattern "worked". The counts in the panel are only occurrences.
  • It does not place trades and it is not an automated trading robot (EA). It marks no entry, stop or target.
  • Labels can be crowded where many candles in a row print a pattern; only the last 40 candles are labelled by default for that reason. On a busy stretch several labels can overlap.
  • Five shapes only. It does not look for three-candle patterns, trends or other patterns.
  • Different brokers and data feeds print slightly different candles, so the shapes and counts can differ. On the same stretch of XAUUSD H1 the panel counts of the two platforms were close but not identical (engulfing / long wick / inside / outside / doji: TradingView 11 / 11 / 15 / 12 / 7, cTrader 9 / 12 / 14 / 11 / 8 over the last 100 candles).
  • Checked on EURUSD M15 and XAUUSD H1 in TradingView, and on XAUUSD H1 in cTrader. A hand check of five real examples per pattern on the chart was not done; the rules of the cTrader version are pinned by 50 unit checks on fixed candles. Other markets, timeframes and brokers were not tested.
  • The cTrader popup alert was not tested live, and no TradingView alert was fired during testing.
  • No profit, win rate or past result is promised or shown here. Trading is risky and you can lose money.

Plans

Pay by the month or by the year.

Both plans include the TradingView and cTrader versions and updates while the plan is active. Nothing renews or charges by itself.

Monthly

US$17 per month · about AED 62

  • TradingView and cTrader versions
  • Updates while the plan is paid
  • Paid in advance by PayPal or bank transfer

Yearly

US$179 per year · about AED 657

  • TradingView and cTrader versions
  • A full year of updates
  • Paid in advance by PayPal or bank transfer

The licence allows personal use on your own accounts. No resale and no sharing. Refunds: if the files will not load and we cannot fix it, you can ask within 7 days of purchase.

How buying works

  1. Message us

    Choose a plan and send a WhatsApp message with the button on this page.

  2. Pay

    Pay by PayPal or bank transfer. Nothing is charged automatically.

  3. Get the bundle

    After payment is confirmed you receive the download link and the install guide.

  4. Monthly or yearly

    For the monthly plan, send the next payment before the month ends to keep updates. Nothing renews by itself.

Requirements

Will it work on my setup?

PlatformTradingView (Pine Script v6; a free account works within its limit on indicators per chart) or cTrader (indicator file, run in cTrader 5.10.22).
ChartAny symbol and timeframe. It was checked on EURUSD on the 15-minute chart and gold on the 1-hour chart in TradingView, and on gold on the 1-hour chart in cTrader.
DataOnly the candles of the chart you have open. It does not read other symbols or timeframes.
DeliveryAfter your payment is confirmed you receive a download link for the bundle by WhatsApp or email.

Questions

What people ask before they buy.

Is it a signals indicator?

No. It names the shape of a candle after the candle has closed. It does not say what the shape means for the price and it does not say when to buy or sell. You make every decision yourself.

Which shapes does it name?

Five: engulfing, long wick (the label says low or high), inside, outside and doji. A candle can carry more than one label, for example engulfing and outside together.

What exactly is the rule for each shape?

Engulfing: the body covers the whole body of the previous candle, is bigger, and the two candles closed in opposite directions. Long wick: one wick is at least 2 times the body and at least 60% of the range, and the other wick is at most 20% of the range (a candle where both wicks qualify gets no long-wick label). Inside: high not above the previous high, low not below the previous low, and a smaller range. Outside: high above the previous high and low below the previous low. Doji: body at most 10% of the range. The numbers are settings.

Does it repaint?

Every decision is made on a closed candle, so a label never appears and disappears while a candle is forming. Closed candles do not change afterwards.

Does it tell me how often a pattern worked?

No. The panel only counts how many times each shape closed over the last 100 candles (a setting). It says nothing about what happened afterwards, and no result, win rate or accuracy figure is shown anywhere.

Why are some labels crowded or overlapping?

Where many candles in a row print a pattern, the short labels sit close together and can overlap. Only the last 40 candles are labelled by default (a setting) to limit this. The panel counts and the label tooltips in TradingView still use the full names.

Do the cTrader and TradingView versions show the same thing?

They follow the same rules and the same panel rows. Prices come from each platform's own data, so brokers print slightly different candles and the counts can differ a little. On the same stretch of XAUUSD H1 the counts were close but not identical (engulfing / long wick / inside / outside / doji: TradingView 11 / 11 / 15 / 12 / 7, cTrader 9 / 12 / 14 / 11 / 8). The cTrader labels show the short names only; the full names and meanings are in the panel.

Which markets and timeframes does it work on?

It was checked on EURUSD on the 15-minute chart and gold (XAUUSD) on the 1-hour chart in TradingView, and on gold on the 1-hour chart in cTrader. It uses the candles of the open chart, so it also runs on other symbols and timeframes, but those were not tested.

Do I need a paid TradingView plan?

No. You paste the script into your own TradingView account. A free account is enough, within its limit on indicators per chart.

What if it will not load on my account?

Message us. If the files will not load on TradingView or cTrader and we cannot fix it, you can ask for a refund within 7 days of purchase.

Candle Reader is an educational charting tool. It is not financial advice, not a signals service and it makes no promise of profit. Trading is risky and you can lose money.

Want the candle shapes named on your chart?

Pick a plan and message us on WhatsApp. US$17 per month or US$179 per year.