> For the complete documentation index, see [llms.txt](https://chartnation.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chartnation.gitbook.io/documentation/indicators/pattern-confluence-pro.md).
# Pattern Confluence Pro
## Pattern Confluence Pro — Documentation
#### Table of Contents
1. [Overview](#overview)
2. [The Two Tiers](https://chartnation.gitbook.io/documentation/indicators/pattern-confluence-pro#the-two-tiers)
3. [The 4 Patterns](#the-4-patterns)
* [Rising Wedge](#rising-wedge)
* [Falling Wedge](#falling-wedge)
* [Ascending Channel](#ascending-channel)
* [Descending Channel](#descending-channel)
4. [Reading the Signals](#reading-the-signals)
* [Pattern Labels](#pattern-labels)
* [Confluence Score](#confluence-score)
* [Break Markers](#break-markers)
* [Targets: T1 and T2](#targets-t1-and-t2)
* [Failed Breaks](#failed-breaks)
5. [Settings Reference](#settings-reference)
* [Swing Tier Settings](#swing-tier-settings)
* [Macro Tier Settings](#macro-tier-settings)
* [Display Settings](#display-settings)
* [Recommended Settings by Timeframe](#recommended-settings-by-timeframe)
6. [Alerts Setup](#alerts-setup)
7. [How to Get Access](#how-to-get-access)
***
### Overview
Pattern Confluence Pro detects institutional-grade chart patterns in real time — rising wedges, falling wedges, ascending channels, and descending channels — across two independent tiers: **Swing** and **Macro**.
Most pattern indicators draw lines. This one tells you whether the pattern is forming, broken, failed, or hitting targets. Every pattern is scored for quality. Every break is measured for volume. No manual drawing. No second-guessing.
**What it does:**
* Detects 4 pattern types across two structural tiers simultaneously
* Scores every pattern with a confluence quality rating
* Flags confirmed breaks with volume data the moment they happen
* Identifies failed breaks — price reclaims after a break, invalidating the move
* Draws dual targets (T1 and T2) from the break bar, turning green with a ✓ when hit
* Fires 7 configurable alert conditions across both tiers
***
### The Two Tiers
| | Swing Tier | Macro Tier |
| ---------------------- | --------------------------------- | ------------------------------------ |
| **Purpose** | Intraday and short-term structure | Higher timeframe, dominant structure |
| **Pattern length** | 30–150 bars | 150–500 bars |
| **Label prefix** | None | `[M]` |
| **Line style** | Solid | Dashed |
| **Line width** | 2px | 3px |
| **Min quality score** | 110 | 150 |
| **Max patterns shown** | 5 | 3 |
Both tiers run simultaneously on the same chart. A Swing break inside an active Macro pattern is a high-conviction confluence setup — two timeframe structures confirming the same direction at the same time.
***
### The 4 Patterns
The algorithm anchors trendlines to swing extremes using an **extremes-based fitting method** — support lines anchor to the lowest swing lows, resistance lines anchor to the highest swing highs. This mirrors how a professional trader draws lines by hand. The result is trendlines that respect every touch rather than averaging through them.
#### Rising Wedge
**Bias: Bearish | Color: Red**
Both trendlines slope upward. The support line rises faster than the resistance line, compressing price into a narrowing range at higher prices. This squeeze signals exhaustion. When support breaks, the move is typically sharp.
**Detection rules:**
* Both support and resistance slope upward
* Resistance slope is less steep than support slope
* Lines converge between 30–70% over the pattern's duration
* Minimum 3 touches on each trendline
**Break direction:** Downward through support
***
#### Falling Wedge
**Bias: Bullish | Color: Green**
Both trendlines slope downward. The resistance line falls faster than support, narrowing the range — sellers are losing momentum with each push lower. When resistance breaks, buyers take control.
**Detection rules:**
* Both support and resistance slope downward
* Support slope is less steep than resistance slope
* Lines converge between 30–70% over the pattern's duration
* Minimum 3 touches on each trendline
**Break direction:** Upward through resistance
***
#### Ascending Channel
**Bias: Bearish | Color: Blue**
Both trendlines slope upward at roughly the same angle — parallel lines. Price oscillates within a rising range. This controlled ascent often precedes a breakdown. Institutions distribute into the move as retail chases the uptrend. A midline is drawn at the 50% level between support and resistance.
> **Why bearish?** Price rising in a channel is controlled distribution. When it breaks down, the real direction reveals itself.
**Detection rules:**
* Both support and resistance slope upward
* Slope difference between lines is ≤ 15% (roughly parallel)
* Lines do not significantly converge
* Minimum 3 touches on each trendline
**Break direction:** Downward through support
***
#### Descending Channel
**Bias: Bullish | Color: Orange**
Both trendlines slope downward in parallel. Price is declining in a structured, controlled way — this is how institutions accumulate. Each push lower finds buyers. When resistance breaks upward, those accumulated positions drive the move. A midline is drawn at the 50% level between support and resistance.
**Detection rules:**
* Both support and resistance slope downward
* Slope difference between lines is ≤ 15% (roughly parallel)
* Lines do not significantly converge
* Minimum 3 touches on each trendline
**Break direction:** Upward through resistance
***
### Reading the Signals
#### Pattern Labels
Each pattern displays a label at its midpoint:
```
Rising Wedge ✓
4/3 | 187
```
| Element | Meaning |
| ------------ | ------------------------------------------- |
| Pattern name | Type of pattern detected |
| ✓ | Confirmed break |
| ✗ | Break occurred but failed — price reclaimed |
| 4/3 | Support touches / Resistance touches |
| 187 | Confluence score |
Macro patterns show an `[M]` prefix: `[M] Ascending Channel ✓`
***
#### Confluence Score
A single number representing the structural quality of the pattern. Higher = cleaner and more reliable.
**Formula:**
```
Score = (Support Touches + Resistance Touches) × 15
+ (Support Fit + Resistance Fit) × 2
+ Duration × 0.3 (capped)
+ Convergence / Parallelism Bonus × 30
```
| Score | Quality |
| ------- | ------------------------------------ |
| 110–150 | Minimum qualifying — valid but basic |
| 150–250 | Solid structure — worth watching |
| 250–400 | High quality — strong confluence |
| 400+ | Institutional-grade structure |
Patterns below the minimum threshold are filtered out entirely and never displayed. Swing minimum is 110. Macro minimum is 150.
***
#### Break Markers
A label appears at the end of the pattern lines when a break is detected:
| Label | Meaning |
| --------------- | --------------------------------- |
| `▼ BREAK` | Bearish confirmed break (Swing) |
| `▲ BREAK` | Bullish confirmed break (Swing) |
| `▼ MACRO BREAK` | Bearish confirmed break (Macro) |
| `▲ MACRO BREAK` | Bullish confirmed break (Macro) |
| `⚠ FAILED` | Break reversed — structure intact |
**Volume on breaks:**
| Display | Meaning |
| ------------------- | -------------------------------------------------------- |
| `🔥 ▲ BREAK (3.2x)` | Institutional break — volume 2.5x+ above pattern average |
| `▲ BREAK (1.4x)` | Normal break — above average volume |
| `▲ BREAK (0.7x ⚠)` | Weak break — below average volume, treat with caution |
A 🔥 break at 2.5x+ volume is the strongest signal the indicator produces. Abnormal participation on a break doesn't lie.
***
#### Targets: T1 and T2
After a confirmed break, two targets are drawn anchored to the close at the break bar:
* **T1** — 50% of the full pattern height projected in break direction
* **T2** — 100% of the full pattern height projected in break direction
| Label | Color | Meaning |
| --------------- | ------------- | --------------------------- |
| `T1` | Pattern color | Not yet reached |
| `T1 ✓` | Lime green | Price has hit T1 |
| `T2 ✓` | Lime green | Price has hit T2 |
| `T1 ✗` / `T2 ✗` | Gray | Invalidated by failed break |
T1 is the conservative target — partial profit, tighten stop. T2 is the full measured move.
***
#### Failed Breaks
A failed break occurs when price closes back inside the pattern after confirming a break. This traps traders who entered on the break and often signals a strong reversal in the opposite direction.
**On a failed break:**
* Pattern label shows `✗`
* Break marker changes to `⚠ FAILED` (orange)
* Targets turn gray with `✗` labels
* All alerts are suppressed
Failed breaks on Macro patterns are especially significant — the larger structure has rejected the move and the dominant trend is likely resuming.
***
### Settings Reference
#### Swing Tier Settings
| Setting | Default | Description |
| -------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Swing Length** | 5 | Bars used to identify swing pivots. Lower = more sensitive. Higher = only major pivots. Increase on higher timeframes. |
| **Min Pattern Bars** | 30 | Minimum pattern length to qualify. Prevents noise from registering as patterns. |
| **Max Pattern Bars** | 150 | Maximum Swing pattern length. Longer patterns go to the Macro tier. |
| **Min Touches** | 3 | Minimum trendline confirmations required per side. Raising to 4 produces fewer but stronger setups. |
| **Wick Tolerance** | 0.009 | How close a swing must be to the trendline to count as a touch (0.9% of price). Increase on volatile instruments. |
| **Min Convergence** | 0.30 | Minimum width reduction for wedge classification (30%). |
| **Max Convergence** | 0.70 | Maximum convergence before the pattern is too tight to trade (70%). |
| **Max Channel Divergence** | 0.15 | Maximum slope difference between lines for channel classification. Lower = stricter parallelism. |
| **Break Threshold** | 0.005 | How far price must close beyond the trendline to confirm a break (0.5%). Prevents wick false triggers. |
| **Max Patterns** | 5 | Maximum Swing patterns displayed. Ranked by score — only the top N shown. |
| **Min Quality Score** | 110 | Minimum score to display. Raise to show only the cleanest setups. |
***
#### Macro Tier Settings
| Setting | Default | Description |
| ---------------------- | ------- | -------------------------------------------------------------------------------------- |
| **Min Macro Bars** | 150 | Minimum pattern length for Macro tier. |
| **Max Macro Bars** | 500 | Maximum Macro pattern length. |
| **Max Macro Patterns** | 3 | Maximum Macro patterns displayed simultaneously. |
| **Macro Min Score** | 150 | Minimum score for Macro patterns. |
| **Macro Min Height %** | 0.003 | Minimum pattern height as % of price. Filters micro-range noise on certain data feeds. |
> The Macro swing length is fixed at 20 bars. This ensures macro detection always uses significant structural pivots regardless of the Swing Length setting.
***
#### Display Settings
| Setting | Default | Description |
| --------------------------- | ------- | ------------------------------------------------------ |
| **Show Swing Tier** | On | Toggle Swing tier entirely. |
| **Show Macro Tier** | On | Toggle Macro tier entirely. |
| **Show Fill** | On | Fill between trendlines. Disable for cleaner charts. |
| **Show Target** | On | Show T1 and T2 after breaks. |
| **Show Active Only** | Off | Show only unbroken patterns. Useful for setup hunting. |
| **Show Rising Wedge** | On | Toggle Rising Wedge detection. |
| **Show Falling Wedge** | On | Toggle Falling Wedge detection. |
| **Show Ascending Channel** | On | Toggle Ascending Channel detection. |
| **Show Descending Channel** | On | Toggle Descending Channel detection. |
***
#### Recommended Settings by Timeframe
| Timeframe | Swing Length | Min Bars | Max Bars | Wick Tolerance |
| --------- | ------------ | -------- | -------- | -------------- |
| 1 min | 5 | 30 | 150 | 0.009 |
| 5 min | 5 | 25 | 120 | 0.007 |
| 15 min | 8 | 20 | 100 | 0.006 |
| 1 hour | 10 | 15 | 80 | 0.005 |
| 4 hour | 13 | 12 | 60 | 0.004 |
If too many patterns appear: raise Min Touches to 4 or raise Min Quality Score. If too few patterns appear: lower Wick Tolerance slightly or reduce Min Touches back to 3.
***
### Alerts Setup
Pattern Confluence Pro includes 7 alert conditions. Alerts only fire on confirmed breaks — failed breaks are suppressed.
#### Available Alert Conditions
| Alert | Fires When |
| ------------------------------- | ---------------------------------------------------------- |
| **PCP – Bearish Break (Swing)** | Rising Wedge or Ascending Channel breaks down — Swing tier |
| **PCP – Bullish Break (Swing)** | Falling Wedge or Descending Channel breaks up — Swing tier |
| **PCP – Bearish Break (Macro)** | Rising Wedge or Ascending Channel breaks down — Macro tier |
| **PCP – Bullish Break (Macro)** | Falling Wedge or Descending Channel breaks up — Macro tier |
| **PCP – Any Bearish Break** | Any bearish break on either tier |
| **PCP – Any Bullish Break** | Any bullish break on either tier |
| **PCP – Any Pattern Break** | Any break in any direction on either tier |
#### How to Set Up
1. Open the chart with Pattern Confluence Pro applied
2. Right-click the indicator name → **Add Alert on Pattern Confluence Pro**
3. In the **Condition** dropdown, select your alert
4. Set notification method (popup, email, webhook)
5. Click **Create**
One alert per condition. If you want separate bearish and bullish notifications, create two alerts.
#### Alert Message Format
```
ChartNation | Pattern Confluence Pro
BEARISH BREAK detected on BTCUSDT 1
Rising Wedge or Ascending Channel broke down.
Bias: SHORT | Check target below.
```
Ticker and interval are dynamically inserted — one alert setup works across any chart the indicator is applied to.
#### Recommended Alert Strategy
**Active traders:** Use `PCP – Any Pattern Break` as a single catch-all. When it fires, open the chart — the visual context tells you everything.
**Directional traders:** Set separate bearish and bullish alerts. Filter by tier based on your style — Macro breaks carry more structural weight.
**Macro-only traders:** Use only `PCP – Bearish Break (Macro)` and `PCP – Bullish Break (Macro)`. These represent institutional-level structure changing hands — the highest-conviction signals the indicator produces.
***
### How to Get Access
Pattern Confluence Pro is available on the **Pro** ($35/month) and **Ultimate** ($59/month) plans at [chartnation.net](https://chartnation.net/).
**After subscribing via Whop:**
1. Go to your Whop dashboard
2. Click the **TradingView** tab
3. Enter your TradingView username
4. Refresh TradingView
5. Find the indicator under **Invite-Only Scripts** in the Indicators panel
> The indicator does **not** arrive via email invitation. It appears directly in your TradingView invite-only scripts.
***
*Documentation for Pattern Confluence Pro by ChartNation. For support, join the* [*Discord community*](https://discord.gg/qNCSAMZuFk)*.*
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://chartnation.gitbook.io/documentation/indicators/pattern-confluence-pro.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.