AGProLabsBack to product

Full settings reference

Trade Excursion Engine [AGPro Series]
Full settings reference

Understand each input before changing your chart. The values below are the source-declared defaults; verified preset overrides and editability conditions are shown separately where available.

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)
Trade Excursion Engine on BONKUSDT, 1D: historical heat/reach references and the compact Overview panel. Actual historical interface capture associated with the source verified for this reference. Screenshot inputs may differ from source defaults; shown outcomes are not a performance promise.

Excursion Trigger

8 inputs
TriggerstringDefault: "N-bar Breakout"
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 lookbackintDefault: 20
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 ×)floatDefault: 1.0
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)intDefault: 20
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 percentileintDefault: 75
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 & stopstringDefault: "Exclude"
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 samplesintDefault: 30
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 lengthintDefault: 14
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 inputs
Reference anchorstringDefault: "Confirmed Close"
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 bracketboolDefault: true
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 markersboolDefault: true
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 verdictboolDefault: true
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)intDefault: 18
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 sizestringDefault: "Normal"
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 inputs
Panel pagestringDefault: "Overview"
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 panelboolDefault: true
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 positionstringDefault: "Top Right"
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.

ThemestringDefault: "Dark"
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 sizestringDefault: "Normal"
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