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
Indicator Settings
[No heading]
Version
The version input is for displaying the published version of the indicator. It is intended to be for informational use only.
Candle Settings
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 Timeframe | Higher Timeframe Default |
|---|---|
| Seconds | 1 minute |
| Minutes ( < 60 ) | 1 hour |
| Hours | 1 day |
| Daily | 1 week |
| Monthly ( < 6 ) | 6 months |
| Monthly ( > 6 ) | 1 year |
Show Label
When checked, the timeframe value will display on the last bar.
Custom
When checked, the higher timeframe candlesticks will use the provided custom timeframe value instead.
The following are the multiplier limitations by period:
| Period | Limitation |
|---|---|
| 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
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
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.
