Rozpocznij
PINE LIBRARY

HtfCandle

320
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:
  1. Checks whether a new bar started on the selected timeframe.
  2. Updates running HTF bucket extremes using prior confirmed bar data.
  3. Finalizes the previous HTF candle when timeframe transition occurs.
  4. 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
  1. Initialize options once with desired timeframe and lookback length.
  2. Initialize state once.
  3. Call update(state, opts) on each bar.
  4. 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.

Biblioteka Pine

W zgodzie z duchem TradingView autor opublikował ten kod Pine jako bibliotekę open-source, aby inni programiści Pine z naszej społeczności mogli go ponownie wykorzystać. Ukłony dla autora. Można korzystać z tej biblioteki prywatnie lub w innych publikacjach open-source, jednak ponowne wykorzystanie tego kodu w publikacjach podlega Zasadom serwisu.

amreshsharma007
bar_types

Wyłączenie odpowiedzialności

Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.
bar_types

Biblioteka Pine

W zgodzie z duchem TradingView autor opublikował ten kod Pine jako bibliotekę open-source, aby inni programiści Pine z naszej społeczności mogli go ponownie wykorzystać. Ukłony dla autora. Można korzystać z tej biblioteki prywatnie lub w innych publikacjach open-source, jednak ponowne wykorzystanie tego kodu w publikacjach podlega Zasadom serwisu.

amreshsharma007

Wyłączenie odpowiedzialności

Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.