PINE LIBRARY

HtfCandle

Overview
HtfCandle is a utility library for building higher-timeframe (HTF) candle data from lower-timeframe chart bars.

It provides:

Current finalized HTF candle values
Previous finalized HTF candle values
HTF high/low and body high/low rolling history helpers
High/low timestamp tracking inside each finalized HTF candle

What this library solves
When strategy/indicator logic is executed on lower timeframes, this library helps maintain HTF candle structure in a stateful and reusable way.

How this differs from request.security

request.security can provide HTF OHLC series aligned to the chart context, but it does not directly expose the exact intrabar timestamp where the HTF high or HTF low occurred.
HtfCandle maintains explicit highTime and lowTime fields for each finalized HTF candle.
This is useful when downstream logic needs both HTF level values and the precise event time of those extremes.

Core behavior
On each bar, the library:

Checks whether a new bar started on the selected timeframe.
Updates running HTF bucket extremes using prior confirmed bar data.
Finalizes the previous HTF candle when timeframe transition occurs.
Stores finalized HTF values into rolling history arrays.

Public API

initCandle(): Creates an empty candle object.
initOpts(timeframe, numCandles): Creates options with target timeframe and history size.
initState(opts): Creates runtime state and history arrays.
update(state, opts): Processes candle state per bar.
highest(state): Highest finalized HTF high from history window.
lowest(state): Lowest finalized HTF low from history window.
bodyHighest(state): Highest finalized HTF body high from history window.
bodyLowest(state): Lowest finalized HTF body low from history window.

How to use

Initialize options once with desired timeframe and lookback length.
Initialize state once.
Call update(state, opts) on each bar.
Read finalized values from state.candle, state.candle1, and helper methods.

Notes and limitations

This is a technical utility library only; it does not generate trading signals or place orders.
Output depends on chart data quality and symbol session behavior.
At startup, history-dependent helpers can return na until enough finalized HTF candles are collected.
Users should validate behavior on their own symbols/timeframes before live usage.

Source visibility
This publication is prepared for protected-source distribution.
The description documents behavior and API to allow practical usage without source visibility.

Disclaimer
For technical analysis infrastructure only. Not investment advice.

파인 라이브러리

트레이딩뷰의 진정한 정신에 따라, 작성자는 이 파인 코드를 오픈소스 라이브러리로 게시하여 커뮤니티의 다른 파인 프로그래머들이 재사용할 수 있도록 했습니다. 작성자에게 경의를 표합니다! 이 라이브러리는 개인적으로 사용하거나 다른 오픈소스 게시물에서 사용할 수 있지만, 이 코드의 게시물 내 재사용은 하우스 룰에 따라 규제됩니다.

amreshsharma007

면책사항

해당 정보와 게시물은 금융, 투자, 트레이딩 또는 기타 유형의 조언이나 권장 사항으로 간주되지 않으며, 트레이딩뷰에서 제공하거나 보증하는 것이 아닙니다. 자세한 내용은 이용 약관을 참조하세요.

파인 라이브러리

amreshsharma007