Get started

Return

Trap Failure Planner [AGPro Series]Trap Failure Planner 🧠 Core Idea Is the trap thesis itself failing and handing control back through the edge? 📌 Overview / What it does Trap Failure Planner is a chart-first control-return planner for traders who study trap behavior, failed participation, false break recovery, and post-trap execution readiness. Instead of only marking the first trap or false break, the script watches the second step: after a trap thesis appears, does that thesis keep control, or does price return through the trap edge with enough quality to matter? It produces a 0-100 Failure Score, trap thesis zones, control-return labels, risk-edge guides, target-guide references, alerts, and a compact AG Pro planning panel. It does not predict future price, automate entries, or claim that a control return must continue. Its role is to organize one specific decision question with clean visual structure. 🎯 Purpose & Design Philosophy This script was built to fill the gap between first-touch trap markers and practical trade review. Many tools stop when price runs a level and closes back inside. That can be useful, but traders still need to know whether the trap thesis survives after the first reaction. Trap Failure Planner focuses on that later decision point: is the trap still in control, or did the other side reclaim the edge? The design supports a planner mindset. It helps traders evaluate state, score, risk edge, target context, and next action without turning the chart into a crowded signal board. ⚡ Why This Script Is Different Most tools focus on the first false break, sweep, trap label, or reclaim back inside a range. This script does NOT try to become another false-break trap detector, inducement scanner, liquidity grab detector, stop-hunt map, order block map, or generic support / resistance zone tool. Instead, it focuses on the failure of the trap thesis itself. The workflow begins only after a trap thesis exists, then waits for control to return through the edge with persistence, follow-through, volume response, and acceptance quality. That makes it a second-stage trap failure planner, not a first-stage trap detector. ⚙️ Methodology 1. Context Detection The script builds recent upper and lower trap-thesis rails from prior price action and normalizes behavior with ATR. 2. Reference Mapping When price probes beyond a rail and closes back inside, the script maps a trap thesis zone between the rail and the probe extreme. 3. Reaction Evaluation The planner tracks whether price returns through the trap edge within the failure window. The 0-100 model evaluates false break behavior, close recovery, follow-through, volume spike, control-return persistence, and level acceptance. 4. Visual Output Qualified events print Trap Failed labels, retain the centered trap zone, and project risk-edge and target-guide references. 🗺️ How to Read the Chart Zones = the active trap thesis area between the control edge and the probe extreme. Labels = trap thesis states, sparse testing states, and confirmed Trap Failed events. Colors = teal for bullish control-return context, pink for bearish control-return context, yellow for testing states, indigo for target guides, and red for risk edges. Panel = the AG Pro summary showing Trap State, Failure Score, Control Shift, Risk Edge, and Action. 🚦 Signals & States • Upper Trap Thesis → price probed above the upper rail and closed back inside; the planner watches whether that trap thesis survives. • Lower Trap Thesis → price probed below the lower rail and closed back inside; the planner watches whether that trap thesis survives. • Return Test → price is challenging the trap edge, but the score or close-count requirement is not complete yet. • Bull Control Return → an upper trap thesis failed and control returned back above the edge. • Bear Control Return → a lower trap thesis failed and control returned back below the edge. 🔔 Alerts Logic Alerts trigger when upper or lower trap thesis states appear and when qualified bull or bear control-return events are confirmed. High-score alerts require the event score to meet the selected alert threshold. Alerts are attention markers only. They are not trade instructions, entry commands, or outcome guarantees. 🧩 Confluence Logic The score becomes stronger when the trap thesis probe is clean, price returns through the trap edge, the return holds for the required close count, follow-through expands, volume rises relative to baseline, and the close location supports the control-return side. When these components align, the trap failure context becomes cleaner. When they do not align, the script stays in watch, return-test, or reset mode. 📊 When to Use • Markets with visible trap and failed-participation behavior • False break structures where the first trap thesis may fail • Breakout or breakdown attempts that get rejected, then reclaim control again • Range-edge reviews where traders need a second-stage decision layer ⚠️ When NOT to Use • Extremely low-liquidity symbols • Very noisy micro timeframes with erratic wicks • News spikes where structure changes too quickly • Charts where recent rails are not meaningful planning references 🎛️ Key Inputs • Planner Side → choose Auto, Bull Return Only, or Bear Return Only. • Trap Thesis Lookback → controls the rolling reference rails used for trap thesis detection. • Failure Window Bars → defines how long a trap thesis remains active before reset. • Control Return Closes → defines how many closes beyond the edge are required for confirmation. • Minimum Failure Score → controls how selective confirmed Trap Failed labels are. • Control Return Buffer ATR → controls how much acceptance beyond the edge is required. • Risk / Target Settings → control planning guide placement. • Visual Settings → control zones, guides, labels, panel location, theme, and font sizes. 🖥️ Interface & Visual Design The panel is built for fast review: state first, score second, control shift third, then risk and action. The trap thesis zone includes centered text so the chart remains readable without extra floating explanations. Labels are compact, offset away from candles, and controlled by cooldown and maximum-visible settings. 🧪 Practical Usage Workflow 1. Read the panel to identify whether a trap thesis is active or already failed. 2. Check the trap thesis zone and the edge being tested. 3. Review the Failure Score and Control Shift rows. 4. Use the Risk Edge and target guide as planning references. 5. Confirm the event inside broader market context. 🔍 Interpretation Guidelines Think in terms of control, not prediction. A trap thesis label means price created a possible trap context. A Trap Failed label means that thesis lost control according to the script rules. A higher score means the failure was cleaner across the model components, not that the next move is guaranteed. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a false-break trap detector clone • Not an inducement scanner • Not a liquidity grab detector • Not a support / resistance zone scanner • Not an order block or fair value gap map ⚠️ Limitations & Transparency Trap behavior depends on timeframe, liquidity, spread, volatility, and market context. The script uses a deterministic ruleset. It cannot know news context, hidden order flow, participant intent, or whether a control return will continue. More aggressive settings may show more events but also more noise. More conservative settings may improve selectivity while reducing frequency. 🧠 Market Context Notes Trap thesis failure often becomes more meaningful when it aligns with broader structure, volatility expansion, session context, or liquidity behavior. The script is designed to organize that review, not replace it. 🧾 Use Case Examples When price probes above a recent upper rail, closes back inside, and later returns above that edge with persistence and follow-through, the planner can mark Bull Control Return if the score is strong enough. When price probes below a recent lower rail, closes back inside, and later returns below that edge with acceptance, the planner can mark Bear Control Return. 🧱 System Philosophy AGPro decision tools are built to reduce chart ambiguity by turning raw price events into structured review states. Trap Failure Planner follows that philosophy by separating the first trap thesis from the later question of whether that thesis actually survives. 🔐 Non-Promise Statement No indicator can remove uncertainty. No script can guarantee direction, continuation, reversal, or profit. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions, risk management, position sizing, and interpretation. This script is for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use this script to study what happens after a trap thesis forms. The key question is not only whether price created a trap, but whether that trap can continue to defend control.
Pine Script® indicator
by AGProLabs
Dynamic Acceptance Channel [AGPro Series]Dynamic Acceptance Channel 🔷 Overview Dynamic Acceptance Channel is an adaptive volatility channel that builds a dynamic upper and lower edge around a robust median midpoint. The channel width breathes with the market's own return distribution and volatility regime, so it naturally widens when the market expands and tightens when it compresses. Every bar is classified as Inside, Breaching, or Respecting the channel, while the width itself is independently tracked as Compressed, Normal, or Expanded. The tool is designed to give traders a clean, consistent framework for reading acceptance, mean-reversion context, volatility squeezes, and adaptive range behavior across crypto, FX, and equities. 🟢 Unique Edge Most channel indicators on the market rely on a single dispersion model — typically a moving average plus a fixed standard deviation or ATR multiplier. Dynamic Acceptance Channel takes a different route: ▪ Robust median midpoint instead of a simple mean, which stays stable when the market wicks or spikes and is not dragged around by outliers. ▪ Hybrid width model that combines the percentile spread of recent returns with a clamped ATR regime ratio. The user can switch between Hybrid, Return Percentile, or Volatility Regime, depending on whether distribution shape or raw volatility is the priority. ▪ Independent width regime classification (Compressed / Normal / Expanded) ranked against the channel's own history, with hysteresis applied so the regime does not flip-flop around threshold boundaries. ▪ Bar-level state machine (Inside, Breach, Respect) separated from the width regime, so traders can read location and regime as two orthogonal dimensions. ▪ Double-EMA smoothing on both the midpoint and the half-width, producing a calm, professional channel that is readable on any timeframe without looking jagged. This combination is not found in common Bollinger Bands, Keltner Channels, or generic ATR channels. 🧭 Methodology The midpoint is computed as a rolling median using linear-interpolation percentile logic, which is statistically more robust than an arithmetic mean when the return distribution is skewed or heavy-tailed. The half-width is then derived from two independent signals. The first is a return-percentile dispersion term: the script measures the 85th and 15th percentiles of recent per-bar returns, symmetrizes them, and scales by the square root of the lookback window to produce a percentile-based half-width proxy. The second is a volatility regime term: the current 14-bar ATR is compared to its own baseline over the adaptive window, and the resulting ratio is clamped between 0.6 and 1.8 to prevent explosive widths during regime shocks. The final half-width is either one of the two terms or their average, depending on the selected model, then scaled by a user-defined global multiplier and smoothed with double EMA. The width regime classification uses linear-interpolation percentiles of the channel width itself over a separate regime lookback, and a 10% hysteresis buffer prevents rapid state flipping around the Compressed and Expanded thresholds. 🎯 Signals & Alerts ▪ Channel Breached — fires on a fresh upper or lower breach, edge-triggered with a minimum three-bar gap to avoid clusters on choppy bars. ▪ Channel Compressed — fires when the width regime transitions into the Compressed state. ▪ Channel Expanded — fires when the width regime transitions into the Expanded state. ▪ Channel Respected — optional, fires when price wicked outside on the prior bar and closed back inside on the current bar, confirming a rejection at the edge. Visuals include color-coded upper and lower lines, a regime-tinted fill, small circular breach markers on the breached line (no text labels to avoid clutter), and spaced Compressed or Expanded transition labels anchored outside the channel. ⚙️ Key Inputs Adaptive Engine ▪ Adaptive Length — lookback window for the channel (default 60). ▪ Channel Width Model — Hybrid, Return Percentile, or Volatility Regime. ▪ Width Scale — global multiplier for tightening or loosening the channel. ▪ Channel Smoothing — EMA length for line smoothness. ▪ Strict Breach Logic — close-based versus wick-based breach. Width Regime ▪ Compression Threshold — percentile below which the width is Compressed (default 25). ▪ Expansion Threshold — percentile above which the width is Expanded (default 75). ▪ Regime Lookback — lookback for the width percentile ranking (default 150). Visuals ▪ Show Channel Fill, Show Midline, Show Breach Markers, Show Regime Transition Labels, Regime Label Spacing. Panel ▪ Show / hide panel, Panel Location (6 options), Panel Font Size, Label Font Size. Alerts ▪ Channel Breached, Compressed, Expanded, and Respected can be toggled independently. 🧠 How to Use A common reading is to combine channel state with width regime. When the channel is Compressed and price is riding the edges, the market is often preparing for an expansion phase. When the channel transitions into Expanded, continuation on the active edge is more likely than immediate mean reversion. Respect events at either edge during Normal or Compressed regimes often line up with fade opportunities, while breaches during Expanded regimes often line up with trend continuation context. The midline can be used as a dynamic fair-value reference for pullback entries inside the channel. Traders typically overlay this script with their own structure, momentum, or higher-timeframe bias tools rather than using channel events in isolation. ⚠️ Limitations & Transparency ▪ The indicator is a context and structure tool. It does not generate buy or sell decisions and does not claim to identify every meaningful reversal or breakout. ▪ The channel is recomputed each bar from recent data, which means the current bar's channel values can refine until bar close. ▪ Width regime classification is relative to the regime lookback, not absolute. On instruments or timeframes with very low variance, the regime may behave differently than on highly volatile markets. ▪ The ATR ratio is intentionally clamped between 0.6 and 1.8. This prevents explosive widths but also means the channel will not fully mirror extreme volatility shocks; this is a deliberate design choice for readability. ▪ Alerts are configured to fire once per bar close to reduce noise. Intrabar conditions may change until close. 🛡 Risk Disclosure This script is provided for educational and analytical purposes only. It is not a strategy, not financial advice, and not a trade recommendation. Past channel behavior on any instrument or timeframe does not imply future performance. Users are fully responsible for their own risk management, position sizing, and trading decisions.
Pine Script® indicator
by AGProLabs
VWAP NYO DeviationVWAP - Deviation At NYO A clean, real-time overlay indicator that instantly shows how the major liquid markets are opening relative to their developing daily VWAP — plus powerful historical context in one compact table. What the table displays (updated live on every chart): Symbol – ES1!, CL1!, GC1!, 6E1!, BTCUSD Deviation (%) – Today’s RTH open (9:30 AM EST) vs. the VWAP up to that exact moment, expressed as a percentage. → Green background = opening above average deviation → Red background = opening below average deviation Avg Abs Dev (%) – Historical average absolute opening deviation (all completed days on your chart) Touch VWAP % – Percentage of completed trading days where price touched the daily VWAP at least once during Regular Trading Hours (9:30–16:00 EST) Additional features On your main chart symbol, a clean colored label automatically appears at the exact 9:30 AM EST bar showing that symbol’s opening VWAP deviation (green up / red down). Fully automatic EST/New York timezone handling — works on any timeframe and any symbol you’re viewing. Table text size is fully customizable (tiny → large / auto). Best for Futures & BTC day traders who use VWAP as a primary reference Quick cross-market bias check at the open Mean-reversion / VWAP magnet strength analysis Monitoring how “stretched” the open is versus historical norms Simply add the indicator, and the table appears in the top-right corner. The more history loaded on your chart, the more accurate the average deviation and touch percentage become. Perfect companion for any VWAP-based strategy. Enjoy! 🚀
Pine Script® indicator
by Resonant_Trader
Rolling Performance Toolkit (Returns, Correlation and Sharpe)This script provides a flexible toolkit for evaluating rolling performance metrics between any asset and a benchmark. Features: Library-based: Built on a custom utilities library for consistent return and statistics calculations. Rolling Window Control: Choose the lookback period (in days) to calculate metrics. Multiple Modes: Toggle between Rolling Returns, Rolling Correlation, and Rolling Sharpe Ratio. Benchmark Comparison: Compare your selected ticker against a benchmark (default: S&P 500 / SPX), but you can easily switch to any symbol. Risk-Free Rate Options: Choose from zero, a constant annual % rate, or a proxy symbol (default: US03M – 3-Month Treasury Yield). Annualized Sharpe: Sharpe ratios are annualized by default (×√252) for intuitive interpretation. This tool is useful for traders and investors who want to monitor relative performance, diversification benefits, or risk-adjusted returns over time.
Pine Script® indicator
by villia9
Annual Performance Table with Average PeformanceAn indicator that displays annual performance in a table format, providing a quick overview of yearly returns with historical context. It calculates the performance based on the first and last monthly close prices of each year. It displays returns chronologically from left to right, concluding with an average performance column. Features : Works exclusively on monthly timeframes Customizable number of years to display (1-50 years) Shows year-by-year performance percentages Color-coded returns (green for positive, red for negative) Includes average performance across displayed years Semi-transparent overlay design for better chart visibility Performance calculation method: Performance = ((December Close - January Close) / January Close) × 100% Usage : Apply to any chart on monthly timeframe Adjust the "Number of Years to Display" parameter as needed Table appears as an overlay with years, individual performances, and average Note: The indicator will display an error message if applied to any timeframe other than monthly.
Pine Script® indicator
by StephBour
All Candlestick Patterns on Backtest [By MUQWISHI]▋ INTRODUCTION : The “All Candlestick Patterns on Backtest” indicator generates a table that offers a clear visualization of the historical return percentages for each candlestick pattern strategy over a specified time period. This table serves as an organized resource, serving as a launching point for in-depth research into candle formations. It may help to rectify any misconceptions surrounding candlestick patterns, refine trading approaches, and it could be foundation to make informed decisions in trading journey. _______________________ ▋ OVERVIEW: _______________________ ▋ CREDIT: Credit to public technical “*All Candlestick Patterns*” indicator. _______________________ ▋ TABLE: _______________________ ▋ CHART: _______________________ ▋ INDICATOR SETTINGS: #Section One: Table Setting #Section Two: Backtest Setting (1) Backtest Starting Period.  Note: If the datetime of the first candle on the chart is after the entreated datetime, the calculation will start from the first candle on the chart. (2) Initial Equity ($). (3) Leverage: Current Equity x Leverage Value. (4) Entry Mode:  - “At Close”: Execute entry order as soon as the candle confirmed.  - “Breakout High (Low for Short)”: Stop limit buy order, entry order will be executed as soon as the next candle breakout the high of last pattern’s candle (low for short) (5) Cancel Entry Within Bars: This option is applicable with {Entry Mode = Breakout High (Low for Short)}, to cancel the Entry Order if it's not executed within certain selected number of bars. (6) Stoploss Range: the range refers to high of pattern - low of pattern. (7) Risk:Reward: the calculation of risk:reward range start from entry price level. For example: A pattern triggered with range 10 points, and entry price is 100.  - For 1:1~risk:reward would the stoploss at 90 and takeprofit at 110.  - For 1:3~risk:reward would the stoploss at 90 and takeprofit at 130. #Section Three: Technical & Candle Patterns _______________________ ▋ Comments: This table was developed for research and educational purposes. Candlestick patterns are almost similar as seen in “*All Candlestick Patterns*” indicator. The table results should not be taken as a major concept to build a trading decision. Personally, I see candlestick patterns as a means to comprehend the psychology of the market, and help to follow the price action. Please let me know if you have any questions. Thank you.
Pine Script® indicator
by MUQWISHI
29
Total ReturnThis script calculates a Total Return index for stocks that shows the total performance of a stock, incorporating returns from both the share price and dividends. To understand this, consider the situation where you invest in a 5% div stock and hold the position for 10 years. Assume at the end of 10 years, the price has gone up by 50%. A price chart will then show a 50% return, but in reality the investor has also received 50% of the initial investment in dividends, making his total return substantially more. Exactly how much more depends on whether the investor reinvested the dividends in the stock, or just held them as cash. If the former, his total return will be well over 100%; in the latter, his total return will be 100% exactly. There are 2 input options: - Dividend type: allows the user to choose "gross" or "net". Note that most stocks will have a "gross" data series whereas many will not have a "net" series. - Reinvestment: allows the user to choose whether dividends should be reinvested in the stock ("Yes") or held in cash ("No"). Total return formula: - With reinvestment: log((today's closing price + dividends paid today) / (yesterday's closing price)) - Without reinvestment: log(today's closing price / yesterday's closing price) + log (dividends paid thus far / first closing price)
Pine Script® indicator
by uzair67324
4
Return & Drawdown ReDraw script calculates the historical returns and drawdown for the given periods. By default, the return of the linear regression trends is displayed (can be turned off in settings). In this mode, two linear regression trends are being computed for both long and short periods, and the percent value indicates the "return of the trend" for the corresponding period. Observing the dynamic of the linear regression trends can give a great hint if the trend is slowing down. When the smoothing method is set to "none" or WMA3/5, the real asset return is shown for both periods, using the formula (LastPrice-FirstPrice)/FirstPrice The script calculates the maximum drawdown for the long period using the formula (max(Price) - LastPrice) / max(Price). The white line under the zero is the average maximum drawdown over the long period. When the mode is set to Compare, ReDraw will display the difference in metrics between the current and selected symbol (SPY by default).
Pine Script® indicator
by gaperton
1
Relative Performance TableThis indicator is based on the Performance section in the TradingView's sidebar and uses new Pine tables functionality, originally coded by @Beeholder. It compares the current price of the symbol to its past price and calculates the rate of return to make it easier to track the performance of the symbol. Note that the Performance sidebar is not updated in real-time, while this indicator is, so on real-time charts the values between the two can differ (the indicator's values are more recent). Made a number of enhancement from Bee's script including relative performance of a selected ticker, dynamic table columns, and other options. The formula of the calculation is (Current value - Past value) * 100 / Past value, where Past value is: 1W 1M 3M 6M 9M 52W (1 Year) WTD (Week to Date) MTD (Month to Date) YTD (Year to Date --Future development will include the ability to transpose the table columns/rows
Pine Script® indicator
by Wheeelman
1
compare returnsIt could be very useful to analyze market with events in the market instead of only looking at the isolated chart. This indicator helps you to compare returns of chart symbol with any other symbol in the same timeframe. For example, in crypto market coins move with the Bitcoin and BTC is driver of the market, so it could be useful to compare returns of a coin with the Bitcoin. There is a compare feature in tradingview, but it only compare from the beginning of the chart, not showing historical difference between returns which can reveals statistical opportunities or money flow in the market or between markets. This indicator take two parameters including base symbol and period: base symbol is the one which you need comparison with and period sets the period of comparison. For instance, with base symbol: BTCUSDT and period: 15, return of BTCUSDT from 15 previous candles is compared with the chart in 15 previous candles (on same timeframe). It could be helpful if you use this indicator to compare these pairs: - altcoins return with BTCUSDT return - stocks with their market index or industry index. - market indices: crypto total market cap with SP500 and GOLD please leave comment for me and this indicator to share your idea with me. thanks, hadi jamshidi
Pine Script® indicator
by hadijamshidi
1
Return (Percent Change)This Script displays Regular or Log Returns as either a line or histogram and labels the current bar. If something other than price is selected as the source, the result is percent change with a positive or negative slope. If a moving average of price is used as the source, the result is analogous to a strength index Other options include a look-back period adjustment (the default is 1), smoothing results by converting to an EMA, and Bollinger Bands with Length and Standard Deviation inputs.
Pine Script® indicator
by logan3
19
Return Error With Reference & Constant Value Enforcer FunctionsI found MichelT 's work thanks to LucF . One of its cool concepts that touched me was his error's function. Whenever something unexpected takes place, it returns an error's message right on the chart, one nobody can't say they can't see lol. I told him it would be cool if we could get specific messages related to specific cases, he said "there is a task for such feature". On the meantime I wanted to enrich his feature by making the function printing any number the user wants. Another really cool thing I have been in love with are "Pine Coding Conventions", I can't express enough how thankful I am to the amazing team behind it. Just recently they introduced me to a new rule, one seeming very popular across the board, using all capital letters to define a constant value. On this script I combined both error's printing message with a constant check functions that enforce the value must remain unchanged ever. I hope you like this work, I really enjoy seeing brilliant people coming up with some awesome ideas. Let's together make "Pine" a more cooler language.
Pine Script® indicator
by Quansium
2