Skip to content
Home » Posts » Documentation » HTF Candles

HTF Candles

Overview

This indicator was inspired by the work of informanerd in the script called “HTF Candles” as well as the built-in script called “Multi-Time Period Charts” by TradingView. The script will provide a highly customizable interface to specify the higher timeframe resolution for the candlesticks , the type of candle, as well as various styling options for the body, borders and wicks.

Check it out on TradingView… 🡵

Indicator Anatomy

Figure 1 – Indicator Anatomy

Indicator Settings

[No heading]

Figure 2 – Version Section

Version

The version input is for displaying the published version of the indicator. It is intended to be for informational use only.

Candle Settings

Figure 3 – Candle Settings Section

Timeframe

Defines the higher timeframe for the candlestick dimensions to overlayed onto the chart. When the Chart option is chosen, the indicator will attempt to find a higher timeframe to ensure the candlesticks are drawn.

Current Chart’s TimeframeHigher Timeframe Default
Seconds1 minute
Minutes ( < 60 )1 hour
Hours1 day
Daily1 week
Monthly ( < 6 )6 months
Monthly ( > 6 )1 year

Show Label

When checked, the timeframe value will display on the last bar.

Figure 4 – Show Label Example

Custom

When checked, the higher timeframe candlesticks will use the provided custom timeframe value instead.

The following are the multiplier limitations by period:

PeriodLimitation
min(s)cannot be greater than 60
hour(s)cannot be greater than 24
day(s)cannot be greater than 365
week(s)cannot be greater than 52
month(s)cannot be greater than 12

Candle Type

Sets the candle type to draw. Possible options are:

  • Candles – draws a normal candlestick with the market’s open, high, low, and close prices.
  • Heiken Ashi – draws candlesticks using the Heiken Ashi formula.
  • Bars – draws vertical lines reflecting the highest and lowest price with small horizontal line on the left side of the main vertical representing the opening price and a small horizontal line on the right side representing the closing price.

Offset

Shifts the candlesticks either to the left or to the right for the given number of bars. The minimum value is -500 and the maximum value is 500.

Visible Chart Only Mode

Renders the candlesticks only the visible chart area. Since the chart’s rendering engine is limited to 500 candlesticks that can be rendered on any given chart, this can be very useful as you navigate into the chart’s history and keep seeing the HTF candles.

Candle Style & Content

Figure 5 – Candle Style & Content Section

Body

When checked, it will set the body fill color for the rising and falling candlesticks.

Borders / Width

When checked, it will set the body border color for the rising and falling candlesticks as well as the line width. The minimum value is 1 and the maximum value is 10.

Wick / Width

When checked, it will set the wick color for the rising and falling candlesticks as well as the line width. The minimum value is 1 and the maximum value is 10.

Line Style

Sets the line style for both the candlestick body and wicks. Possible options are:

  • Solid
  • Dotted
  • Dashed

Time to Close

When checked, the time remaining to candle close will display within the body of the candle.

Position

Aligns the Time to Close text within the candlestick body. Possible options are:

  • top, center, bottom – The vertical alignment
  • left, center, right – The horizontal alignment

Text Size

Sets the font size of the Time to Close text within the candlestick body. Possible options are:

  • tiny
  • small
  • normal
  • large
  • huge

Bar Style & Content

Figure 6 – Bar Style & Content Section

Bar Style / Width

Set the line color for the rising and falling bars as well as the line width. The minimum value is 1 and the maximum value is 10.

HLC Bars

When checked, only the high/low, and close bars are drawn.

Show “Time to close” in “Timeframe” label

When checked, the time remaining to candle close will display beneath the timeframe label text. This will require that the `Show Label` checkbox be checked to see the time.

Figure 7 – Time to Close inside the Timeframe Label Example

Send me an email when this page has been updated

Leave a Reply

Your email address will not be published. Required fields are marked *