Market Structure Multi-timeframe (HuntsPip)

Market Structure Multi-timeframe (HuntsPip) tracks breaks of market structure across three timeframes simultaneously - higher, mid, and chart - with persistent swing level lines, BOS/CHoCH labels, and a summary table showing trend direction and retracement depth for each timeframe. It gives traders a complete top-down structural view by aligning market structure across multiple timeframes on a single chart, making it easy to identify high-probability setups where all three timeframes converge in directional agreement while monitoring how deeply price has retraced within each timeframe's swing range for precise entry timing.

────────────────────

█ CONCEPTS

Market structure analysis examines the sequence of swing highs and swing lows to determine trend direction. A Break of Structure (BOS) occurs when price continues beyond a prior swing point in the direction of the existing trend, while a Change of Character (CHoCH) occurs when price breaks a swing level against the prevailing trend, potentially signaling a shift.

Viewing market structure across multiple timeframes adds depth to this analysis. A higher timeframe establishes the broader directional bias, a mid timeframe provides intermediate context, and the chart timeframe offers the most granular structural detail. When structure across all three timeframes aligns, some traders interpret this as stronger directional conviction. When they diverge, it may indicate transitional conditions or potential reversals forming from the lower timeframes upward.


────────────────────

█ WHAT IT DOES

This tool runs market structure detection independently on three timeframes: a configurable higher timeframe (HTF), a configurable mid timeframe (MTF), and the current chart timeframe (LTF). For the chart timeframe, BOS and CHoCH labels are drawn at each structural break as historical markers. For the HTF and MTF, the tool draws persistent horizontal lines at the current swing high and swing low, with price labels at the end of each line, so traders can see the active structural levels for each timeframe at all times.

An optional table in a configurable corner of the chart summarizes the state of all three timeframes. Each row shows the timeframe label, current trend direction (bullish or bearish), the type of the last structural break (BOS or CHoCH), and the current retracement percentage within the active swing range. The table updates in real time as structure evolves. If the timeframes are configured incorrectly (HTF must be greater than MTF, which must be greater than the chart timeframe), an error message is displayed.


────────────────────

█ FEATURES AND USAGE

The HTF, MTF, and LTF settings groups share the same layout. Each group controls structure detection for its respective timeframe with identical setting types.

HTF MARKET STRUCTURE (MS) SETTINGS

• Toggle and Higher Timeframe (HTF) - Enables or disables the HTF structure layer and selects the timeframe. The detection mode is set alongside it.
    - Conservative - Requires a candle close beyond the swing level.
    - Aggressive - Triggers on any high or low beyond the swing level, including wicks.
  
  
• Line Style and Width - Controls the visual style and thickness of the HTF swing level lines.
  
  
• Label Size and Show - Controls the size of the price labels at the end of swing level lines and toggles them on or off.
  
  
• Colors - Two color pickers for bullish and bearish swing level lines and labels.
  

MTF MARKET STRUCTURE (MS) SETTINGS

Same settings layout as the HTF group, applied to the mid timeframe.

• Toggle and Mid Timeframe (MTF) - Enables or disables the MTF structure layer and selects the timeframe and detection mode.
  
  
• Line Style and Width - Controls the MTF swing level line appearance.
  
  
• Label Size and Show - Controls MTF price labels.
  
  
• Colors - Two color pickers for bullish and bearish.
  

LTF MARKET STRUCTURE (MS) SETTINGS

Same settings layout, applied to the chart timeframe. Instead of drawing persistent swing level lines, this layer draws BOS and CHoCH labels at each structural break.

• Toggle and Lower Timeframe (Chart) - Enables or disables the chart timeframe structure labels and selects the detection mode.
  
  
• Line Style and Width - Controls the appearance of the structural break lines.
  
  
• Label Size and Show - Controls the BOS/CHoCH label size and toggles them on or off.
  
  
• Colors - Two color pickers for bullish and bearish.
  

MARKET STRUCTURE TABLE ANALYSIS

• Structure Table - Toggles the summary table on or off. A dropdown next to it selects the table position on the chart.
    - Top Left, Top Right, Bottom Left, or Bottom Right.
  
  
• Size - Controls the text size within the table.
    - Tiny, Small, Normal, or Large.
  

This tool works on any instrument and any timeframe, provided the HTF is set higher than the MTF, which must be higher than the chart timeframe. The three layers give traders a top-down view of structure across multiple timeframes without switching charts. The table provides a quick snapshot of trend alignment, and the retracement column shows how far price has pulled back within each swing range. These structural readings are best used as a directional framework alongside other analysis, not as standalone entry triggers.