Back to Home
GEOWAVE
User Guide
Documentation

User Guide

Master the most powerful geometric indicator for TradingView. This guide covers everything from basic setup to advanced pattern recognition techniques.

Getting Started

Welcome to GeoWave - the most advanced geometric pattern recognition system ever built for TradingView. This guide will walk you through installation, configuration, and practical usage of every feature.

Installation

  1. Open TradingView and navigate to your chart
  2. Click the Indicators button in the top toolbar
  3. Search for "GeoWave" in the indicator search
  4. Click to add it to your chart
Screenshot: Adding GeoWave to your TradingView chart

Adding GeoWave to your TradingView chart

XABCD Patterns

GeoWave automatically identifies and labels market swings using the XABCD nomenclature. The indicator tracks the last 5 alternating pivots and assigns them labels:

  • X - The origin point of the pattern
  • A - First swing completion
  • B - Retracement of XA
  • C - Extension beyond A
  • D - Potential reversal zone (PRZ) - updates in real-time
Screenshot: XABCD pattern labeled on a price chart

XABCD pattern labeled on a price chart

Adaptive Pattern Detection

GeoWave uses adaptive thresholds that automatically adjust to market conditions. This means the indicator responds intelligently to changing volatility:

Depth (Default: 12)

Number of bars required before and after a swing point for confirmation. Higher values = fewer, more significant swings.

Threshold Multiplier (Default: 2.0)

Sensitivity multiplier for detecting significant price movements. Higher values filter out noise.

Smoothing Window (Default: 14)

Period for volatility calculation. Standard 14-period works for most instruments.

Provisional D Point

The D point updates in real-time to track the most extreme price after C. When D is not yet confirmed, the C→D line displays as dashed. Once price reverses enough to confirm a new swing point, the pattern locks in.

Multi-Level Detection

This is one of GeoWave's most powerful features. Multi-Level Detection scans for larger market structures simultaneously with your base swings, allowing you to see multiple timeframe perspectives at once.

WARNING
To see higher timeframe swings, you must enable Multi-Level Detection.

How It Works

Each level detects progressively larger swing patterns:

LevelDetection ThresholdSwing Size
BaseStandardStandard swings
+1Level 1Larger swings
+2Level 2Even larger
.........
+15Level 15Major market structure
+18Level 18Highest timeframe structure

The Multi-Level Grid

When ratios from higher levels approach Fibonacci values (within your threshold %), they appear in the Multi-Level Grid on the left side of your chart. Each detection shows:

  • Level: Which detection level (+1, +2, etc.)
  • Ratio: The ratio type (BcD, AB/CD, X1, XcD)
  • Value: The actual ratio value
  • Fib: The nearest Fibonacci level
PRO TIP
Confluence Strategy: When both your base swing AND a higher-level swing show ratios at the same D pivot, you have multi-timeframe confluence - enhancing the probability of the setup.

Projecting from Higher Levels

You can project targets and time cycles from any detection level, not just the base. Use the Target Source and Time Cycle Source dropdowns to select which level's XABCD structure to project from.

Target Source: Base | +1 | +2 | +3 | ... | +18
Time Cycle Source: Base | +1 | +2 | +3 | ... | +18

Ratio Analysis

GeoWave calculates and displays 6 key ratio relationships between the identified swings. These ratios are displayed in a real-time table on your chart:

RatioFormulaDescription
BcDCD ÷ BCC-D swing divided by B-C swing
AB/CDCD ÷ ABC-D swing divided by A-B swing
X1AD ÷ BCA-D swing divided by B-C swing
X2AD ÷ XCA-D swing divided by X-C swing
XcDCD ÷ XCC-D swing divided by X-C swing
XaDAD ÷ XAA-D swing divided by X-A swing
Screenshot: Real-time ratio table displayed on chart

Real-time ratio table displayed on chart

Target Levels

GeoWave projects multiple target levels based on different swing calculations. There are 6 independent target groups, each with its own color and configurable ratios. Targets project from point D and extend 50 bars to the right.

Target Source

By default, targets project from the Base level's XABCD pattern. Use the Target Source dropdown to project from higher detection levels (+1 through +15) for larger-scale targets.

Target Source: Base | +1 | +2 | +3 | ... | +18

The 6 Target Groups

TargetCalculationDefault Color
BcDFrom C using BC swing lengthBlue
XcDFrom C using XC swing lengthAqua
AB/CDFrom C using AB swing lengthWhite
X1From A using BC swing lengthRed
X2From A using XC swing lengthPurple
XaDFrom A using XA swing lengthOrange

Available Target Ratios

Each target group can project the following Fibonacci ratios (all off by default):

Available Ratios: 23.6% | 33.3% | 38.2% | 50% | 61.8% | 66.7% | 78.6% | 88.6% | 100% | 127.2% | 141.4% | 150% | 161.8% | 200%
PRO TIP
Enable only the ratios you use. Too many targets create visual clutter. Start with 61.8%, 100%, and 161.8% for most setups.

Target Display

Targets appear as dotted horizontal lines extending 50 bars from point D. Each line is labeled with the target type and exact price level.

Screenshot: Multiple target levels projected on chart

Multiple target levels projected on chart

NOTE
Targets are calculated based on bullish/bearish pattern direction. In a bullish pattern (D is a low), targets project upward. In a bearish pattern (D is a high), targets project downward.

Time Projections

GeoWave doesn't just analyze price - it projects time, using historical swings as a reference to project forward time cycles. By combining harmonic price ratios and time cycles, the strength of the signal increases.

Available Time Cycles

Each time cycle projects from a specific pivot pair forward. Enable the cycles you want to track:

CycleProjects FromRatios
BDD pivot forward33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200%
XDD pivot forward33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200%
ACC pivot forward33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200%
XAA pivot forward33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200%
XBB pivot forward33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200%
XCC pivot forward33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200%
ABB pivot forward33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200%

Time Cycle Display

Vertical lines indicate projected time zones. When price reaches a key level at a projected time, the probability of a reversal increases substantially..

PRO TIP
Multi-Level Time Cycles: Set the Time Cycle Source to a higher detection level to project time cycles from larger market structures. Combining base-level targets with higher-level time cycles creates powerful price-time confluence.

Square the Range

Based on W.D. Gann's principles, Square the Range creates geometric projections that identify intersections of price and time vectors. The technique "squares" a price range into a time box, then projects diagonal trend lines that often act as dynamic support/resistance.

Configuration

SettingDefaultDescription
Enable Square the RangeOffMaster toggle for this feature
Source LevelBaseWhich detection level's swing points to use
Pivot SelectionX-AWhich pivot pair defines the box
Show Fib LevelsOffDraw horizontal lines at 33.3%, 38.2%, 50%, 61.8%, 66.6%, 78.6% through the box
Show 2x Gradient✓ OnSteeper 2:1 angle lines
Show 1/2x GradientOffShallower 1:2 angle lines
Extend Lines Outside BoxOffProject lines into the future
Extension Length50 barsHow far to extend (10-500)

Pivot Selection Options

  • X-A: Uses X and A pivots (first swing) - default
  • X-C: Uses X and C pivots (larger range)
  • A-B: Uses A and B pivots (retracement swing)
  • B-C: Uses B and C pivots (continuation swing)
  • C-D: Uses C and D pivots (final swing)
  • A-D: Uses A and D pivots (full pattern range)
Screenshot: Square the Range box with intersecting diagonals

Square the Range box with intersecting diagonals

Gradient Lines

1x Gradient (Always shown)

The main diagonal lines that complete their price swap over 100% of the time duration. These are the primary Gann angles - dashed style.

2x Gradient (Default: On)

Steeper diagonals that complete their price swap in 50% of the time. Faster-moving markets often respect these angles - dotted style.

1/2x Gradient (Default: Off)

Shallower diagonals that take 200% of the time to complete. Slower-moving markets often respect these angles - dotted style.

Tiling

Tiling creates a grid of adjacent boxes around your main squared range, extending the geometric structure in all directions.

SettingDefaultDescription
Tile Level 1Off5 adjacent boxes: Above, Above-Right, Right, Below-Right, Below
Level 1 Tile ColorTeal (60%)Color for first ring of tiles
Tile Level 2OffExtends tiling one more layer outward
Level 2 Tile ColorTeal (75%)Color for second ring of tiles
Tile 2x1 AnglesOffDraw 2x1 (double speed) gradients in tiles
Tile 1x2 AnglesOffDraw 1x2 (half speed) gradients in tiles
PRO TIP
Extension: Enable "Extend Lines Outside Box" to project the pattern into the future. The diagonals continue creating new intersection points that can act as future support/resistance.

Signal Scoring

GeoWave includes a sophisticated Signal Scoring System that quantifies the strength of detected patterns. Each D pivot receives a score based on how many ratios align with Fibonacci levels and how "powerful" those Fibonacci numbers are.

How Scoring Works

  1. For each pattern, GeoWave checks all 6 ratios (BcD, AB/CD, X1, X2, XcD, XaD)
  2. If a ratio is within the Fib Threshold % of a Fibonacci level, it scores
  3. The score reflects the statistical significance of detected patterns
  4. The score is also weighted by the Ratio Type Weight
  5. For multi-level patterns, higher detection levels get a Level Weight multiplier (up to +18)
  6. Multiple patterns at the same D point are aggregated with a confluence bonus
PRO TIP
Enable "Show D Pivot Scores" in Display settings to see the score labels on your chart. Scores are color-coded from red (low) to green (high).

Score Tooltips

Hover over any score label to see a detailed breakdown of exactly what contributed to that score:

── Base ──
BcD: 61.8% → 1×3 = 3
AB/CD: 100% → 1×2.5 = 2.5
Base: 5.5 × Lvl 1 = 5.5

── +5 ──
XcD: 78.6% → 1×1.5 = 1.5
X1: 141.4% → 1×1.5 = 1.5
Base: 3 × Lvl 1.67 = 5.01

── TOTAL ──
Sum: 10.51
Confluence (4 hits): ×1.3
Final: 13.66

The tooltip shows: ratio name, detected Fib%, weight × power = contribution, and final aggregation with confluence bonus.

Fibonacci Power Weights

Not all Fibonacci ratios are equally significant. The "power" weights determine how much each Fibonacci level contributes to the score:

Fib LevelDefault PowerSignificance
61.8%4.0Golden ratio - highest significance
161.8%4.0Golden extension - highest significance
100%5.0Equal legs - very significant
50%3.5Half retracement - significant
200%2.5Double extension - significant
38.2%2.0Primary retracement level
78.6%1.5Secondary retracement level
127.2%1.5Secondary extension level
141.4%1.5Secondary extension level
33.3%, 66.7%1.5Third-wave relationships
23.6%, 88.6%1.0Minor Fibonacci levels

Ratio Type Weights

Each ratio type (BcD, XcD, etc.) can have its own weight multiplier:

RatioFormulaDefault Weight
BcDCD / BC1.0
AB/CDCD / AB1.0
X1AD / BC1.0
X2AD / XC1.0
XcDCD / XC1.0
XaDAD / XA1.0
NOTE
Exclude 100% BcD/XcD: By default (On), 100% ratios for BcD and XcD are excluded from scoring. These often represent "double tops/bottoms" scenarios that are less meaningful for pattern completion but still good to make note of.

Confluence & Level Weights

Confluence Bonus (Default: 0.25 per hit)

When multiple ratio hits occur at the same D pivot, each additional hit adds a 10% bonus to the total score. More confluence = higher score.

Level Weights (Base: 1.0, Max +18: 3.0)

Higher detection levels get progressively higher weight multipliers. The weight is linearly interpolated - a +9 pattern gets ~1.5x, while +18 gets the full 3x multiplier.

Max Score References

Single Pattern: 15.0 (reference max for color gradient)
Multi Pattern: 80.0 (reference max when multiple patterns converge)

Retracement Filters

GeoWave automatically filters out non-retracement patterns for XcD and XaD ratios. If the X-C-D or X-A-D price movements are monotonic (continuously up or down without retracing), those ratios are excluded from both display and scoring.

Reading Score Labels

When "Show D Pivot Scores" is enabled, you'll see labels at each D pivot with color-coded scores:

  • Red scores (0-5): Weak pattern - few ratio alignments, low confluence
  • Orange/Yellow scores (5-10): Moderate pattern - some Fibonacci alignments
  • Green scores (10-15): Strong pattern - multiple ratio confluences, high significance
  • Score with "(2x)", "(3x)", etc.: Multiple patterns detected at same D pivot (confluence bonus applied)
PRO TIP
Score Ranges: Colors are calculated relative to reference maximums of 15.0 (single pattern) and 80.0 (multi-pattern). Higher scores indicate stronger harmonic alignments and better trading opportunities.

Configuration

Access the settings panel by clicking the gear icon next to the indicator name. Here's a breakdown of all configuration options organized by group:

📐 Swingset Detection

SettingDefaultDescription
Depth12Bars before/after for swing point confirmation
Threshold Multiplier2.0Sensitivity multiplier for detecting significant movements
Smoothing Window14Period for volatility calculation

🔧 Fine Tuning (Offsets)

Skip N most recent swing points to analyze historical patterns:

SettingDefaultRange
Offset X, A, B, C, D00-10 each

📊 Multi-Level Settings

SettingDefaultDescription
Enable Multi-Level DetectionOffMaster switch for higher-level detection
Enable ALL Levels (+1 to +18)OffEnable all 18 multi-level detections at once
+1 through +18OffIndividual toggles for each level (18 total)
Fib Threshold %3%Only show swings within this % of Fib

🎯 Target Levels

SettingDefaultDescription
Enable Target LevelsOffMaster switch for all target projections
Target TypeBcDBcD, AB/CD, X1, X2, XcD, XaD
Target Source LevelBaseWhich detection level for target calculation
Individual Fib TargetsVariousToggle each: 23.6, 33.3, 38.2, 50, etc.
Target Offset Bars50How far targets extend right (0-500)

⏱️ Time Cycles

SettingDefaultDescription
Enable Time CyclesOffMaster switch for time projections
Time Cycle TypeBD 100%XA, AB, BC, CD, BD, XD, AD
Time Cycle SourceBaseWhich detection level for time calculation
Time Fib Ratios100%Toggle: 33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200%

🔲 Square the Range

See the Square the Range section for full details. Key defaults:

  • Enable: Off
  • Source Level: Base
  • Pivot Selection: X-A
  • Show Fib Levels: Off
  • Show 2x Gradient: On
  • Show 1/2x Gradient: Off
  • Extension Length: 50 bars

⭐ Signal Scoring

See the Signal Scoring section for full details. Key defaults:

SettingDefaultDescription
Show D Pivot ScoresOffDisplay score labels on chart
Fib Threshold %3%How close ratio must be to Fib
Confluence Bonus0.1Bonus per additional ratio hit
Level Weights1.0 - 3.0Base (1.0) to +18 (3.0)
Exclude 100% BcD/XcD✓ OnIgnore "no retracement" scenarios

👁️ Display Settings

SettingDefaultDescription
Pivot Price Value Markers✓ OnShow price labels on pivots
Show XABCD Lines✓ OnMain pattern structure lines
Show D Pivot ScoresOffDisplay signal score at each D pivot on the chart
Show Latest D Pivot OnlyOffOnly show swing sets where D is at the most recent D pivot bar across all levels
Fib Highlight Threshold3%How close to highlight green

🎨 Colors & Styling

ElementDefault ColorNotes
Base Pattern LinesCyanMain XABCD swing lines
Multi-Level LinesPurpleHigher detection level patterns
Target LinesGoldFibonacci target levels
Time Cycle LinesTealVertical time projections
Square Range LinesBlueGann box diagonals
Fib HighlightGreenRatios within threshold
PRO TIP
Pro Tip: All colors are fully customizable. Use contrasting colors for base vs multi-level patterns to quickly distinguish between timeframe structures.
Screenshot: Configuration panel overview

Configuration panel overview

Ready to start trading with geometric precision?

Get GeoWave