27/01/026 Spring & Upthrust Trap

1.1 Indicator Concept

This indicator is based on Wyckoff theory about "liquidity traps". The core idea is: large investors (smart money) intentionally push price to break through an important price zone to "trigger" stop loss orders from the crowd, then immediately reverse in the opposite direction.

There are two main types of traps:

• Spring (Bullish Trap): Price fakes a breakdown below the bottom of the price range (to trigger sell orders), but immediately bounces back strongly → bullish signal
• Upthrust (Bearish Trap): Price fakes a breakout above the top of the price range (to trigger buy orders), but immediately drops sharply → bearish signal

This indicator believes: when a breakout fails quickly, it's a sign that the trend is about to reverse strongly.

1.2 Indicator Features

• Display X-A-B-C geometry: Draws straight lines connecting 4 important points (X, A, B, C) forming the trap shape. Green lines for Spring (bullish), red for Upthrust (bearish).
• Display price zone box: Draws a rectangle (box) with light fill between points X and A, representing the "price zone" where price was ranging before the fake breakout.
• Display price zone boundary lines: Draws 2 horizontal lines extending to the right (dotted lines) at price levels X and A, helping you easily track important support/resistance levels.
• Display signal symbols: When Spring is detected, displays an upward triangle arrow in green. When Upthrust is detected, displays a downward triangle arrow in red.
• Alert: Sends notifications when Spring or Upthrust is detected, helping you not miss trading opportunities even when not watching the chart.

1.3 How to Use the Indicator

• Trading Spring (Bull): When a Spring signal appears (green upward arrow), this indicates price may rise strongly. You can consider entering a BUY (Long) position when price confirms return to the price zone or breaks above level A. Set Stop Loss below point B (the lowest point of the fake "sweep"). Take Profit can be placed at next resistance levels or according to appropriate Risk:Reward ratio.
• Trading Upthrust (Bear): When an Upthrust signal appears (red downward arrow), this indicates price may drop strongly. You can consider entering a SELL (Short) position when price confirms return to the price zone or breaks below level A. Set Stop Loss above point B (the highest point of the fake "sweep"). Take Profit can be placed at next support levels.
• Combine with other indicators: To increase accuracy, combine Spring & Upthrust with other indicators like Volume, RSI, or Japanese candlestick patterns to confirm the trend.
• Pay attention to "sweep" size: The indicator has filters to eliminate sweeps that are too small (noise) or too large (may be real trend). You can adjust Min Sweep and Max Sweep to suit different assets and timeframes.
• Watch for retest: After a signal appears, price often returns to "test" the price zone boundary (X or A) from inside. This is a safer entry point.

1.4 How the Indicator Works

Inputs & Roles

• ZigZag Length: This is an integer (default 12), determining the sensitivity of detecting "peak" and "valley" points on the chart.
  • Role: This value controls the minimum distance (number of candles) for a point to be considered a peak or valley. For example: if ZigZag Length = 12, a candle is only considered a peak when it's the highest point within 12 surrounding candles.
  • If increased (e.g., 20): Indicator will be "smoother", detect fewer signals, only catch major peaks/valleys → suitable for long timeframes or low volatility assets.
  • If decreased (e.g., 5): Indicator will be more "sensitive", detect more signals, catch even minor peaks/valleys → may have more noise.
• Show Patterns: This is a dropdown selection with 3 options: "All", "Spring (Bull)" (only bullish traps), "Upthrust (Bear)" (only bearish traps).
  • Role: Filters the type of signal you want to see. If you select "Spring (Bull)", the indicator will only display bullish signals, ignoring bearish signals.
• Min Sweep: This is a decimal number from 0.0 to 1.0 (default 0.05), representing the minimum percentage that price must "exceed" the price zone boundary to be considered a valid "sweep".
  • Role: Filters out sweeps that are too small (noise). For example: if the price zone is 100 points high (from X to A), and Min Sweep = 0.05, price must exceed the boundary by at least 5 points (100 × 0.05) to be considered a sweep.
  • If increased (e.g., 0.10): Only accepts larger sweeps → fewer signals but higher quality.
  • If decreased (e.g., 0.02): Accepts even small sweeps → more signals but may have noise.
• Max Sweep: This is a decimal number from 0.01 to 1.5 (default 0.35), representing the maximum percentage that price can "exceed" the price zone boundary.
  • Role: Filters out sweeps that are too large (may be real trend, not trap). For example: if the price zone is 100 points high, and Max Sweep = 0.35, price can only exceed the boundary by maximum 35 points. If exceeded, the indicator won't consider it a trap.
  • If increased (e.g., 0.50): Accepts deeper sweeps → more signals but may catch real trends too.
  • If decreased (e.g., 0.20): Only accepts shallow sweeps → fewer signals but more accurate.
• Confirm Pad: This is a decimal number from 0.0 to 0.5 (default 0.00), representing additional distance that price must exceed the opposite boundary (point A) to confirm the signal.
  • Role: Increases signal certainty. For example: if the price zone is 100 points high, and Confirm Pad = 0.10, after the sweep, price must reverse and exceed the opposite boundary by an additional 10 points (100 × 0.10) to be considered a valid signal.
  • If increased (e.g., 0.20): Requires stronger confirmation → fewer signals but higher quality, avoids false signals.
  • If decreased (e.g., 0.00): No additional confirmation required → more signals but may have false signals.
• Bull Fill / Bear Fill: These are color selections to fill the price zone box. Light green for Spring, light red for Upthrust.
• Bull Lines / Bear Lines: These are color selections for the X-A-B-C connecting lines. Green for Spring, red for Upthrust.
• Leg Style: This is a dropdown selection with 3 options: "Solid", "Dashed", "Dotted".
• Leg Width: This is an integer from 1 to 4 (default 2), determining the thickness of the X-A-B-C connecting lines.
• Level Width: This is an integer from 1 to 4 (default 2), determining the thickness of the 2 extending horizontal lines (at X and A).
• Extend Levels (bars): This is an integer from 1 to 500 (default 120), determining the number of candles that the 2 horizontal lines will extend to the right.

Main Logic Blocks

🎯 Final Output: Spring or Upthrust Signal

• When the indicator detects a complete trap pattern, it will:
  • Draw 3 straight lines connecting 4 points X → A → B → C (green for Spring, red for Upthrust)
  • Draw price zone box between X and A
  • Draw 2 extending horizontal lines at levels X and A
  • Display triangle arrow (up for Spring, down for Upthrust)
  • Send alert if you've enabled it

🔍 How to Detect X-A-B-C Pattern

• The indicator needs at least 4 pivot points (peaks/valleys) to form the pattern. These points are named in chronological order:
  • X: Oldest pivot point (4th from current)
  • A: 3rd pivot point from current
  • B: 2nd pivot point from current (the "sweep" point - fake breakout)
  • C: Newest pivot point (the "rejection" point - reversal)
• Conditions to detect Spring (Bullish Trap):
  • Point A must be higher than point X (forming price zone with A on top, X on bottom)
  • Point B must be lower than point X (breaks below bottom of price zone)
  • Point C must be higher than point A (+ confirm pad if any) (strong reversal upward)
  • Sweep size (|B - X| / |A - X|) must be within [Min Sweep, Max Sweep]

  Specific example: Assume X = 100, A = 120 (price zone 20 points high). Price drops to B = 98 (breaks below X by 2 points). Then price bounces to C = 122 (exceeds A by 2 points). Sweep size = |98 - 100| / |120 - 100| = 2/20 = 0.10 (10%). If Min Sweep = 0.05 and Max Sweep = 0.35, this is a valid Spring.

• Conditions to detect Upthrust (Bearish Trap):
  • Point A must be lower than point X (forming price zone with X on top, A on bottom)
  • Point B must be higher than point X (breaks above top of price zone)
  • Point C must be lower than point A (- confirm pad if any) (strong reversal downward)
  • Sweep size (|B - X| / |A - X|) must be within [Min Sweep, Max Sweep]

  Specific example: Assume X = 120, A = 100 (price zone 20 points high). Price rises to B = 122 (breaks above X by 2 points). Then price drops to C = 98 (exceeds A downward by 2 points). Sweep size = |122 - 120| / |120 - 100| = 2/20 = 0.10 (10%). If Min Sweep = 0.05 and Max Sweep = 0.35, this is a valid Upthrust.

📍 How to Find Pivot Points (peaks/valleys)

• The indicator uses the ZigZag method to find pivot points. This simplifies the price chart into straight line segments connecting important peaks and valleys.
• How ZigZag works:
  • The indicator scans through each candle on the chart
  • A candle is considered a peak (pivot high) if it's the highest point within ZigZag Length surrounding candles. For example: if ZigZag Length = 12, the current candle must be higher than 12 candles to the left and 12 candles to the right.
  • A candle is considered a valley (pivot low) if it's the lowest point within ZigZag Length surrounding candles.
  • The indicator stores a maximum of 6 most recent pivot points in an "array", with the newest point at the beginning of the list.
• Special handling: If 2 peaks (or 2 valleys) appear consecutively without a valley (or peak) in between, the indicator will only keep the higher (or lower) point and ignore the other. This helps avoid noise and keeps the ZigZag structure always alternating peak-valley.
• Pivot direction: Each pivot is assigned a "direction":
  • +1: Normal peak
  • -1: Normal valley
  • +2: Peak higher than previous peak (Higher High)
  • -2: Valley lower than previous valley (Lower Low)
  This information helps the indicator recognize trends, but is not directly used in Spring/Upthrust detection logic.

🎨 How to Draw Geometry and Boundary Lines

• When a new pattern is detected, the indicator will:
  • Draw 3 straight lines: X → A, A → B, B → C (using colors and line styles according to settings)
  • Draw price zone box from point X to point A, extending to point B (or point X if B is closer)
  • Draw 2 horizontal lines: one at price level X, one at price level A, extending to the right by the number of candles set (Extend Levels)
• Overlap handling: If a new pattern appears before the boundary lines of the old pattern finish extending, the indicator will automatically shorten the old boundary lines to avoid overlapping, keeping the chart cleaner.

Outputs & Roles in Usage

• Spring signal (green upward arrow): This is a bullish signal. You can consider entering a BUY (Long) position when price confirms return to the price zone or breaks above level A.
• Upthrust signal (red downward arrow): This is a bearish signal. You can consider entering a SELL (Short) position when price confirms return to the price zone or breaks below level A.
• Price zone boundary lines (X and A): These are important support/resistance levels. You can use them to set Stop Loss or Take Profit.
• Price zone box: Helps you easily identify the price zone where price was ranging before the fake breakout.
• Alert: Helps you not miss trading opportunities even when not watching the chart.