HTF Candles by Prosum Solutions

Overview of Features

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.

Usage Information

The indicator can be applied to any chart at any time frame, but resolutions less than 1 minute may demonstrate gaps between bars and the candles may not render properly.

When the "Same as chart" option is chosen for the "Resolution" field, the indicator will attempt to find a higher timeframe resolution to ensure the candlesticks are drawn.

Enjoy! 👍

Catatan Rilis:

v1.0.1 - Patch Release

New features and fixes in this release:

• Added a new "Show Label" checkbox to display the resolution value as a label on the last candle.
  
• Fixed a defect where the HTF candle was not drawing when the time is on the boundary of the HTF resolution.
  
• Fixed a defect where the using the 12H timeframe would not render the candles properly.
  
• Renamed the "Candle" option to "Normal" for the "Candle Type" input.
  
• Update emoji placement in color inputs.
  
• Update the maximum values of the width inputs from 5 to 10.
  

Catatan Rilis:

v1.0.2 - Patch Release

New features in this release:

• Added validation on the "Resolution" input value and display an error message if the value is not higher than the current chart resolution.
  
• Enhanced the value of the resolution label to include the units of either "minutes", "hours", "days", "weeks", or "months".
  

Catatan Rilis:

v1.0.3 - Patch Release

New fixes in this release:

• Addressing a possible repaint issue by removing the High, Low, and Close plots for the Data Window.
  

Catatan Rilis:

v1.0.4 - Patch Release

New features and fixes in this release:

• Converted the Pine Script code to version 5.
  
• Fixed a defect where the right-side candle boundary would end in the center of the new HTF resolution. There will now be a one candle width spacing between HTF candles.
  

Catatan Rilis:

v1.0.5 - Patch Release

New features and fixes in this release:

• Added a new "Offset" input to shift the candlesticks either to the left or to the right for the given number of bars.
  
• Added a new "Time to close" checkbox, position, and text-size options for the time to close text inside the candle body.
  
• Fixed a defect where the candles were not rendering properly on charts that have defined trading sessions less than 24 hours.
  
• Fixed a defect where disabling the body color of the HTF candles would remove the timeframe label frame.
  
• Fixed a defect where disabling the border color of the HTF candles would remove the timeframe label text.
  
• Improved rendering performance by not deleting and recreating boxes, lines, and labels on every tick.
  
• Removed the error label that displays when the timeframe of the chart is greater than the indicator timeframe in favor of the new `runtime.error()` function.
  
• Removed the custom `stringEndsWith()` function in favor of the new `str.endswith()` function.
  
• Renamed the "Resolution" input to "Timeframe" to conform to the terminology in TradingView and Pine Script. This includes tool tips and code variable names.
  

Catatan Rilis:

v1.0.6 - Patch Release

New features and fixes in this release:

• Added a new "Custom" timeframe checkbox and two inputs to define a custom multiplier and period values for the HTF candles.
  
• Added a new "Visible Chart Only Mode" checkbox to enable drawing candles on the visible portion of the chart only.
  
• Fixed a defect when using extremely high timeframes relative to the current chart would cause a study error: 'Objects... cannot be drawn further than 500 bars into the future'.
  
• Fixed a defect where the "Time to close" label text color was not matching the candle color when the direction of the real-time candle would change from rising to falling or vice versa.
  
• Grouped the "Timeframe", "Custom", "Candle Type", and "Offset" inputs into their own section called "CANDLE SETTINGS"
  
• Removed the use of the 12 hour timeframe when choosing a timeframe higher than 60 minutes in order to default to daily instead. Comments for the determineDefaultTimeframe() function were updated to clarify the logic.
  
• Renamed the "CANDLE STYLE" section to "CANDLE STYLE & CONTENT".
  
• Updated the convertTimeLeftToCloseToLabelText() function to include the number of months, weeks, and days remaining in the time to close value (when available).
  

Catatan Rilis:

v1.0.7 - Patch Release

New features and fixes in this release:

• Fixed a defect where the Time to Close content was not printing on the first candle of the period.
  

Catatan Rilis:

v1.0.8 - Patch Release

New features and fixes in this release:

• Fixed a defect where the `request.security()` function does not return data on the `TVC:SPX` weekly chart and gives an inaccurate runtime error message.
  

Catatan Rilis:

v1.0.9 - Patch Release

New features and fixes in this release:

• Added support for "Bars" as a "Candle Type" option.
  
• Added the new "BAR STYLE & CONTENT" section with inputs to define the bar styles and content.
  
• Renamed the "Normal" option to "Candles" for the "Candle Type" input.
  
• Replaced the "🎨" emoji with "▲" and "▼" characters for the rising and falling color selectors.
  

Catatan Rilis:

v1.0.10 - Patch Release

New features and fixes in this release:

• Added tool tip content to the "Visible Chart Only Mode" check-box.
  
• Fixed a defect where some specific Forex markets (e.g. FX:GBPJPY) would not supply monthly high timeframe data using the `request.security()` function on the first bar index (0), therefore a runtime error was raised prematurely.
  
• Fixed a defect where the candle wick lines were being rendered when the "Candle Type" is "Bars". This should allow for more bars to render since lines are limited to 500 total.
  

Catatan Rilis:

v1.0.11 - Patch Release

New features and fixes in this release:

• Added support for "Equilibrium Price Line" and a new section with inputs to define the line style.
  
• Added the "HTF Equilibrium" data point to the Data Window to see the price value as you hover your mouse over the candles.
  
• Fixed a defect where a few of the font icons that do not render on macOS.
  

Catatan Rilis:

v1.1.0 - Minor Release

New features and fixes in this release:

• Added "HTF Setting Code" data point to link other indicators like the "HTF Volume by Prosum Solutions" to automatically respond to the "Timeframe" setting value.
  
• Fixed a defect where the `request.security()` function does not return data for the `EIGHTCAP:XAUUSD` symbol on March 13, 2023 for about 5 consecutive candles with a chart timeframe of 30 minute using the 4 hour High Timeframe setting in the indicator.
  
• Fixed some spelling errors.