Get started

Search in scripts for "fair value gap"

Quasimodo PatternWhat is a Quasimodo Pattern? A Quasimodo Pattern is a chart pattern traders look for to predict possible price reversals in the market: - Bullish Quasimodo: Signals a possible price increase (buying opportunity). - Bearish Quasimodo: Signals a potential price decrease (selling opportunity). How the Script Works 1. Bullish Quasimodo: - Checks if the price pattern shows signs of a potential upward movement: - The current low price is higher than a previous price point (suggesting fair value gap). - The previous candle closed higher than it opened (bullish candle). - The candle before that closed lower than it opened (bearish candle). 2. Bearish Quasimodo: - Looks for signs of a downward movement: - The current high price is lower than a previous price point (suggesting fair value gap). - The previous candle closed lower than it opened (bearish candle). - The candle before that closed higher than it opened (bullish candle). Visual Indicators - Yellow Candles: Indicate a bullish Quasimodo pattern. - Pink Candles: Indicate a bearish Quasimodo pattern. Alerts If a Quasimodo pattern is detected, the script sends an alert: - The alert says: "A Quasimodo Pattern has appeared!" Purpose Traders can use this tool to quickly spot potential trend changes without manually analyzing every chart, saving time and improving decision-making for trades.
Pine Script® indicator
by anodrr2
ICT Judas Swing | Flux Charts💎 GENERAL OVERVIEW Introducing our new ICT Judas Swing Indicator! This indicator is built around the ICT's "Judas Swing" strategy. The strategy looks for a liquidity grab around NY 9:30 session and a Fair Value Gap for entry confirmation. For more information about the process, check the "HOW DOES IT WORK" section. Features of the new ICT Judas Swing : Implementation of ICT's Judas Swing Strategy 2 Different TP / SL Methods Customizable Execution Settings Customizable Backtesting Dashboard Alerts for Buy, Sell, TP & SL Signals 📌 HOW DOES IT WORK ? The strategy begins by identifying the New York session from 9:30 to 9:45 and marking recent liquidity zones. These liquidity zones are determined by locating high and low pivot points: buyside liquidity zones are identified using high pivots that haven't been invalidated, while sellside liquidity zones are found using low pivots. A break of either buyside or sellside liquidity must occur during the 9:30-9:45 session, which is interpreted as a liquidity grab by smart money. The strategy assumes that after this liquidity grab, the price will reverse and move in the opposite direction. For entry confirmation, a fair value gap (FVG) in the opposite direction of the liquidity grab is required. A buyside liquidity grab calls for a bearish FVG, while a sellside grab requires a bullish FVG. Based on the type of FVG—bullish for buys and bearish for sells—the indicator will then generate a Buy or Sell signal. After the Buy or Sell signal, the indicator immediately draws the take-profit (TP) and stop-loss (SL) targets. The indicator has three different TP & SL modes, explained in the "Settings" section of this write-up. You can set up alerts for entry and TP & SL signals, and also check the current performance of the indicator and adjust the settings accordingly to the current ticker using the backtesting dashboard. 🚩 UNIQUENESS This indicator is an all-in-one suit for the ICT's Judas Swing concept. It's capable of plotting the strategy, giving signals, a backtesting dashboard and alerts feature. Different and customizable algorithm modes will help the trader fine-tune the indicator for the asset they are currently trading. Three different TP / SL modes are available to suit your needs. The backtesting dashboard allows you to see how your settings perform in the current ticker. You can also set up alerts to get informed when the strategy is executable for different tickers. ⚙️ SETTINGS 1. General Configuration Swing Length -> The swing length for pivot detection. Higher settings will result in FVG Detection Sensitivity -> You may select between Low, Normal, High or Extreme FVG detection sensitivity. This will essentially determine the size of the spotted FVGs, with lower sensitivies resulting in spotting bigger FVGs, and higher sensitivies resulting in spotting all sizes of FVGs. 2. TP / SL TP / SL Method -> a) Dynamic: The TP / SL zones will be auto-determined by the algorithm based on the Average True Range (ATR) of the current ticker. b) Fixed : You can adjust the exact TP / SL ratios from the settings below. Dynamic Risk -> The risk you're willing to take if "Dynamic" TP / SL Method is selected. Higher risk usually means a better winrate at the cost of losing more if the strategy fails. This setting is has a crucial effect on the performance of the indicator, as different tickers may have different volatility so the indicator may have increased performance when this setting is correctly adjusted.
Pine Script® indicator
by fluxchart
18
Premium Imbalance FinderIntroducing the Premium Imbalances Indicator, a powerful tool designed help traders identify and analyze market imbalances. This advanced indicator offers a comprehensive suite of features to enhance your trading experience and provide valuable insights into market dynamics. Key Features: Fair Value Gap (FVG): Identify price ranges where the market has not achieved fair value, indicating potential imbalances and trading opportunities. Balanced Price Range (BPR): Visualize price ranges where the market has found a balance between supply and demand. Volume Imbalance: Detect areas of significant volume imbalance, highlighting the absence of body volume and potential market inefficiencies. Opening Gap: Identify un-offered price ranges at the opening of a trading session, providing insights into potential market direction. Customizable Display: Adjust the display limit to control the number of imbalance boxes visible on the chart, ensuring a clutter-free and focused view. Mitigation Analysis: Set a mitigation level to determine when an imbalance has been mitigated and track the percentage of mitigation for each imbalance. Higher Timeframe Analysis: Enable the HTF Imbalance feature to analyze imbalances on higher timeframes, providing a broader perspective on market structure. Customizable Appearance: Personalize the colors of imbalance boxes, premium zones, and mid-lines to suit your visual preferences and easily distinguish between bullish and bearish imbalances. Flexible Imbalance Extension: Choose between custom, current, or extended imbalance box display to adapt to your trading style and analysis requirements. Detailed Tooltips: Hover over imbalance labels to view the percentage of mitigation for each imbalance, providing quick and easy access to crucial information. The Premium Imbalances Indicator is suitable for traders of all levels, from beginners to experienced professionals, and can be used across various markets and timeframes. By utilizing this powerful tool, traders can gain a deeper understanding of market dynamics, identify potential trading opportunities, and make more informed decisions based on the analysis of imbalances. The indicator's customizable features and detailed insights make it an essential addition to any trader's toolkit.
Pine Script® indicator
by ClayeWeight
9
HTF FVG and Wick Fill trackingImbalances in the charts are some of the clearest and most traded price areas. Two of the best and most used are fair value gaps FVGs and large candle wicks. In both of these price appears to move in such a way that most are left behind having 'missed' the move. But in reality price will often come back to these price points to re-balance and absorb the liquidity that was left behind. This indicator takes these areas and makes viewing and tracking them clearer than ever. It does this, by first allowing the user to overlay a higher timeframe candle on the current chart. This in itself provides an in depth look at a higher timeframe candle both as it forms and in its final form. Next the indicator identifies either the FVG or large wicks, on the chosen higher timeframe, all while the chart remains on a lower timeframe. As seen here the fair value gaps are clearly highlighted, taken from a 4 hour timeframe, while the actual chart is on 15 minutes. This allows the user even greater accuracy in identifying their key trading areas. Utilizing the indicators unique feature, these areas can optionally be extended forward to the current timeframe and 'filled' in realtime. Areas that are filled to the users defined level, will be removed from the chart. With supplementary settings for how much history to show, how large of a wick should be highlighted and complete control over the colour scheme, users will be able to track and understand the filling of imbalances like never before.
Pine Script® indicator
by Texmoonbeam
11
ICT Silver Bullet [LuxAlgo]The ICT Silver Bullet indicator is inspired from the lectures of "The Inner Circle Trader" (ICT) and highlights the Silver Bullet (SB) window which is a specific 1-hour interval where a Fair Value Gap (FVG) pattern can be formed. When a FVG is formed during the Silver Bullet window, Support & Resistance lines will be drawn at the end of the SB session. There are 3 different Silver Bullet windows (New York local time): The London Open Silver Bullet (3 AM — 4 AM ~ 03:00 — 04:00) The AM Session Silver Bullet (10 AM — 11 AM ~ 10:00 — 11:00) The PM Session Silver Bullet (2 PM — 3 PM ~ 14:00 — 15:00) 🔶 USAGE The ICT Silver Bullet indicator aims to provide users a comprehensive display as similar as possible to how anyone would manually draw the concept on their charts. It's important to use anything below the 15-minute timeframe to ensure proper setups can display. In this section, we are purely using the 3-minute timeframe. In the image below, we can see a bullish setup whereas a FVG was successfully retested during the Silver Bullet session. This was then followed by a move upwards to liquidity as our target. Alternatively, you can also see below a bearish setup utilizing the ICT Silver Bullet indicator outlined. At this moment, the indicator has removed all other FVGs within the Silver Bullet session & has confirmed this FVG as the retested one. There is also a support level marked below to be used as a liquidity target as per the ICT Silver Bullet concept suggests. In the below chart we can see 4 separate consecutive examples of bullish & bearish setups on the 3-minute chart. 🔶 CONCEPTS This technique can visualize potential support/resistance lines, which can be used as targets. The script contains 2 main components: • forming of a Fair Value Gap (FVG) • drawing support/resistance (S/R) lines 🔹 Forming of FVG 1 basic principle: when a FVG at the end of the SB session is not retraced, it will be made invisible. Dependable on the settings, different FVG's will be shown. • 'All FVG': all FVG's are shown, regardless the trend • 'Only FVG's in the same direction of trend': Only FVG's are shown that are similar to the trend at that moment (trend can be visualized by enabling ' Show ' -> ' Trend ')      -> only bearish FVG when the trend is bearish vs. bullish FVG when trend is bullish • 'strict': Besides being similar to the trend, only FVG's are shown when the closing price at the end of the SB session is:      – below the top of the FVG box (bearish FVG)      – above bottom of the FVG box (bullish FVG) • 'super-strict': Besides being similar to the trend, only FVG's are shown when the FVG box is NOT broken      in the opposite direction AND the closing price at the end of the SB session is:      – below bottom of the FVG box (bearish FVG)      – above the top of the FVG box (bullish FVG) ' Super-Strict ' mode resembles ICT lectures the most. 🔹 Drawing support/resistance lines When the SB session has ended, the script draws potential support/resistance lines, again, dependable on the settings. • Previous session (any): S/R lines are fetched between current and previous session.      For example, when current session is ' AM SB Session (10 AM — 11 AM) ', then previous session is      ' London Open SB (3 AM — 4 AM) ', S/R lines between these 2 sessions alone will be included. • Previous session (similar): S/R lines are fetched between current and previous - similar - session.      For example, when current session is ' London Open SB (3 AM — 4 AM)' , only S/R lines between      current session and previous ' London Open SB (3 AM — 4 AM) ' session are included. When a new session starts, S/R lines will be removed, except when enabling ' Keep lines (only in strict mode) ' This is not possible in ' All FVG ' or ' Only FVG's in the same direction of trend ' mode, since the chart would be cluttered. Note that in ' All FVG ' or ' Only FVG's in the same direction of trend ' mode, both, Support/Resistance lines will be shown, while in Strict/Super-Strict mode:      • only Support lines will be shown if a bearish FVG appears      • only Resistance lines if a bullish FVG is shown The lines will still be drawn the the end of the SB session, when a valid FVG appears, but the S/R lines will remain visible and keep being updated until price reaches that line. This publication contains a "Minimum Trade Framework (mTFW)", which represents the best-case expected price delivery, this is not your actual trade entry - exit range.  • 40 ticks for index futures or indices  • 15 pips for Forex pairs. When on ' Strict/Super-Strict ' mode, only S/R lines will be shown which are:    • higher than the lowest FVG bottom + mTFW, in a bullish scenario    • lower than the highest FVG bottom - mTFW, in a bearish scenario When on ' All FVG/Only FVG's in the same direction of trend ' mode, or on non-Forex/Futures/Indices symbols, S/R needs to be higher/lower than SB session high/low. 🔶 SETTINGS (Check CONCEPTS for deeper insights and explanation) 🔹 Swing settings (left): Sets the length, which will set the lookback period/sensitivity of the Zigzag patterns (which directs the trend) 🔹 Silver Bullet Session; Show SB session: show lines and labels of SB session      Labels can be disabled separately in the ' Style ' section, color is set at the ' Inputs ' section. 🔹 FVG      – Mode       • All FVG       • Only FVG's in the same direction of trend       • Strict       • Super-Strict      – Colors      – Extend: extend till last bar of SB session 🔹 Targets – support/resistance lines      – Previous session (any): S/R lines fetched between current and previous SB session      – Previous session (similar): S/R lines fetched between current and previous similar SB session      – Colors      – Keep lines (only in strict mode) 🔹 Show      – MSS ~ Session: Show Market Structure Shift , only when this happens during a SB session      – Trend: Show trend (Zigzag, colored ~ trend)
Pine Script® indicator
by LuxAlgo
129
Liquidity Engulfing & Displacement [MsF]Japanese below / 日本語説明は英文の後にあります。 ------------------------- *This indicator is based on upslidedown's "Liquidity Engulfing Candles ". It's a very cool indicator. thank you. It has 2 functions: show the Liquidity Engulfing on HTF and candle color change when displacement occurs. === Function description === 1. Liquidity Engulfing on HTF This indicator gives Liquidity Engulfing signals not only for the current candle, but also for H4 and H1 on HTF. You can use that a bullish engulfing on H1 is a BOS on m5 and on H4 is a BOS on m15. It uses the theory of stop hunt from ICT. Also, It's possible to fire alert. 2. Displacement Change the color display of the candlesticks when a bullish candleStick or bearish candleStick is attached. Furthermore, by enabling the "Require FVG" option, you can easily discover the FVG (Fair Value Gap). It is a very useful function for ICT trading. When H1 candle takes liquidity from one side and moves with an explosive move to the other side of the previous candle (displacement), it creates break of market structure on M5. Entry on discount FVG or OTE with stop loss at or below the stop hunt wick. === Parameter description === - Liquidity engulfing candles(LEC) SETTING - Show H1 LEC … Whether to show LEC for H1 - Show H4 LEC … Whether to show LEC for H4 - Show Current LEC … Whether to show LEC for current timeframe - Apply Stop Hunt Wick Filter … Require candle wick into prior candle retracement zone - Apply Close Filter … Require LL/HH on candle in order to print a valid engulfing signal - DISPLACEMENT SETTING - Require FVG … Draw only when FVG occurs - Displacement Type … Displacement from open to close? or from high to low? - Displacement Length … Period over which to calculate the standard deviation - Displacement Strength … The larger the number, the stronger the displacement detected ------------------------- 2つの機能があります: 上位足のLiquidity engulfing（流動性獲得）を表示することと、大きな変位が発生したときにローソク足の色を変更することです。 === 機能説明 === 1. 上位足のLiquidity engulfing このインジケーターは、現在のローソク足だけでなく、上位足の H4 および H1 に対してもLiquidity engulfingシグナルを提供します。 H1はm5、H4はm15での使用を推奨します。これはICTのストップハント理論を活用しています。また、アラートを発することも可能です。 2. 変位（DISPLACEMENT） 大きな陽線、陰線を付けた場合に、そのローソク足をカラー表示を変更します。 さらに"Require FVG"オプションを有効にすることで、FVG（Fair Value Gap）を容易に発見することができます。ICTトレードにを行うにあたり大変有用な機能となっています。 === パラメータの説明 === - Liquidity engulfing candles(LEC) SETTING - Show H1 LEC … H1のLECを表示するかどうか - Show H4 LEC … H4のLECを表示するかどうか - Show Current LEC … 現在の期間の LEC を表示するかどうか - Apply Stop Hunt Wick Filter … ハラミ足、もしくは包み足になっている場合のみに検知させる - Apply Close Filter … １つ前のローソクよりも終値で超えていた場合のみに検知させる - DISPLACEMENT SETTING - Require FVG … FVG発生時のみ描画する - Displacement Type … openからcloseまでの変位か？highからlowまでの変位か？ - Displacement Length … 標準偏差を計算する期間 - Displacement Strength … 変位の強さ（数字が大きいほど強い変位を検出）
Pine Script® indicator
by Trader_Morry
2
ICT HTF Liquidity Levels /w Alert [MsF]Japanese below / 日本語説明は英文の後にあります。 ------------------------- *This indicator is based on sbtnc's "HTF Liquidity Levels". It's a very cool indicator. thank you. It has 3 functions: visualization of HTF liquidity (with alert), candle color change when displacement occurs, and MSB (market structure break) line display. === Function description === 1. HTF liquidity (with alert) Lines visualize the liquidity pools on the HTF bars. Alerts can be set for each TF's line. Once the price reaches the line, the line is repaint. To put it plainly, the old line disappears and a new line appears. The line that disappeared remains as a purged line. (It is also possible to hide the purged line with a parameter) The alert will be triggered at the moment the line disappears. An alert will be issued when you touch the HTF's liquid pools where the loss is accumulated, so you can notice the stop hunting with the alert. This alert is an original feature of this indicator. The timeframe of the HTF can't modify. You can get Monthly, weekly, daily and H1 and H4. Each timeframe displays the 3 most recent lines. By narrowing it down to 3, it is devised to make it easier to see visually. (This indicator original) 2. Displacement Change the color display of the candlesticks when a bullish candle stick or bearish candle stick is attached. Furthermore, by enabling the "Require FVG" option, you can easily discover the FVG (Fair Value Gap). It is a very useful function for ICT trading. 3. MSB (market structure break) Displays High/Low lines for the period specified by the parameter. It is useful for discovering BoS & CHoCH/MSS, which are important in ICT trading. === Parameter description === - HTF LIQUIDITY - Daily … Daily line display settings (color, line width) - Weekly … Weekly line display settings (color, line width) - Monthly … Monthly line display settings (color, line width) - INTRADAY LIQUIDITY - 1H … 1H line display settings (color, line width) - 4H … 4H line display settings (color, line width) - PURGED LIQUIDITY … Display setting of the line once the candle reaches - Show Purge Daily … Daily purged line display/non-display setting - Show Purge Weekly … Weekly purged line display/non-display setting - Show Purge Monthly … Monthly purged line display/non-display setting - Show Purge 1H … 1H purged line display/non-display setting - Show Purge 4H … 4H purged line display/non-display setting - MARKET STRUCTURE BREAK - MBS - Loopback … Period for searching High/Low - DISPLACEMENT FOR FVG - Require FVG … Draw only when FVG occurs - Displacement Type … Displacement from open to close? or from high to low? - Displacement Length … Period over which to calculate the standard deviation - Displacement Strength … The larger the number, the stronger the displacement detected ------------------------- このインジケータはsbtncさんの"HTF Liquidity Levels"をベースに作成しています。 上位足流動性の可視化（アラート付き）、変位発生時のローソク色変更、MSB(market structure break)ライン表示の３つの機能を有します。 ＜機能説明＞ ■上位足流動性の可視化 上位足の流動性の吹き溜まり（ストップが溜まっているところ）をラインで可視化します。ラインにはアラートを設定することが可能です。 一度価格がラインに到達するとそのラインは再描画されます。 平たく言うと、今までのラインが消えて新しいラインが出現する。という事です。 消えたラインはpurgeラインとして残ります。（パラメータでpurgeラインを非表示にすることも可能です） アラートはラインが消える瞬間に発報します。上位足の損切り溜まってるところにタッチするとアラートを発報するので、アラートにてストップ狩りに気づくことができます。 このアラート発報については本インジケータオリジナルの機能となります。 表示可能な上位足のタイムフレームは固定です。月足、週足、日足およびH1とH4を表示することができます。 各タイムフレーム、直近から3つのラインを表示します。3つに絞ることで視覚的に見やすく工夫しています。（本インジケータオリジナル） ■変位発生時のローソク色変更 大きな陽線、陰線を付けた場合に、そのローソク足をカラー表示を変更します。 さらに"Require FVG"オプションを有効にすることで、FVG（Fair Value Gap）を容易に発見することができます。ICTトレードにを行うにあたり大変有用な機能となっています。 ■MSB(market structure break)ライン表示 パラメータで指定した期間のHigh/Lowをライン表示します。ICTトレードで重要視しているBoS & CHoCH/MSSの発見に役立ちます。 ＜パラメータ説明＞ - HTF LIQUIDITY - Daily … 日足ライン表示設定（色、線幅） - Weekly … 週足ライン表示設定（色、線幅） - Monthly … 月足ライン表示設定（色、線幅） - INTRADAY LIQUIDITY - 1H … 1時間足ライン表示設定（色、線幅） - 4H … 4時間足ライン表示設定（色、線幅） - PURGED LIQUIDITY … 一度到達したラインの表示設定 - Show Purge Daily … 日足ライン表示／非表示設定 - Show Purge Weekly … 週足ライン表示／非表示設定 - Show Purge Monthly … 月足ライン表示／非表示設定 - Show Purge 1H … 1時間足ライン表示／非表示設定 - Show Purge 4H … 4時間足ライン表示／非表示設定 - MARKET STRUCTURE BREAK - MBS - Loopback … High/Lowを探索する期間 - DISPLACEMENT FOR FVG - Require FVG … FVG発生時のみ描画する - Displacement Type … openからcloseまでの変位か？highからlowまでの変位か？ - Displacement Length … 標準偏差を計算する期間 - Displacement Strength … 変位の強さ（数字が大きいほど強い変位を検出）
Pine Script® indicator
by Trader_Morry
32
MirPapa_Lib_BoxLibrary "MirPapa_Lib_Box" GetHTFrevised(_tf, _case)   GetHTFrevised @description Retrieve a specific bar value from a Higher Time Frame (HTF) series.   Parameters:      _tf (string) : string The target HTF string (examples: "60", "1D").      _case (string) : string Case string determining which OHLC value to request. @return float Returns the requested HTF value or na if _case does not match. GetHTFrevised(_tf)   Parameters:      _tf (string) GetHTFoffsetToLTFoffset(_offset, _chartTf, _htfTf)   GetHTFoffsetToLTFoffset @description Adjust an HTF offset to an LTF offset by calculating the ratio of timeframes.   Parameters:      _offset (int) : int The HTF bar offset (0 means current HTF bar).      _chartTf (string) : string The current chart's timeframe (e.g., "5", "15", "1D").      _htfTf (string) : string The High Time Frame string (e.g., "60", "1D"). @return int The corresponding LTF bar index. Returns 0 if the result is negative. GetHtfFromLabel(_label)   GetHtfFromLabel @description Convert a Korean HTF label into a Pine Script timeframe string.   Parameters:      _label (string) : string The Korean label (e.g., "5분", "1시간"). @return string Returns the corresponding Pine Script timeframe (e.g., "5", "60"). IsChartTFcomparisonHTF(_chartTf, _htfTf)   IsChartTFcomparisonHTF @description Determine whether a given HTF is greater than or equal to the current chart timeframe.   Parameters:      _chartTf (string) : string Current chart timeframe (e.g., "5", "15", "1D").      _htfTf (string) : string HTF timeframe (e.g., "60", "1D"). @return bool True if HTF ≥ chartTF, false otherwise. IsCondition(_boxType, _isBull, _pricePrev, _priceNow)   IsCondition @description FOB, FVG 조건 체크.\ _boxType: "fob"(Fair Order Block) 또는 "fvg"(Fair Value Gap).\ _isBull: true(상승 패턴), false(하락 패턴).\ 상승 시 현재 가격이 이전 가격보다 높으면 true, 하락 시 이전 가격이 현재 가격보다 높으면 true 반환.   Parameters:      _boxType (string) : 박스 타입 ("fob", "fvg")      _isBull (bool) : 상승(true) 또는 하락(false)      _pricePrev (float) : 이전 가격      _priceNow (float) : 현재 가격   Returns: bool 조건 만족 여부 IsCondition(_boxType, _high2, _high1, _high0, _low2, _low1, _low0)   IsCondition @description Sweep 조건 체크 (Swing High/Low 동시 발생).\ _boxType: "sweep" 또는 "breachBoth".\ 조건: high2 < high1 > high0 (Swing High) AND low2 > low1 < low0 (Swing Low).\ 중간 캔들이 양쪽보다 높고 낮은 지점을 동시에 형성할 때 true 반환.   Parameters:      _boxType (string) : 박스 타입 ("sweep", "breachBoth")      _high2 (float)      _high1 (float)      _high0 (float)      _low2 (float)      _low1 (float)      _low0 (float)   Returns: bool 조건 만족 여부 IsCondition(_boxType, _isBull, _open1, _close1, _high1, _low1, _open0, _close0, _low2, _low3, _high2, _high3)   IsCondition @description RB (Rejection Block) 조건 체크.\ _boxType: "rb" (Rejection Block).\ 상승 RB: candle1=음봉, candle0=양봉, low3>low1 AND low2>low1, close1*1.001>open0, open1close0.\ 이전 캔들의 거부 후 현재 캔들이 반대 방향으로 전환될 때 true 반환.   Parameters:      _boxType (string) : 박스 타입 ("rb")      _isBull (bool) : 상승(true) 또는 하락(false)      _open1 (float)      _close1 (float)      _high1 (float)      _low1 (float)      _open0 (float)      _close0 (float)      _low2 (float)      _low3 (float)      _high2 (float)      _high3 (float)   Returns: bool 조건 만족 여부 IsCondition(_boxType, _isBull, _open2, _close1, _open1, _close0)   IsCondition @description SOB (Strong Order Block) 조건 체크.\ _boxType: "sob" (Strong Order Block).\ 상승 SOB: 양봉2 => 음봉1 => 양봉0, open2 > close1 AND open1 < close0.\ 하락 SOB: 음봉2 => 양봉1 => 음봉0, open2 < close1 AND open1 > close0.\ 3개 캔들 패턴으로 강한 주문 블록 형성 시 true 반환.   Parameters:      _boxType (string) : 박스 타입 ("sob")      _isBull (bool) : 상승(true) 또는 하락(false)      _open2 (float) : 2개 이전 캔들 open      _close1 (float) : 1개 이전 캔들 close      _open1 (float) : 1개 이전 캔들 open      _close0 (float) : 현재 캔들 close   Returns: bool 조건 만족 여부 CreateBox(_boxType, _tf, _isBull, _useLine, _colorBG, _colorBD, _colorText, _cache)   CreateBox @description 박스 생성 (breachMode 자동 결정).\ _boxType: "fob", "rb", "custom" → directionalHighLow, 나머지 → both.\ _tf: 시간대 (timeframe.period 또는 HTF).\ _isBull: true(상승 박스), false(하락 박스).\ _cache: HTF 사용 시 필수, CurrentTF는 na.\ 반환: .   Parameters:      _boxType (string) : 박스 타입      _tf (string) : 시간대      _isBull (bool) : 상승(true) 또는 하락(false)      _useLine (bool) : 중간선 표시 여부      _colorBG (color) : 박스 배경색      _colorBD (color) : 박스 테두리색      _colorText (color) : 텍스트 색상      _cache (HTFCache) : HTF 캐시 데이터   Returns: 성공 여부와 박스 데이터 CreateBox(_boxType, _tf, _isBull, _useLine, _colorBG, _colorBD, _colorText, _cache, _customText)   CreateBox @description 박스 생성 (커스텀 텍스트 지원, breachMode 자동 결정).\ _boxType: "fob", "rb", "custom" → directionalHighLow, 나머지 → both.\ _customText: 박스에 표시할 텍스트 (비어있으면 "시간대 박스타입" 형식으로 자동 생성).\ _isBull: true(상승 박스), false(하락 박스).\ 반환: .   Parameters:      _boxType (string) : 박스 타입      _tf (string) : 시간대      _isBull (bool) : 상승(true) 또는 하락(false)      _useLine (bool) : 중간선 표시 여부      _colorBG (color) : 박스 배경색      _colorBD (color) : 박스 테두리색      _colorText (color) : 텍스트 색상      _cache (HTFCache) : HTF 캐시 데이터      _customText (string) : 커스텀 텍스트   Returns: 성공 여부와 박스 데이터 CreateBox(_boxType, _breachMode, _tf, _isBull, _useLine, _colorBG, _colorBD, _colorText, _cache, _customText)   CreateBox @description 박스 생성 (breachMode 명시적 지정).\ _breachMode: "both"(양쪽 모두 돌파), "directionalHighLow"(방향성 high/low 돌파), "directionalClose"(방향성 close 돌파).\ _isBull: true(상승 박스), false(하락 박스).\ _customText: 박스에 표시할 텍스트 (비어있으면 "시간대 박스타입" 형식으로 자동 생성).\ 반환: .   Parameters:      _boxType (string) : 박스 타입 (fob, fvg, sweep, rb, custom 등)      _breachMode (string) : 돌파 처리 방식: "both" (양쪽 모두), "directionalHighLow" (방향성 high/low), "directionalClose" (방향성 close)      _tf (string) : 시간대      _isBull (bool) : 상승(true) 또는 하락(false) 방향      _useLine (bool) : 중간선 표시 여부      _colorBG (color) : 박스 배경색      _colorBD (color) : 박스 테두리색      _colorText (color) : 텍스트 색상      _cache (HTFCache) : HTF 캐시 데이터 (CurrentTF는 na)      _customText (string) : 커스텀 텍스트 (비어있으면 자동 생성)   Returns: 성공 여부와 박스 데이터 CreateCustomBox(_boxType, _breachMode, _isBull, _top, _bottom, _left, _right, _useLine, _colorBG, _colorBD, _colorText, _text)   CreateCustomBox @description 완전히 유연한 커스텀 박스 생성.\ 사용자가 박스 위치(top, bottom, left, right), breach mode, 모든 파라미터를 직접 지정.\ 조건 체크는 사용자 스크립트에서 수행하고, 이 함수는 박스 생성만 담당.\ 새로운 박스 타입 추가 시 라이브러리 수정 없이 사용 가능.   Parameters:      _boxType (string) : 박스 타입 (사용자 정의 문자열)      _breachMode (string) : 돌파 처리 방식: "both", "directionalHighLow", "directionalClose", "sobClose"      _isBull (bool) : 상승(true) 또는 하락(false) 방향      _top (float) : 박스 상단 가격      _bottom (float) : 박스 하단 가격      _left (int) : 박스 시작 시간 (xloc.bar_time 사용)      _right (int) : 박스 종료 시간 (xloc.bar_time 사용)      _useLine (bool) : 중간선 표시 여부      _colorBG (color) : 박스 배경색      _colorBD (color) : 박스 테두리색      _colorText (color) : 텍스트 색상      _text (string) : 박스에 표시할 텍스트   Returns: 성공 여부와 박스 데이터 ProcessBoxDatas(_openBoxes, _closedBoxes, _useMidLine, _closeCount, _colorClose, _currentBarIndex, _currentLow, _currentHigh, _currentTime)   ProcessBoxDatas @description 박스 확장 및 돌파 처리.\ 열린 박스들을 현재 bar까지 확장하고, 돌파 조건 체크.\ _closeCount: 돌파 횟수 (이 횟수만큼 돌파 시 박스 종료).\ breachMode에 따라 돌파 체크 방식 다름 (both/directionalHighLow/directionalClose).\ 종료된 박스는 _closedBoxes로 이동하고 _colorClose 색상 적용.\ barstate.islast와 barstate.isconfirmed에서 호출 권장.   Parameters:      _openBoxes (array) : 열린 박스 배열      _closedBoxes (array) : 닫힌 박스 배열      _useMidLine (bool) : 중간선 표시 여부      _closeCount (int) : 돌파 카운트 (이 횟수만큼 돌파 시 종료)      _colorClose (color) : 종료된 박스 색상      _currentBarIndex (int) : 현재 bar_index      _currentLow (float) : 현재 low      _currentHigh (float) : 현재 high      _currentTime (int) : 현재 time   Returns: bool 항상 true UpdateHTFCache(_cache, _tf)   UpdateHTFCache @description HTF 데이터 캐싱 (성능 최적화).\ HTF의 OHLC 데이터를 캐싱하여 매 틱마다 request.security 호출 방지.\ _cache: 기존 캐시 (없으면 na, 첫 호출 시).\ _tf: 캐싱할 시간대 (예: "60", "1D").\ 새 bar 또는 bar_index 변경 시에만 업데이트, 그 외에는 기존 캐시 반환.\   Parameters:      _cache (HTFCache) : 기존 캐시 데이터 (없으면 na)      _tf (string) : 시간대   Returns: HTFCache 업데이트된 캐시 데이터 GetTimeframeSettings(_currentTF, _midTF1m, _highTF1m, _midTF5m, _highTF5m, _midTF15m, _highTF15m, _midTF30m, _highTF30m, _midTF60m, _highTF60m, _midTF240m, _highTF240m, _midTF1D, _highTF1D, _midTF1W, _highTF1W, _midTF1M, _highTF1M)   GetTimeframeSettings @description 현재 차트 시간대에 맞는 중위/상위 시간대 자동 선택.\ _currentTF: 현재 차트 시간대 (timeframe.period).\ 1분~1월 차트별로 적절한 중위/상위 시간대 매핑.\ 예: 5분 차트 → 중위 15분, 상위 60분.\ 반환: .\   Parameters:      _currentTF (string) : 현재 차트 시간대      _midTF1m (string)      _highTF1m (string)      _midTF5m (string)      _highTF5m (string)      _midTF15m (string)      _highTF15m (string)      _midTF30m (string)      _highTF30m (string)      _midTF60m (string)      _highTF60m (string)      _midTF240m (string)      _highTF240m (string)      _midTF1D (string)      _highTF1D (string)      _midTF1W (string)      _highTF1W (string)      _midTF1M (string)      _highTF1M (string)   Returns: BoxData   BoxData   Fields:      _type (series string) : 박스 타입 (fob, fvg, sweep, rb, custom 등)      _breachMode (series string) : 돌파 처리 방식      _isBull (series bool) : 상승(true) 또는 하락(false) 방향      _box (series box)      _line (series line)      _boxTop (series float)      _boxBot (series float)      _boxMid (series float)      _topBreached (series bool)      _bottomBreached (series bool)      _breakCount (series int)      _createdBar (series int) HTFCache   Fields:      _timeframe (series string)      _lastBarIndex (series int)      _isNewBar (series bool)      _barIndex (series int)      _open (series float)      _high (series float)      _low (series float)      _close (series float)      _open1 (series float)      _close1 (series float)      _high1 (series float)      _low1 (series float)      _open2 (series float)      _close2 (series float)      _high2 (series float)      _low2 (series float)      _high3 (series float)      _low3 (series float)      _time1 (series int)      _time2 (series int)
Pine Script® library
by goodia
Smart Gap Concepts [MarkitTick]💡 This indicator automates the identification and classification of price gaps, commonly known as Fair Value Gaps (FVG) or Imbalances, by integrating market structure and volume analysis. Unlike standard gap detectors that simply highlight empty space on a chart, this script applies algorithmic filters to categorize gaps into three distinct phases of market movement: Breakaway, Runaway, and Exhaustion. This helps traders understand the potential context of a move rather than just seeing a support or resistance zone. ● Originality and Utility The primary innovation of this tool is its dynamic classification system. It moves beyond visual detection by checking the "why" behind the gap. By referencing Swing Highs and Swing Lows (Market Structure) alongside Volume efficiency, it determines if a gap represents a breakout, a trend continuation, or a climatic end to a move. Additionally, the script features an automated mitigation tracking system that removes gaps from the chart once price has re-tested the midpoint, ensuring the visual workspace remains clean and relevant to current price action. ● Methodology The script operates on a multi-stage logic engine: • Gap Detection It first identifies the core imbalance where the Low of the current bar does not overlap with the High of the bar two periods prior (for bullish gaps), ensuring the intervening candle represents a strong displacement. • Structural Analysis (Breakaway Gaps) The script monitors Pivot Highs and Lows. If a gap occurs simultaneously with a close beyond a key structural Pivot, it is classified as a "Breakaway Gap." This signals the potential start of a new trend. • Volume and Time Analysis (Exhaustion Gaps) To identify potential reversals, the script looks for "Trend Maturity." If a gap forms after a long duration since the last pivot and is accompanied by a volume spike (defined by the Volume Spike Multiplier), it is labeled as an "Exhaustion Gap." • Continuation (Runaway Gaps) If a gap is valid but meets neither the Breakaway nor Exhaustion criteria, it is considered a "Runaway Gap," typically found in the middle of an established trend. • Dynamic Cleanup The script tracks the midpoint of every active gap. If price creates a lower low (for bullish gaps) or higher high (for bearish gaps) beyond this midpoint, the gap is considered mitigated and is removed from the screen. 📖 How to Use Traders can utilize the color-coded classifications to gauge market intent: Breakaway (Default Blue): Watch these zones for potential trend initiations. These are often high-probability areas for a retest entry after a structure break. Runaway (Default Orange): These indicate strong momentum. They can be used to trail stop-losses or add to winning positions, as price should ideally not close below these gaps in a healthy trend. Exhaustion (Default Red): Be cautious when these appear. They suggest the current move is overextended and a reversal or complex pullback may be imminent. • Exhaustion Gap : A Practical Case Study • Breakaway Gap: A Practical Case Study • Runaway Gap : A Practical Case Study ⚙️ Inputs and Settings Min Gap Size (Points): Filters out insignificant gaps smaller than this threshold. Structure Lookback: Defines the sensitivity of the Pivot detection (Swing High/Low). Volume Avg Length & Multiplier: Determines what qualifies as a "Volume Spike" for exhaustion logic. Trend Maturity: The minimum number of bars required to consider a trend "old" enough for an exhaustion signal. Visual Settings: Custom colors for each gap type and box extension length. ● Disclaimer All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion.
Pine Script® indicator
by MarkitTick
8
Paradigm Shift: Delivery StateDescription by way of Example using weekly and 4h readings. THIS INDICATOR IS NOT MADE TO OPERATE BELOW A 4H chart. It is looking for Weekly and 4h price delivery that an ICT trader would call messy. Spikes well below OB but which then turn in the logical direction. A series of FVG that are never returned to or themselves are printed over but then turn support or resistance against the run through. So it is designed to indicate the overall level of stress on algorithm delivery. When you see a significantly higher stress level on the 4h trading is still doable but be careful of sloppy delivery. When you see a significant stress level on the weekly then be very very careful on the lower levels and consider staying out for the time being. The state of price delivery can be seen by anyone. But I have incorporated readings of the global bond market and currency correlations as confluent evidence of the reading for the state of price delivery. The term "grinder" is my word for algorithmic delivery. Contrary to ICT I believe that buying and selling pressure are real determinants of market movement up or down. However, I believe that that pressure is pushed through the algo like meat through a meat grinder to ensure a fair and equitable and efficient delivery of that pressure. So price always moves according to algorithmic principles, but those principles are driven by external pressure. The greater the pressure the more the algo stutters and gaps in its effort to smooth out an efficient delivery of price. This Indicator is looking for those stressors. The Weekly State: "Symmetrical" / Stress: 2% * What it means: At the highest level, the "New Paradigm" has not yet broken the system. A 2% stress level is effectively "Background Noise." This indicates that the global bond market and currency correlations are currently holding their historical norms. * The Price Delivery: Because it is Symmetrical, the "Grinder" is in an efficient mode. Weekly expansions are likely being met with orderly retracements. There are no "Ominous" breakaway gaps on the weekly timeframe yet. * The Dalio View: We are still in the "Accumulation" or "Buffering" phase of the cycle. The systemic heart attack is not happening this week. 2. The 4h State: "Saturated" / Stress: 44% * What it means: While the Weekly is calm, the 4h is heating up. A 44% stress level means that local bond volatility (the US10Y proxy) is higher than it has been 44% of the time over the last year. This is a significant "Step-Up" in pressure. * The Price Delivery: Because it is Saturated, the 4h "Grinder" is starting to struggle with the "meat" being fed into it. * The Result: You will likely see "Deep Stop Runs" and "PD Array Overtravel." Price might not just tap an Order Block; it might blast 15 pips through it before reversing. * Delivery is "Unclean": The 4h Fair Value Gaps might only get partially filled, or price might leave "jagged" wicks that make lower-timeframe entries frustrating. 3. How to Trade This Divergence (Practical Logic) When the Higher Timeframe (HTF) is stable (2%) but the Lower Timeframe (LTF) is stressed (44%), it creates a specific environment: * The "Opaque Trap": You might see a perfect ICT Silver Bullet setup on the 15m, but because the 4h is "Saturated," the setup will likely be messier than usual. You should expect "Judas Swings" to be more violent and "FVG Retracements" to be less precise. * Confidence in the HTF: Since the Weekly is at 2%, you can trust the Overall Direction. If the Weekly is bullish, any "Saturated" mess on the 4h is likely just an aggressive re-accumulation rather than a systemic reversal. * The "Stay Out" Warning: You only need to worry when that 4h Stress (44%) begins to "infect" the Weekly. If the Weekly Stress moves from 2% to 20% to 50%, that is your signal that the Paradigm is Shifting and the "Grinder" is about to start teleporting price.
Pine Script® indicator
by BLKMonk
FVG Breakaway/3rd Candle (Arjo) [MK]Simple script to identify FVGs (Fair Value Gaps) on the current chart timeframe. The script differs from other FVG indicators on the Tradingview platform by using Arjos 3rd candle rule to identify which gaps are 'Breakway Gaps' and which Gaps are likely to be returned to. NOTE: As with all 'trading rules' this theory is not 100% accurate. default settings: Breakaway Gaps = YELLOW Gaps that price may return to = GREEN Mitigated Gaps = 100% TRANSPARENT What is a FVG: A FVG is a price area defined by a 3 candle pattern. For a bullish FVG, the low of the 3rd candle must be higher than the high of the 1st candle. This then leaves an area that is drawn as in the example below: A bearish FVG is defined by the high of the 3rd candle being lower than the low of the 1st candle, as shown in the example below: FVGs can act like magnets where price will either retrace to or reach for, therefore they can be used as entry points and also for take profit target levels. If for example, a trader would like to use an FVG for an entry, it would be useful to know which FVGs are more likely for price to re-enter and which FVG will be left un-touched. FVGs that are likely to be left un-touched by price are called 'Breakaway Gaps'. How do we define a 'Breakaway Gap': First we identify FVGs using the rules stated above, then we look to see where the 3rd candle closed in relation to the 2nd candle. For a bullish 'Breakaway Gap' we want to see the 3rd candle close above the high of the 2nd candle. An example of a bullish Breakaway Gap is shown in the example below: A bearish 'Breakaway Gap' is defined by the close of the 3rd candle being lower than the low of the 2nd candle. An example is shown below: How do we define an FVG that price may return to: Any gap that does not meet the above rules for a 'Breakway Gap' is therefore considered an FVG that price may return to. So for a bullish FVG that price may return to we would look to see if the close of the 3rd candle is above the high of the 2nd candle. If it is not above the high of the 2nd candle then it more likely that price will retrace into the FVG before continuing higher. An example is shown below: A bearish gap that price may return to is defined by the close of the 3rd candle not being lower than the low of the 2nd candle. An example is shown below: The indicator is based on the teachings of 'Arjo'. Note: breakaway gaps will only remain 'breakaway' until a liquidity level is reached. Breakaways therefore do not remain 'breakaway' forever. Users of the indicators must fully comprehend this theory before using the indicator with live markets. Users of the script should be fully aware of this concept and also have conducted thorough backtesting using a large data set before using this indicator with live accounts.
Pine Script® indicator
by malk1903
16
Pure FVG [Textbook]1. The Core Concept This is not a standard "show all gaps" indicator. It is a specific entry signal generator based on Smart Money Concepts (SMC). It focuses on Consequent Encroachment (The 50% Level). The underlying principle is that a Fair Value Gap (FVG) represents a market inefficiency where opposing traders are trapped. When price retraces at least 50% back into this gap, it creates pressure as these trapped positions look to exit—either through stop-losses or position reversal. This makes the gap most likely to act as a reversal zone. 2. How It Works (The Lifecycle) The indicator logic follows a strict sequence of events. A signal is generated only if all conditions are met in order: -- Phase 1: Identification (The Fresh Gap) The script scans for the classic 3-candle FVG pattern (where the 1st and 3rd candles do not overlap). Visual: It draws a box (Green for Bullish, Red for Bearish) extending to the right. The 50% Line: A dashed line is drawn through the center of the gap. -- Phase 2: Mitigation (The Gray Zone) This is the critical filter. The indicator waits for a candle to CLOSE past the 50% dashed line. Once this happens, the gap is considered "Deeply Mitigated." Visual: The box changes color to Gray. This tells the trader: "Price is deep in the zone, watch for a reaction." -- Phase 3: The Signal (Rejection) Once the box is Gray, the script watches for a "Rejection Candle." Bullish Scenario: Price is deep in the gap (Gray). The script waits for a candle to close higher than it opened (a green candle). Bearish Scenario: Price is deep in the gap (Gray). The script waits for a candle to close lower than it opened (a red candle). Visual: A Triangle Label (▲ or ▼) appears, signaling an entry. -- Phase 4: Invalidation If the price closes completely past the far edge of the box (the Stop Loss level), the box is deleted immediately. 3. Key Options These are the most important settings for the user: -- Min Gap Size (%): Filters out "noise." It ensures the script ignores tiny, insignificant gaps that are less than X% in height. -- Max Visible Gaps: Keeps your chart clean. It limits how many open boxes can be on the screen at once (e.g., only show the last 3 unclosed gaps). -- Show Signal History Only: Feature Highlight: When enabled, this hides all the "noise" of open or failed gaps. It only draws the boxes that successfully produced a Rejection Signal in the past.
Pine Script® indicator
by siLve_R88
SMC Post-Analysis Lab [PhenLabs]📊 SMC Post-Analysis Lab Version: PineScript™ v6 📌 Description The SMC Post-Analysis Lab is a dedicated hindsight analysis tool built for traders who want to understand what really happened during any historical trading period. Unlike forward-looking indicators, this tool lets you scroll back through time and instantly receive algorithmic classification of market states using Smart Money Concepts methodology. Whether you’re reviewing a losing trade, studying a successful session, or building your pattern recognition skills, this indicator provides immediate context. The expansion-aware algorithm processes price action within your selected window and outputs clear, actionable classifications ranging from Parabolic Expansion to Consolidation Inducements. Stop relying on subjective post-trade analysis. Let the algorithm objectively tell you whether institutional players were accumulating, distributing, or running inducements during your trades. 🚀 Points of Innovation First indicator specifically designed for SMC-based post-trade review rather than live signal generation Dual-mode analysis system allowing both dynamic scrollback and precise date selection Expansion-aware classification algorithm that weighs range position against net displacement Real-time efficiency metrics calculating directional quality of price movement Integrated visual FVG detection within the analysis window only Interactive table with clickable date range adjustment via chart interface 🔧 Core Components Pivot Detection Engine: Uses configurable pivot length to identify significant swing highs and lows for structure break detection Window Calculator: Determines active analysis zone based on either bar offset or timestamp boundaries Data Aggregator: Tracks window open, high, low, close and counts bullish/bearish structure break events State Classification Algorithm: Applies hierarchical logic to determine market state from six possible classifications Visual Renderer: Draws structure breaks, FVG boxes, and window highlighting within the active zone 🔥 Key Features Sliding Window Mode: Use the Scroll Back slider to dynamically move your analysis zone backwards through history bar-by-bar Date Range Mode: Select specific start and end timestamps for precise session or trade review Six Market State Classifications: Parabolic Expansion (Bull/Bear), Bullish/Bearish Order Flow, Accumulation/Distribution Reversal, and Consolidation/Inducement Range Position Percentile: See exactly where price closed relative to the window’s high-low range as a percentage Bull/Bear Event Counter: Quantified count of structure breaks in each direction during the analysis period Efficiency Calculation: Net move divided by total range reveals trending quality versus chop 🎨 Visualization Blue Window Highlight: Active analysis zone is clearly marked with blue background shading on the chart Structure Break Lines: Dashed lines appear at each bullish or bearish structure break within the window FVG Boxes: Fair Value Gaps automatically render as semi-transparent boxes in bullish or bearish colors Dashboard Table: Top-right positioned table displays State, Analysis description, and Metrics in real-time Color-Coded States: Each classification uses distinct coloring for immediate visual recognition Interactive Tip Row: Optional help text guides users on clicking the table to adjust date range 📖 Usage Guidelines General Configuration Analysis Mode: Default is Sliding Window. Choose Date Range for specific timestamp analysis. Sliding Window Settings Scroll Back (Bars): Default 0. Increase to move window backwards into history. Window Width (Bars): Default 100. Range 20-50 for scalping, 100+ for swing analysis. Date Range Settings Start Date: Select the beginning timestamp for your analysis period. End Date: Select the ending timestamp for your analysis period. Visual Settings Show Help Tip: Default true. Toggle to hide instructional row in dashboard. Bullish Color: Default teal. Customize for bullish elements. Bearish Color: Default red. Customize for bearish elements. SMC Parameters Pivot Length: Default 5. Lower values (3-5) catch minor breaks. Higher values (10+) focus on major swings. ✅ Best Use Cases Post-trade review to understand why entries succeeded or failed Session analysis to identify institutional activity patterns Trade journaling with objective algorithmic classifications Pattern recognition training through historical scrollback Identifying whether stop hunts were inducements or legitimate breaks Comparing your real-time read versus what the algorithm detected ⚠️ Limitations Designed for historical analysis only, not live trade signals Classification accuracy depends on appropriate pivot length for the timeframe FVG detection uses simple gap logic without mitigation tracking State classification is based on window data only, not broader context Requires manual scrolling or date input to review different periods 💡 What Makes This Unique Purpose-Built for Review: Unlike most indicators focused on live signals, this is designed specifically for post-trade analysis Expansion-Aware Logic: Algorithm weighs both position in range AND directional efficiency for accurate state detection Interactive Date Control: Click the dashboard table to reveal draggable anchors for window adjustment directly on chart 🔬 How It Works 1. Window Definition: User selects either Sliding Window or Date Range mode System calculates which bars fall within the active analysis zone Active zone receives blue background highlighting 2. Data Collection: Algorithm captures window open, running high, running low, and current close Structure breaks are detected when price crosses above last pivot high or below last pivot low Bullish and bearish events are counted separately 3. State Classification: Range Position calculates where close sits as percentage of high-low range Efficiency calculates net move divided by total range Hierarchical logic applies priority rules from Parabolic states down to Consolidation 4. Output Rendering: Dashboard table updates with State title, Analysis description, and Metrics Visual elements render within window only to keep chart clean Colors reflect bullish, bearish, or neutral classification 💡 Note: This indicator is intended for educational and review purposes. Use it to develop your understanding of Smart Money Concepts by analyzing what institutional order flow looked like during historical periods. Combine insights with your own analysis methodology for best results.
Pine Script® indicator
by PhenLabs
1
Trendshift [CHE] StrategyTrendshift Strategy — First-Shift Structural Regime Trading Profitfactor 2,603 Summary Trendshift Strategy implements a structural regime-shift trading model built around the earliest confirmed change in directional structure. It identifies major swing highs and lows, validates breakouts through optional ATR-based conviction, and reacts only to the first confirmed shift in each direction. After a regime reversal, the strategy constructs a premium and discount band between the breakout candle and the previous opposite swing. This band is used as contextual bias and may optionally inform stop placement and position sizing. The strategy focuses on clear, interpretable structural events rather than continuous signal generation. By limiting entries to the first valid shift, it reduces false recycles and allows the structural state to stabilize before a new trade occurs. All signals operate on closed-bar logic, and the strategy avoids higher-timeframe calls to stabilize execution behavior. Motivation: Why this design? Many structure-based systems repeatedly trigger as price fluctuates around prior highs and lows. This often leads to multiple flips during volatile or choppy conditions. Trendshift Strategy addresses this problem by restricting execution to the first confirmed structural event in each direction. ATR-based filters help differentiate genuine structural breaks from noise, while the contextual band ensures that the breakout is meaningful in relation to recent volatility. The design aims to represent a minimalistic structural trading framework focused on regime turns rather than continuous trend signaling. This reduces chart noise and clarifies where the market transitions from one regime to another. What’s different vs. standard approaches? Baseline reference Typical swing-based structure indicators report every break above or below recent swing points. Architecture differences First-shift-only regime logic that blocks repeated signals until direction reverses ATR-filtered validation to avoid weak or momentum-less breaks Premium and discount bands derived from breakout structure Optional band-driven stop placement Optional band-dependent position-sizing factor Regime timeout system to neutralize structure after extended inactivity Persistent-state architecture to prevent re-triggering Practical effect Only the earliest actionable structure change is traded Fewer but higher-quality signals Premium/discount tint assists contextual evaluation Stops and sizing can be aligned with structural context rather than arbitrary volatility measures Improved chart interpretability due to reduced marker frequency How it works (technical) The algorithm evaluates symmetric swing points using a fixed bar window. When a swing forms, its value and bar index are stored as persistent state. A structural shift occurs when price closes beyond the most recent major swing on the opposite side. If ATR filtering is enabled, the breakout must exceed a volatility-scaled distance to prevent micro-breaks from firing. Once a valid shift is confirmed, the regime is updated to bullish or bearish. The script records the breakout level, the opposite swing, and derives a band between them. This band is checked for minimum size relative to ATR to avoid unrealistic contexts. The first shift in a new direction generates both the strategy entry and a visual marker. Additional shifts in the same direction are suppressed until a reversal occurs. If a timeout is enabled, the regime resets after a specified number of bars without structural change, optionally clearing the band. Stop placement, if enabled, uses either the opposite or same band edge depending on configuration. Position size is computed from account percentage and may optionally scale with the price-span-to-ATR relationship. Parameter Guide Market Structure Swing length (default 5): Controls swing sensitivity. Lower values increase responsiveness. Use ATR filter (default true): Requires breakouts to show momentum relative to ATR. Reduces false shifts. ATR length (default 14): Volatility estimation for breakout and band validation. Break ATR multiplier (default 1.0): Required breakout strength relative to ATR. Premium/Discount Framework Enable framework (default true): Activates premium/discount evaluation. Persist band on timeout (default true): Keeps structural band after timeout. Min band ATR mult (default 0.5): Rejects narrow bands. Regime timeout bars (default 500): Neutralizes regime after inactivity. Invert colors (default false): Color scheme toggle. Visuals Show zone tint (default true): Background shade in premium or discount region. Show shift markers (default true): Display first-shift markers. Execution and Risk Risk per trade percent (default 1.0): Determines position size as account percentage. Use band for size (default false): Scales size relative to band width behavior. Flat on opposite shift (default true): Forces reversal behavior. Use stop at band (default false): Stop anchored to band edges. Stop band side: Chooses which band edge is used for stop generation. Reading & Interpretation A green background indicates discount conditions within the structural band; red indicates premium conditions. A green triangle below price marks the first bullish structural shift after a bearish regime. A red triangle above price marks the first bearish structural shift after a bullish regime. When stops are active, the opposite band edge typically defines the protective level. Band width relative to ATR indicates how significant a structural change is: wider bands imply stronger volatility structure, while narrow bands may be suppressed by the minimum-size filter. Practical Workflows & Combinations Trend following: Use first-shift entries as initial regime confirmation. Add higher-timeframe trend filters for additional context. Swing trading: Combine with simple liquidity or fair-value-gap concepts to refine entries. Bias mapping: Use higher timeframes for structural regime and lower timeframes for execution within the premium/discount context. Exit management: When using stops, consider ATR-scaling or multi-stage profit targets. When not using stops, reversals become the primary exit. Behavior, Constraints & Performance The strategy uses only confirmed swings and closed-bar logic, avoiding intrabar repaint. Pivot-based swings inherently appear after the pivot window completes, which is standard behavior. No higher-timeframe calls are used, preventing HTF-related repaint issues. Persistent variables track regime and structural levels, minimizing recomputation. The maximum bars back setting is five-thousand. The design avoids loops and arrays, keeping performance stable. Known limitations include limited signal density during consolidations, delayed swing confirmation, and sensitivity to extreme gaps that stretch band logic. ATR filtering mitigates some of these effects but does not eliminate them entirely. Sensible Defaults & Quick Tuning Fewer but stronger entries: Increase swing length or ATR breakout multiplier. More responsive entries: Reduce swing length to capture earlier shifts. More active band behavior: Lower the minimum band ATR threshold. Stricter stop logic: Use the opposite band edge for stop placement. Volatile markets: Increase ATR length slightly to stabilize behavior. What this indicator is—and isn’t Trendshift Strategy is a structural-regime trading engine that evaluates major directional shifts. It is not a complete trading system and does not include take-profit logic or prediction features. It does not attempt to forecast future price movement and should be used alongside broader market structure, volatility context, and disciplined risk management. Disclaimer The content provided, including all code and materials, is strictly for educational and informational purposes only. It is not intended as, and should not be interpreted as, financial advice, a recommendation to buy or sell any financial instrument, or an offer of any financial product or service. All strategies, tools, and examples discussed are provided for illustrative purposes to demonstrate coding techniques and the functionality of Pine Script within a trading context. Any results from strategies or tools provided are hypothetical, and past performance is not indicative of future results. Trading and investing involve high risk, including the potential loss of principal, and may not be suitable for all individuals. Before making any trading decisions, please consult with a qualified financial professional to understand the risks involved. By using this script, you acknowledge and agree that any trading decisions are made solely at your discretion and risk. Do not use this indicator on Heikin-Ashi, Renko, Kagi, Point-and-Figure, or Range charts, as these chart types can produce unrealistic results for signal markers and alerts. Best regards and happy trading Chervolino
Pine Script® strategy
by chervolino
lib_fvgLibrary "lib_fvg" further expansion of my object oriented library toolkit. This lib detects Fair Value Gaps and returns them as objects. Drawing them is a separate step so the lib can be used with securities. It also allows for usage of current/close price to detect fill/invalidation of a gap and to adjust the fill level dynamically. FVGs can be detected while forming and extended indefinitely while they're unfilled. method draw(this)   Namespace types: FVG   Parameters:      this (FVG) method draw(fvgs)   Namespace types: FVG   Parameters:      fvgs (FVG ) is_fvg(mode, precondition, filter_insignificant, filter_insignificant_atr_factor, live)   Parameters:      mode (int) : switch for detection 1 for bullish FVGs, -1 for bearish FVGs      precondition (bool) : allows for other confluences to block/enable detection      filter_insignificant (bool) : allows to ignore small gaps      filter_insignificant_atr_factor (float) : allows to adjust how small (compared to a 50 period ATR)      live (bool) : allows to detect FVGs while the third bar is forming -> will cause repainting   Returns: a tuple of (bar_index of gap bar, gap top, gap bottom) create_fvg(mode, idx, top, btm, filled_at_pc, config)   Parameters:      mode (int) : switch for detection 1 for bullish FVGs, -1 for bearish FVGs      idx (int) : the bar_index of the FVG gap bar      top (float) : the top level of the FVG      btm (float) : the bottom level of the FVG      filled_at_pc (float) : the ratio (0-1) that the fill source needs to retrace into the gap to consider it filled/invalidated/ready for removal      config (FVGConfig) : the plot configuration/styles for the FVG   Returns: a new FVG object if there was a new FVG, else na detect_fvg(mode, filled_at_pc, precondition, filter_insignificant, filter_insignificant_atr_factor, live, config)   Parameters:      mode (int) : switch for detection 1 for bullish FVGs, -1 for bearish FVGs      filled_at_pc (float)      precondition (bool) : allows for other confluences to block/enable detection      filter_insignificant (bool) : allows to ignore small gaps      filter_insignificant_atr_factor (float) : allows to adjust how small (compared to a 50 period ATR)      live (bool) : allows to detect FVGs while the third bar is forming -> will cause repainting      config (FVGConfig)   Returns: a new FVG object if there was a new FVG, else na method update(this, fill_src)   Namespace types: FVG   Parameters:      this (FVG)      fill_src (float) : allows for usage of different fill source series, e.g. high for bearish FVGs, low vor bullish FVGs or close for both method update(all, fill_src)   Namespace types: FVG   Parameters:      all (FVG )      fill_src (float) method remove_filled(unfilled_fvgs)   Namespace types: FVG   Parameters:      unfilled_fvgs (FVG ) method delete(this)   Namespace types: FVG   Parameters:      this (FVG) method delete_filled_fvgs_buffered(filled_fvgs, max_keep)   Namespace types: FVG   Parameters:      filled_fvgs (FVG )      max_keep (int) : the number of filled, latest FVGs to retain on the chart. FVGConfig   Fields:      box_args (|robbatt/lib_plot_objects/36;BoxArgs|#OBJ)      line_args (|robbatt/lib_plot_objects/36;LineArgs|#OBJ)      box_show (series__bool)      line_show (series__bool)      keep_filled (series__bool)      extend (series__bool) FVG   Fields:      config (|FVGConfig|#OBJ)      startbar (series__integer)      mode (series__integer)      top (series__float)      btm (series__float)      center (series__float)      size (series__float)      fill_size (series__float)      fill_lvl_target (series__float)      fill_lvl_current (series__float)      fillbar (series__integer)      filled (series__bool)      _fvg_box (|robbatt/lib_plot_objects/36;Box|#OBJ)      _fill_line (|robbatt/lib_plot_objects/36;Line|#OBJ)
Pine Script® library
by robbatt
4
Gaps + Imbalances + Wicks (MTF) - By LeviathanThis script will identify and draw price gaps, wicks and imbalances with customizable fill conditions, multi-timeframe function, zone size filtering, volume comparison, lookback filtering, as well as highly customizable appearance and settings. I’ve made this indicator to combine the three similar but different elements that occur in price movements and serve as significant zones of interest or way of PA interpretation in various different strategies. Imbalances (or Fair Value Gap/FVG/Inefficiency/whatever) - The Imbalance “pattern” consists of 3 candles (1- candle before the sharp move, 2 - sharp move candle and 3- candle after the sharp move). When price makes a move downwards, the imbalance zone is defined as the area between the low of 1 and the high of 3 When price makes a move upwards, the imbalance zone is defined as the area between the high of 1 and the low of 3. Gaps A price gap is an area on a chart where no trading activity has taken place. A gap up means that the low of the current candle is higher than the high of the previous candle and a gap down means that the high of the current candle is lower than the low of the previous candle. Wicks (or shadows/tails/whatever) Wicks are used to indicate where the price has fluctuated relative to the opening and closing price of the candle. An upper wick is the zone between candle high and candle close/open (whichever is higher) and a lower wick is the zone between candle’s low and candle’s close/open (whichever is lower). Settings Overview “Zone Type” - This input lets you decide which zones should the script plot and on which timeframe. You should always pick a timeframe higher than your chat’s. “Middle Line, Top Line, Bottom Line” - Show or hide the Middle Line (horizontal level in the middle of each zone), Show or hide Top Line (horizontal level at the top of the zone), Show or hide Bottom Line (horizontal level at the bottom of the zone) “UP/DOWN Zones" - This input lets you show/hide UP Zones or DOWN Zones an pick their color, border color and label color. ”Fill Condition” - If turned ON, the zones will end drawing when your prefered Fill Condition is met (Full Filll = price mitigates the whole zone, Half Fill = zone is at least halfway mitigated and Touch = zone is touched by price). If turned OFF, the zones will only be plotted for the amount of bars defined it “Zone Length”. ”Lookback (D)” - This input lets you limit the amount of zones plotted on the chart by choosing how many days back in time should the script go to find and plot zones. For example, input 1 will only show you the zones of the past day, input 7 will only show you the zones of the past week. ”Hide Filled Zones” - If turned ON, the zones that have been filled will be removed from the chart. ”Show Boxes” - Show or hide the boxes that represent the zones. This is useful for those who want the zones to be visualized by just lines. “Filter Type” - this input lets you create a filter that will make the script only show zones that are larger than ATR or larger than a certain percentage. You can choose the ATR Length and the multiplier (higher multiplier → larger zone required), as well as the Percentage (%) and its multiplier (higher percentage → larger zone required). If you choose “None”, the zones of all sizes will be plotted. ”Zone Labels” - this part of the settings lets you: show/hide labels, decide on the size of the labels and their positions, choose a custom name for each zone, choose the data that the labels present (Type of the zone/Timeframe/ Volume ). ”Other settings” - ‘Stop/Delete zone after X number of candles’ will force stop/delete the zone if it’s plotted for more than prefered number of bars. ‘Line Style’ lets you choose the style and the color of the lines, ‘Zone Length’ defines the length of the zone if Fill Condition is “None”. More settings, modifications and improvements coming in future updates. This script is a bit old so I will clean up and optimize the code once I have more time.
Pine Script® indicator
by LeviathanCapital
51
Hybrid FVG: Active & Historical (Yairo).Hybrid FVG: Active & Historical (Quarterly Theory Ready) Description: This indicator is designed for traders who follow Price Action and The Quarterly Theory. It identifies Fair Value Gaps (FVG) with high precision while maintaining a clutter-free chart. Key Features: Dynamic Midline (Mean Threshold): Each FVG includes a prominent midline. In institutional trading, the 50% level of a gap is a critical sensitivity point for price reversals or continuations. Hybrid Visualization: All boxes are fixed between the origin candles (3-bar width). This allows you to track historical institutional footprints without long boxes obstructing your view. Quarterly Theory Compatibility: Perfectly suited for identifying imbalances during specific time cycles or "Quarterly" shifts. Use the clean, short boxes to mark liquidity gaps that occur within key timing windows. Smart Status Updates: * Blue/Red: Active Bullish/Bearish gaps. Cyan (Light Blue): Mitigated/Filled gaps. The script automatically changes the color and removes the label once the price touches the gap, providing an instant visual cue of addressed liquidity. Timeframe Labels: Automatically identifies and labels the timeframe of the gap (e.g., FVG 1H, FVG 4H). How to Use: Focus on the Midline as a key reaction level. Use the color-coding to quickly distinguish between fresh liquidity and mitigated zones, especially when aligning with your Quarterly Theory cycles. FVG, QuarterlyTheory, SMC, PriceAction, Liquidity, SmartMoney, ICT, Gap, OrderFlow, InstitutionalTrading
Pine Script® indicator
by ysfunet
Lil B's: Time based Liquidity + IFVG AlertsThis indicator identifies key time-based liquidity levels and maps their interaction with ICT-style Fair Value Gaps (FVGs) to highlight high-probability trade entry opportunities across all timeframes. It automatically tracks the Asia session high/low, London session high/low, and previous day high/low, extending these levels forward until price reaches and sweeps them. Once a sweep occurs, the indicator monitors for a true 3-candle ICT Fair Value Gap. When that FVG inverts, a clear, color-coded IFVG OK label is printed to signal a potential entry. Each level operates independently and is day-safe, preventing invalid sweeps or overlapping logic across sessions. Multiple confirmation, timeout, and visual-cleaning options are included to keep charts readable while allowing traders to control signal strictness. This tool is designed for traders who focus on liquidity, displacement, and precise execution, and works best as a confluence-based entry model rather than a standalone signal.
Pine Script® indicator
by bradenabrahams1
Colidation Breakout Structure(HA-CBS)Overview Most breakout indicators suffer from "noise," reacting to every minor price movement and producing frequent fakeouts. HA-CBS solves this by utilizing Heikin-Ashi (HA) smoothing and Swing Point analysis to isolate periods of extreme energy accumulation (Consolidation) and verifying the subsequent breakout with Fair Value Gaps (FVG) . ⚠️ Usage Note: This script is strictly optimized for Heikin-Ashi charts . The core logic relies on Heikin-Ashi body (Open/Close) calculations. To ensure the signals align perfectly with the price action you see, please switch your chart type to Heikin-Ashi. How it Works: The HA-CBS Logic Unlike generic indicators that draw signals instantly, HA-CBS follows a rigorous three-step verification process to ensure market displacement is real: Structural Mapping: Using a multi-term swing point algorithm, the script identifies key supply and demand boundaries. Consolidation Counting (The "Coil"): The script measures how many consecutive Heikin-Ashi bodies remain "tucked" within the structural range. A built-in CANDLE_MARGIN_RATE ensures that insignificant doji-like candles don't disrupt the count. The longer the "coil," the higher the potential for an explosive breakout. Kinetic Validation (FVG): When price finally breaks the structural boundary, the script checks for a Fair Value Gap. An FVG-backed breakout confirms that institutional "Impulse" is present, distinguishing a genuine trend start from a mere stop-run. Key Features Impulse Filter: Filters out low-momentum movements by requiring an FVG at the moment of the structural break. HA-Body Precision: Focuses on the "core" of the candle, ignoring volatile wicks that often lead to false signals. Multi-Term Flexibility: Users can toggle between Short, Intermediate, and Long-term swing structures to suit scalping, day trading, or swing trading. Recent Candidate Mode: Use the Recent Only toggle to keep your chart clean by only displaying the most recent and relevant breakout candidate for each structure. Trading Strategy Strategy A: The Impulse Entry (Aggressive) Enter the trade as soon as the HA-CBS signal is confirmed (HA Close breaks the structure with an FVG). This captures the immediate momentum as a new supply/demand imbalance is established. Strategy B: The Mitigation Entry (Conservative) Wait for price to return (retrace) to the identified HA-CBS Block. Institutional players often "mitigate" their positions by returning to the breakout source. This approach typically offers a higher Risk/Reward ratio.
Pine Script® indicator
by Hanageman
1
Trend Line & Delta Montosca [English v33.7]This indicator, Trend Line & Delta Montosca , is a high-precision tool designed to identify institutional entry points by combining price action structure with real-time volume sentiment (Order Flow). Here is a breakdown of its core logic and operational flow: 1. Market Structure & Trendline Analysis The indicator starts by identifying "Pivot Highs" and "Pivot Lows" based on the Sensitivity settings you chose. Pivot Connect Method: It draws trendlines connecting these key structural points. A "Long" bias is established when a trendline is broken to the upside, and a "Short" bias when broken to the downside. BOS (Break of Structure): It monitors when the price closes above the previous high or below the previous low to confirm the current market phase (Bullish or Bearish). 2. Intermarket Synchronization (ES + NQ) This is a unique "Institutional" filter. The script checks a secondary symbol (e.g., NQ if you are trading ES) to ensure the move is happening across the entire market. If both instruments hit a pivot at the same time, the trendline is drawn thicker, indicating higher institutional conviction. 3. Order Flow Validation (Delta) Breaking a trendline is not enough; it must be backed by "Smart Money" volume. The indicator uses Lower Timeframe (LTF) Intrabar Data to calculate the Delta: Strength Filter: It checks if the buying/selling volume in a single candle exceeds a specific percentage (set to 75% by default). Efficiency Filter: It identifies "Absorption" where the price moves aggressively with lower volume, suggesting a lack of resistance. 4. Inverted FVG (Fair Value Gap) Reaction The final "trigger" is often the reaction to a Fair Value Gap. The script tracks bearish and bullish FVGs. The Inversion Logic: A "Long" signal is only validated if the price "inverts" a bearish FVG (closes above it), treating the old resistance as new institutional support. 5. Blue Sky Filter (ATH) When the price is at an All-Time High (ATH), traditional FVG reactions might not exist. The script includes an optional "Blue Sky" logic that allows for trend-following entries even if there is no previous FVG to invert, as long as the structural breakout and Delta are present. Visualization Summary Labels: Clearly mark "LONG" or "SHORT" at the exact candle of entry. Snapshots: To help you review your trades, the script leaves a "visual footprint" (the trendline and the FVG box) that caused the signal, so you can see the exact institutional context after the trade has moved.
Pine Script® indicator
by alanmontosca
TimeframeAlignTHE PROBLEM THIS LIBRARY SOLVES When you use `request.security()` to get data from a Higher Timeframe (HTF) and try to draw objects like boxes, lines, or labels, they appear at the wrong horizontal position . This is the "floating in space" problem. Why does this happen? The `bar_index` in Pine Script refers to where data was RECEIVED , not where the event OCCURRED . Consider this scenario: • You're on a 5-minute chart • You request 1-hour data for drawing an FVG (Fair Value Gap) • A 1H candle spans 12 chart bars (60min / 5min = 12) • But your code draws at `bar_index - 1` or `bar_index - 3` • The result: your FVG box is only 2-3 bars wide instead of spanning the correct 12-36 bars This library solves that by tracking where HTF bars actually start and end on your chart timeframe. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ HOW TO USE THIS LIBRARY Step 1: Import the Library ``` import ArunaReborn/TimeframeAlign/1 as tfa ``` Step 2: Create a Tracker for Each HTF ``` var tfa.HTFTracker tracker1H = tfa.createTracker("60") ``` Step 3: Update the Tracker Every Bar ``` tfa.updateTracker(tracker1H, "60") ``` Step 4: Use Synced Drawing Functions ``` if tfa.htfBarChanged(tracker1H) tfa.syncedBox(tracker1H, 3, 1, topPrice, bottomPrice, color.new(color.green, 80)) ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ EXPORTED TYPES TimeframePair Stores metadata about the relationship between source and chart timeframes. • sourceTimeframe - The HTF/LTF being compared • chartTimeframe - Current chart timeframe • isHTF - True if source is higher than chart • isLTF - True if source is lower than chart • barRatio - Chart bars per source bar • secondsRatio - Time ratio between timeframes MTFEventData Stores synchronized event data with correct bar positions. • price - Price level of the event • eventTime - Unix timestamp of the event • chartBarStart - Chart bar_index where event's TF bar started • chartBarEnd - Chart bar_index where event's TF bar ended • htfOffset - The HTF offset used • isValid - True if synchronization succeeded HTFTracker Tracks HTF bar boundaries. Create one per timeframe you need to track. • htfTimeframe - The timeframe being tracked • currentStartBar - Where current HTF bar started • currentEndBar - Where current HTF bar ends (provisional) • startHistory - Array of historical start positions • endHistory - Array of historical end positions • lastUpdateBar - Last bar_index when updated • barJustChanged - True if HTF bar changed on this chart bar (set by updateTracker) SyncedBox Managed box with synchronization metadata. • bx - The Pine Script box object • htfTimeframe - Source timeframe • leftHtfOffset / rightHtfOffset - HTF offsets for edges • topPrice / bottomPrice - Price boundaries • extendRight - Auto-extend flag SyncedLine Managed line with synchronization metadata. • ln - The Pine Script line object • htfTimeframe - Source timeframe • htfOffset - Anchor offset • price - Price level (horizontal lines) • isHorizontal - Line orientation • extendRight - Auto-extend flag SyncedLabel Managed label with synchronization metadata. • lbl - The Pine Script label object • htfTimeframe - Source timeframe • htfOffset - Anchor offset • price - Price level • anchorPoint - "start", "end", or "middle" ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ EXPORTED FUNCTIONS ━━ CORE FUNCTIONS ━━ getTimeframeInfo(sourceTimeframe) Analyzes relationship between a source TF and chart TF. Returns: TimeframePair with comparison metadata createTracker(htfTimeframe) Creates a new HTF tracker. Call once per timeframe, store with `var`. Returns: HTFTracker instance updateTracker(tracker, htfTimeframe, historyDepth) Updates tracker with current bar data. Call on every bar. • htfTimeframe: The timeframe string (must match createTracker) • historyDepth: Max HTF bars to track (default 500) Returns: Updated tracker getStartBar(tracker, htfOffset) Gets chart bar_index where a specific HTF bar started. • htfOffset: 0=current, 1=previous, 2=two bars ago, etc. Returns: bar_index or na getEndBar(tracker, htfOffset) Gets chart bar_index where a specific HTF bar ended. Returns: bar_index or na htfBarChanged(tracker) Detects when HTF bar just changed. Returns: True on first chart bar of new HTF bar findBarAtTime(timestamp, maxLookback) Searches backward to find chart bar containing a timestamp. • maxLookback: How far back to search (default 500) Returns: bar_index or na syncEventToChart(tracker, eventPrice, eventTime, anchorPoint) Generic sync function mapping any event to correct chart position. • anchorPoint: "start", "end", or "middle" Returns: MTFEventData ━━ DRAWING CREATION FUNCTIONS ━━ syncedBox(tracker, leftHtfOffset, rightHtfOffset, topPrice, bottomPrice, bgcolor, ...) Creates a box at correct HTF-aligned position. • leftHtfOffset: HTF bars back for left edge • rightHtfOffset: HTF bars back for right edge • extendRight: Auto-extend to current bar Returns: SyncedBox or na syncedHLine(tracker, htfOffset, price, lineColor, lineStyle, lineWidth, extendRight) Creates horizontal line anchored to HTF bar start. • extendRight: If true, extends to current bar (default true) Returns: SyncedLine or na syncedVLine(tracker, htfOffset, atStart, lineColor, lineStyle, lineWidth) Creates vertical line at HTF bar boundary. • atStart: True=start of HTF bar, False=end Returns: SyncedLine or na syncedLabel(tracker, htfOffset, price, labelText, anchorPoint, ...) Creates label at correct HTF-aligned position. • anchorPoint: "start", "end", or "middle" Returns: SyncedLabel or na syncedPlotValue(tracker, value, htfOffset) Returns value for plotting only at synced positions. Returns: value if current bar is within HTF range, otherwise na ━━ UPDATE FUNCTIONS ━━ updateSyncedBox(syncedBox, extendToCurrentBar) Extends existing box's right edge to current bar. Returns: Updated SyncedBox updateSyncedLine(syncedLine, extendToCurrentBar) Extends existing horizontal line to current bar. Returns: Updated SyncedLine updateSyncedLabel(syncedLabel, tracker, newText, newPrice) Updates label text/price while maintaining sync. Returns: Updated SyncedLabel ━━ CONVENIENCE FUNCTIONS ━━ htfBarStartIndex(htfTimeframe, htfOffset, historyDepth) Simple function to get HTF bar start without explicit tracker. ⚠️ Only tracks ONE timeframe. For multiple TFs, use createTracker pattern. Returns: bar_index or na htfBarEndIndex(htfTimeframe, htfOffset, historyDepth) Simple function to get HTF bar end without explicit tracker. ⚠️ Only tracks ONE timeframe. For multiple TFs, use createTracker pattern. Returns: bar_index or na ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ COMPLETE USAGE EXAMPLES Example 1: FVG Box with Auto-Extend ``` //@version=6 indicator("FVG with Synced Drawing", overlay=true) import ArunaReborn/TimeframeAlign/1 as tfa htfInput = input.timeframe("60", "HTF for FVG") // Create tracker for chosen timeframe var tfa.HTFTracker fvgTracker = tfa.createTracker(htfInput) tfa.updateTracker(fvgTracker, htfInput) // Get FVG data from HTF (confirmed bars with offset) = request.security(syminfo.tickerid, htfInput, [low , high , low > high ], lookahead=barmerge.lookahead_off) // Store managed box var tfa.SyncedBox fvgBox = na // Create synced box when FVG detected if fvgDetected and tfa.htfBarChanged(fvgTracker) fvgBox := tfa.syncedBox(fvgTracker, 3, 1, fvgTop, fvgBot, color.new(color.green, 85), color.green, 1, "FVG", color.white, true) // Extend box to current bar each tick if not na(fvgBox) tfa.updateSyncedBox(fvgBox, true) ``` Example 2: HTF Support/Resistance Lines ``` //@version=6 indicator("HTF S/R Lines", overlay=true) import ArunaReborn/TimeframeAlign/1 as tfa htfInput = input.timeframe("240", "HTF for S/R") // Create and update tracker var tfa.HTFTracker srTracker = tfa.createTracker(htfInput) tfa.updateTracker(srTracker, htfInput) // Get HTF high/low (confirmed with offset) = request.security(syminfo.tickerid, htfInput, [high , low ], lookahead=barmerge.lookahead_off) // Track lines var tfa.SyncedLine resistanceLine = na var tfa.SyncedLine supportLine = na // Create new lines when HTF bar changes if tfa.htfBarChanged(srTracker) resistanceLine := tfa.syncedHLine(srTracker, 1, htfHigh, color.red, line.style_solid, 2, true) supportLine := tfa.syncedHLine(srTracker, 1, htfLow, color.green, line.style_solid, 2, true) // Auto-extend lines each bar if not na(resistanceLine) tfa.updateSyncedLine(resistanceLine, true) if not na(supportLine) tfa.updateSyncedLine(supportLine, true) ``` Example 3: Multiple Timeframes ``` //@version=6 indicator("Multi-TF Boxes", overlay=true) import ArunaReborn/TimeframeAlign/1 as tfa // Create separate tracker for each timeframe var tfa.HTFTracker tracker1H = tfa.createTracker("60") var tfa.HTFTracker tracker4H = tfa.createTracker("240") var tfa.HTFTracker trackerD = tfa.createTracker("1D") // Update ALL trackers every bar (pass the same TF string) tfa.updateTracker(tracker1H, "60") tfa.updateTracker(tracker4H, "240") tfa.updateTracker(trackerD, "1D") // Now use each tracker independently for drawing // Each tracker maintains its own separate boundary history ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ NON-REPAINTING COMPLIANCE To ensure non-repainting behavior, always use this pattern with request.security: ``` = request.security(syminfo.tickerid, htfTimeframe, [value1 , value2 ], // Use offset for confirmed data lookahead=barmerge.lookahead_off) // Never use lookahead_on ``` The ` ` offset ensures you're using the previous completed HTF bar, not the current forming bar. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ HISTORY DEPTH PARAMETER The `historyDepth` parameter controls how many HTF bars are tracked: • Default: 500 HTF bars • Maximum: Limited by Pine Script's array constraints • Higher values = more historical accuracy but more memory usage • Lower values = less memory but may return `na` for older offsets Adjust based on your needs: ``` tfa.updateTracker(tracker, 100) // Track 100 HTF bars (light) tfa.updateTracker(tracker, 1000) // Track 1000 HTF bars (heavier) ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ IMPORTANT NOTES 1. One Tracker Per Timeframe : If you need multiple HTFs, create separate trackers for each. The convenience functions (htfBarStartIndex, htfBarEndIndex) only track one TF. 2. Update Every Bar : Always call updateTracker() unconditionally on every bar, not inside conditionals. 3. HTF Only : This library is designed for Higher Timeframe data. For LTF aggregation, use findBarAtTime() for time-based lookups. 4. Drawing Limits : Pine Script has limits on drawing objects. Use box.delete(), line.delete(), label.delete() to clean up old objects. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ TROUBLESHOOTING Q: My boxes/lines still appear at wrong positions A: Make sure you're calling updateTracker() on every bar (not inside an if statement) and using the correct htfOffset values. Q: Functions return na A: The htfOffset might be larger than available history. Increase historyDepth or use a smaller offset. Q: Multiple timeframes don't work correctly A: Don't use the convenience functions for multiple TFs. Create separate HTFTracker instances with createTracker() for each timeframe. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ CHANGELOG v1 - Initial release • HTFTracker pattern for reliable multi-TF tracking • Synced drawing functions for boxes, lines, labels • Update functions for extending drawings • Convenience functions for simple single-TF use cases
Pine Script® library
by ArunaReborn