Use your browser’s Find (Ctrl+F / ⌘F) to locate a setting. Open its row for the full explanation and limits. Source-check time is a verification timestamp, not a script publication date.
![Trade Excursion Engine [AGPro Series] actual TradingView interface on BONKUSDT (1D)](../images/product-settings/33-1.jpg)
Excursion Trigger
8 inputsTrigger
- Input type
string- Source default
"N-bar Breakout"- Available options
["N-bar Breakout", "Momentum Thrust", "Every Bar"]- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
The neutral, direction-aware event whose forward excursions are measured.
Effect on the script
'Every Bar' samples each eligible closed bar; its forward windows overlap and are not independent trades.
When to adjust it
Change it only when the specific analytical or presentation question in the tooltip changes.
Interpretation and limits
'Every Bar' samples each eligible closed bar; its forward windows overlap and are not independent trades.
Original input tooltip
The neutral, direction-aware event whose forward excursions are measured. 'Every Bar' samples each eligible closed bar; its forward windows overlap and are not independent trades.
Breakout lookback
- Input type
int- Source default
20- Available options
Not specified in source- Minimum
2- Maximum
200- Step
Not specified in source
What it controls
Number of preceding bars used to define the breakout reference.
Effect on the script
The long trigger compares the close with the prior rolling highest high; the short trigger compares it with the prior rolling lowest low. This window also participates in measurement readiness.
When to adjust it
Change it when studying a different breakout-reference horizon, before comparing the resulting sample.
Interpretation and limits
A new window changes which events qualify. A breakout trigger is not a trade entry or proof of continuation.
Thrust size (ATR ×)
- Input type
float- Source default
1.0- Available options
Not specified in source- Minimum
0.1- Maximum
10.0- Step
0.1
What it controls
For Momentum Thrust: how large a one-bar move counts as a trigger.
Effect on the script
The momentum-thrust comparison requires the absolute one-bar close change to exceed this multiplier of the reference ATR.
When to adjust it
Change it only when the specific analytical or presentation question in the tooltip changes.
Interpretation and limits
Record the configuration when comparing observations; a changed setting is not proof of a stronger future result.
Original input tooltip
For Momentum Thrust: how large a one-bar move counts as a trigger.
Forward window (bars)
- Input type
int- Source default
20- Available options
Not specified in source- Minimum
3- Maximum
200- Step
Not specified in source
What it controls
How many bars after each trigger the favorable and adverse excursions are measured over.
Effect on the script
Changes the time window or deadline in which the documented event and follow observations are evaluated.
When to adjust it
Change it when studying another explicitly defined event or observation horizon.
Interpretation and limits
A different window changes eligibility, timeouts, or completed observations. Pending and excluded cases must remain distinct from resolved results.
Original input tooltip
How many bars after each trigger the favorable and adverse excursions are measured over.
Adverse percentile
- Input type
int- Source default
75- Available options
Not specified in source- Minimum
50- Maximum
95- Step
Not specified in source
What it controls
Percentile of the historical MAE distribution used for the adverse reference. 75 means three-quarters of sampled observations had equal or lower heat.
Effect on the script
Selects the linearly interpolated percentile of the sorted adverse-excursion sample and names the corresponding heat reference on the chart.
When to adjust it
Change it only when the specific analytical or presentation question in the tooltip changes.
Interpretation and limits
Record the configuration when comparing observations; a changed setting is not proof of a stronger future result.
Original input tooltip
Percentile of the historical MAE distribution used for the adverse reference. 75 means three-quarters of sampled observations had equal or lower heat.
Same-bar target & stop
- Input type
string- Source default
"Exclude"- Available options
["Exclude", "Stop First", "Target First"]- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
OHLC bars cannot reveal whether target or stop occurred first when both are touched.
Effect on the script
Exclude avoids inventing an order; the other modes apply an explicit sensitivity assumption.
When to adjust it
Use it for a stated ambiguity-policy comparison while keeping all other observation settings fixed.
Interpretation and limits
Exclude avoids inventing an order; the other modes apply an explicit sensitivity assumption.
Original input tooltip
OHLC bars cannot reveal whether target or stop occurred first when both are touched. Exclude avoids inventing an order; the other modes apply an explicit sensitivity assumption.
Minimum samples
- Input type
int- Source default
30- Available options
Not specified in source- Minimum
10- Maximum
500- Step
Not specified in source
What it controls
Minimum rolling excursion sample count required for the ready state.
Effect on the script
The ready condition requires the available sample count to reach this threshold and the measurement-data guard to be valid.
When to adjust it
Use it to specify the minimum amount of excursion evidence required before reading the live reference geometry.
Interpretation and limits
Passing the threshold does not establish independent samples, future reliability, or a profitable edge.
ATR length
- Input type
int- Source default
14- Available options
Not specified in source- Minimum
1- Maximum
100- Step
Not specified in source
What it controls
ATR measurement length for the excursion normalization unit.
Effect on the script
The script calculates ATR using this length, then uses the event-time ATR to express favorable and adverse distances in comparable volatility units.
When to adjust it
Change it only when deliberately changing the volatility measurement window used by the study.
Interpretation and limits
Changing the unit changes the study; ATR-normalized references are not guarantees of attainable travel or maximum adverse movement.
Visuals
6 inputsReference anchor
- Input type
string- Source default
"Confirmed Close"- Available options
["Confirmed Close", "Live Preview"]- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Confirmed Close keeps the bracket anchored to the latest closed-bar price, ATR and EMA direction.
Effect on the script
Live Preview moves with the open candle. Both are historical-distribution references, not trade targets or probability forecasts.
When to adjust it
Choose the confirmed reference for closed-bar review; use a live option only when deliberately examining the open candle.
Interpretation and limits
Both are historical-distribution references, not trade targets or probability forecasts.
Original input tooltip
Confirmed Close keeps the bracket anchored to the latest closed-bar price, ATR and EMA direction. Live Preview moves with the open candle. Both are historical-distribution references, not trade targets or probability forecasts.
Show heat / reach bracket
- Input type
bool- Source default
true- Available options
Not specified in source- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Shows or hides the current heat-and-reach reference drawing.
Effect on the script
Controls the live bracket presentation; the historical excursion distributions remain the analytical basis.
When to adjust it
Hide it when reviewing evidence without the projected drawing, or show it when studying the reference geometry.
Interpretation and limits
This is a display control. The bracket does not place orders, define an actual trade, or predict price travel.
Show trigger markers
- Input type
bool- Source default
true- Available options
Not specified in source- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Shows or hides the confirmed long and short trigger markers.
Effect on the script
The plot conditions require this toggle, a confirmed bar, valid measurements, and the relevant trigger; hiding the markers does not redefine the trigger.
When to adjust it
Use it to inspect where eligible historical events occurred or to reduce visual clutter.
Interpretation and limits
Trigger markers identify sampled events, not executed entries or fills.
Show heat / reach verdict
- Input type
bool- Source default
true- Available options
Not specified in source- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Shows or hides the compact heat/reach verdict presentation.
Effect on the script
Controls the on-chart summary of the currently calculated reference context.
When to adjust it
Show it for an at-a-glance geometry review or hide it when the panel supplies enough context.
Interpretation and limits
The verdict summarizes historical-distribution context and is not a direction or profit forecast.
Bracket length (bars)
- Input type
int- Source default
18- Available options
Not specified in source- Minimum
3- Maximum
100- Step
Not specified in source
What it controls
Horizontal width of the live heat-versus-reach bracket.
Effect on the script
Sets the horizontal distance from the live bracket left edge to its right edge; the centered labels follow the midpoint.
When to adjust it
Adjust it when the available forward chart space or the intended visual review area changes.
Interpretation and limits
Drawing farther to the right does not extend event validity or establish that price will reach a reference.
Original input tooltip
Horizontal width of the live heat-versus-reach bracket. A wider bracket improves readability in compact publication previews.
Label size
- Input type
string- Source default
"Normal"- Available options
["Tiny", "Small", "Normal", "Large"]- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Controls the text size for label size.
Effect on the script
Controls the text-size mapping used by the relevant panel or chart-label renderer.
When to adjust it
Adjust it for the chart size and viewing distance while preserving readable boundaries and state information.
Interpretation and limits
A larger font can increase chart overlap. Text size does not change the analytical observations.
Decision Panel
5 inputsPanel page
- Input type
string- Source default
"Overview"- Available options
["Overview", "Evidence"]- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Overview shows the current reference geometry.
Effect on the script
Evidence separates rolling excursion samples from the lifetime, non-overlapping reach-first audit and its exclusions.
When to adjust it
Use the current-state view for orientation and the available evidence/audit view when checking observation provenance and exclusions.
Interpretation and limits
A compact or hidden view does not remove the limitations of the underlying observations.
Original input tooltip
Overview shows the current reference geometry. Evidence separates rolling excursion samples from the lifetime, non-overlapping reach-first audit and its exclusions.
Show panel
- Input type
bool- Source default
true- Available options
Not specified in source- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Shows or hides the workflow panel.
Effect on the script
Controls whether the workflow table is rendered on the chart.
When to adjust it
Show the panel to inspect the state and evidence, or hide it when chart space is the immediate priority.
Interpretation and limits
Hiding the panel is a presentation choice; do not treat missing rows as missing risk.
Panel position
- Input type
string- Source default
"Top Right"- Available options
["Top Right", "Top Left", "Bottom Right", "Bottom Left", "Middle Right"]- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Selects where the workflow panel is placed on the chart.
Effect on the script
Selects the table position used by the panel renderer.
When to adjust it
Move the panel when it overlaps active candles, the current workflow zone, or reference labels.
Interpretation and limits
Panel placement changes presentation, not the detected context or observation accounting.
Theme
- Input type
string- Source default
"Dark"- Available options
["Dark", "Light"]- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Selects the available panel contrast theme.
Effect on the script
Selects the panel background, border, and text color scheme used for contrast.
When to adjust it
Choose the available theme that keeps the panel readable against the chart background.
Interpretation and limits
A theme changes appearance; it does not change event qualification or statistical evidence.
Panel font size
- Input type
string- Source default
"Normal"- Available options
["Tiny", "Small", "Normal", "Large"]- Minimum
Not specified in source- Maximum
Not specified in source- Step
Not specified in source
What it controls
Controls the text size for panel font size.
Effect on the script
Controls the text-size mapping used by the relevant panel or chart-label renderer.
When to adjust it
Adjust it for the chart size and viewing distance while preserving readable boundaries and state information.
Interpretation and limits
A larger font can increase chart overlap. Text size does not change the analytical observations.
Keep the settings in context
Change one analytical assumption at a time and compare the same instrument, timeframe and history. A chart reference, score, observation rate or input default does not establish a trade fill, a forward probability or a guaranteed outcome.
Return to the product overview · View this script on TradingView