Swing Failure Pattern (SFP) Engine [AGPro Series]

Apr 19

Swing Failure Pattern (SFP) Engine [AGPro Series]

────────────────────────────────────────────────────────────
OVERVIEW
────────────────────────────────────────────────────────────

Swing Failure Pattern (SFP) Engine detects high-probability liquidity sweep
events at prior swing highs and lows. An SFP occurs when price pierces a
recent swing level with a long wick but closes back inside the prior range,
signalling failed continuation and potential mean reversion. Each event is
scored on four components, drawn as a mid-sized support/resistance reaction
zone, and tracked through its live cycle — with panel statistics on MFE,
MAE, and hit rate. Designed for visual pattern reading and confluence;
not a buy/sell system.


────────────────────────────────────────────────────────────
UNIQUE EDGE
────────────────────────────────────────────────────────────

Most SFP indicators mark the sweep candle and stop there. This engine treats
each SFP as a living support/resistance band: the zone extends to the right
every bar and only freezes when the swept level is actually broken on close.
That preserves the SR context that traders use in real decisions, without
cluttering charts with zones that never die. A composite score (0-100),
confluence grouping of nearby events within 0.5 ATR, and live MFE/MAE
tracking in ATR units turn a common pattern into a measurable framework.


────────────────────────────────────────────────────────────
METHODOLOGY
────────────────────────────────────────────────────────────

Swing detection uses pivot highs and lows confirmed by a configurable
lookback. An SFP is confirmed on bar close when four conditions are met:

1. The bar wicks beyond a prior unswept swing high (bearish) or swing low
(bullish) within the active lookback window.
2. The close reclaims the prior range by at least the user-defined ATR
distance (default 0.25 ATR).
3. The sweep-side wick represents at least the minimum wick ratio of total
bar range (default 55 percent).
4. Bar volume exceeds its 20-period SMA by the configured multiplier
(optional, default 1.15x).

Composite score (0-100) weights wick ratio (40), reclaim distance in ATR
(30), volume confirmation (15), and swing age (15). Only events above the
minimum score threshold are drawn. Each confirmed SFP removes its swept
swing from the active array to prevent re-triggering on the same level.
Confluence grouping merges same-side events within 0.5 ATR into a single
labelled zone with an x2, x3 count.


────────────────────────────────────────────────────────────
SIGNALS & ALERTS
───────────────────────────────────────────────────────────

Visual signals on chart:

- State-coloured label at the sweep bar reading Bull SFP or Bear SFP with
the composite score (e.g., Bull SFP 74). Confluence-grouped events are
suffixed with the merge count (e.g., Bear SFP 81 x2).
- Rectangular zone spanning the swept level and the SFP close, with a
small ATR buffer. The zone extends right each bar while active and
freezes in neutral grey when the swept level breaks.
- Dotted horizontal line marking the swept swing level.
- Dashed projection line indicating the reversal direction.

Alert conditions:

- Bullish SFP: fires on the confirmation bar of a bullish event above
the score threshold.
- Bearish SFP: same, for bearish events.
- Zone Invalidation (optional): fires when an active zone's swept level
is broken on close.


────────────────────────────────────────────────────────────
KEY INPUTS
────────────────────────────────────────────────────────────

Detection:
- Swing Pivot Length - bars each side of a pivot (default 5).
- Swing Lookback - how far back active swings are tracked (default 120).
- Min Wick Ratio - minimum sweep wick as fraction of bar range (0.55).
- Min Reclaim Distance (ATR) - how far close must reclaim (0.25 ATR).
- Require Above-Average Volume and Volume Multiplier (default 1.15x).
- ATR Length (default 14).

Scoring & Filters:
- Min SFP Score (default 55 of 100).
- Max Active Zones retained on chart (default 8).
- Stats Timeout - bars after which an unresolved event is counted in
averages (default 30). Does not affect zone visibility.

Visuals:
- Zone transparency (default 80), confluence grouping distance (0.5 ATR),
label size, and toggles for zones, swing lines, and reversal projections.

Panel:
- Location (8 options), Dark/Light theme, text size.

Alerts:
- Independent toggles for bullish, bearish, and invalidation alerts.


────────────────────────────────────────────────────────────
HOW TO USE
────────────────────────────────────────────────────────────

Apply the indicator to any chart and timeframe. Higher timeframes (1h and
above) produce cleaner swings; lower timeframes require a higher Min Wick
Ratio and Min Score to filter noise.

Read SFPs as liquidity sweep events, not standalone entries. A bullish SFP
below a prior swing low indicates that sellers failed to extend the move —
often a location where larger participants accumulate. The score reflects
sweep quality; higher scores (70+) generally correspond to cleaner
rejections. Use the zone as a support/resistance reference until it is
invalidated.

Panel statistics describe the observed sample on the loaded chart, not a
backtested system. MFE Hit Rate is the percent of resolved zones that
reached 1 ATR in the SFP direction before the swept level broke — it is a
quality reference, not a win rate for any trading strategy.


────────────────────────────────────────────────────────────
LIMITATIONS & TRANSPARENCY
────────────────────────────────────────────────────────────

- Signals confirm on bar close; intrabar conditions may change until close.
- Pivot detection introduces a natural bars-of-right-context lag equal to
the Pivot Length. This is intrinsic to any pivot-based approach.
- Panel statistics reflect events visible on the current chart load and
will vary with timeframe, symbol, and bar range.
- MFE Hit Rate is not a profit expectation. It measures whether price
moved 1 ATR in the SFP direction before the swept level broke.
- Volume confirmation uses chart volume and may behave differently on
symbols with inconsistent volume data.
- The indicator uses standard Pine Script drawing objects. Chart reload
may reset ephemeral visual states of resolved zones.


────────────────────────────────────────────────────────────
RISK DISCLOSURE
────────────────────────────────────────────────────────────

This indicator is a visualisation and analysis tool. It is not a trading
system, not financial advice, and not a signal service. It does not
predict future price movement. All trading decisions carry risk of loss
and are the sole responsibility of the user. Historical pattern behaviour
does not guarantee future results. Test thoroughly on your instruments
and timeframes before making any decisions.

May 25

Release Notes

🔧 UPDATE NOTES - V1.8

This update focuses on zone ownership, chart readability, and first-glance clarity.

The core purpose of the script remains unchanged.
This release improves how active SFP zones are identified and read on the chart.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Added centered SFP zone badges
Active bull and bear SFP zones can now display separate centered badges inside the zone area.

• Added zone badge score option
Users can choose whether the zone badge includes the SFP quality score.

• Improved zone ownership
Each active zone now has clearer visual identity, reducing the chance that a zone looks disconnected from its SFP event.

• Linked badges to zone lifecycle
Zone badges move with expanding zones and fade with invalidated zones when invalidation fade is enabled.


------------------------
Visual Improvements
------------------------

• Improved chart readability by adding centered zone identifiers

• Refined visual hierarchy so active SFP zones stand out without relying on box text

• Preserved clean chart structure by using separate badges instead of embedded zone text

• Improved active zone interpretation on wider screenshots and higher timeframes


------------------------
Interface & Usability
------------------------

• Added Show Zone Badges input

• Added Show Zone Badge Score input

• Zone badges follow the existing label font-size setting

• Existing event labels, panel controls, and zone behavior remain familiar


------------------------
Behavior Notes
------------------------

This update does not change the core SFP detection or scoring logic.

The goal is to improve visual clarity and zone attribution, not to add predictive behavior.

Users should interpret SFP zones the same way as before, now with clearer zone identity.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, and timeframe differences may affect how SFP zones appear.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.