> 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/volume-dynamics-pro.md).

# Volume Dynamics Pro

{% embed url="<https://youtu.be/7SyepdAk46I>" %}

### Overview

Volume Dynamics Pro is an institutional-grade volume profile indicator that visualizes volume distribution across price levels using a proprietary mirrored butterfly design. The indicator reveals where significant trading activity has occurred, identifies the Point of Control (POC) - the price level with maximum volume - and provides forward-looking market structure analysis through dynamic profile projections.

***

<figure><img src="/files/D5zTfhTTn7W6Mc0sRByV" alt="volume dynamics pro by chartnation"><figcaption></figcaption></figure>

### Core Concept

Traditional volume bars show you *when* volume occurred. Volume Dynamics Pro shows you *where* volume occurred - at which specific price levels traders committed capital. This distinction is critical because price tends to gravitate toward high-volume nodes (areas of acceptance) and react at the POC (the market's center of gravity).

The indicator divides your selected price range into 25 horizontal bins, calculates total volume traded at each level, then displays this distribution as a mirrored butterfly profile that extends ahead of current price action - giving you a clear, unobstructed view of market structure.

***

### Key Features

#### 1. **Mirrored Butterfly Profile**

The signature visualization that sets Volume Dynamics Pro apart.

**What it does:**

* Creates a symmetrical, mountain-shaped volume distribution
* Extends from a center axis positioned ahead of current candles
* Wider sections = higher volume at that price level
* Displays actual volume numbers and percentage of total volume in each bin

**Why it matters:**

* Zero candle overlap - your price action remains clean and readable
* Instant visual identification of high-volume nodes
* Professional presentation that matches institutional trading desk aesthetics

**Customization:**

* Profile Width: Control how wide the butterfly extends (default: 50 bars)
* Profile Offset: Position the profile's starting point ahead of price (default: 10 bars)
* Toggle on/off while preserving all other features

***

<figure><img src="/files/ptSr5BA5iSosmmLLYViw" alt="poc point of control volume dynamics pro chartnation"><figcaption></figcaption></figure>

#### 2. **Point of Control (POC)**

The price level with the highest traded volume - the market's most significant battleground.

**What it is:**

* Automatically identified as the bin with maximum volume
* Marked with a distinct color (default: blue) that stands out from other traces
* Represents the "fair value" where most participants agreed to transact

**Why it matters:** The POC acts as a magnetic level:

* Price often returns to POC during consolidation
* Strong support when price is above POC
* Strong resistance when price is below POC
* POC breaks often signal major trend shifts

**Visual Features:**

* **Pulse Animation**: POC line rhythmically thickens/thins using sine wave oscillation - making it impossible to miss even on busy charts
* **Extension Line**: Projects POC forward into uncharted territory (customizable length, style, transparency)
* **Price Label**: Displays exact POC value with customizable positioning (left/right), size, colors, and optional background

***

#### 3. **Dynamic Volume Tracking**

25 horizontal lines that form the profile, each representing a price bin's volume.

**Visual Properties:**

**Volume-Based Styling:**

* **Line Style**: Automatically adapts based on volume percentage
  * High-volume zones (>70%): Dashed lines - immediately visible as key levels
  * Low-volume zones (<30%): Dotted lines - de-emphasized to reduce noise
  * Medium volume: Solid lines
  * Optional: Force all lines to single style (Solid/Dashed/Dotted)

**Volume-Proportional Thickness:**

* Line width scales with volume magnitude (default range: 1-4 pixels)
* POC receives additional width boost to dominate visually
* Instantly convey volume significance without reading numbers

**Enhanced Glow System:**

* Each trace has a thicker, semi-transparent "glow" layer behind it
* Glow intensity increases with volume (volume-responsive transparency)
* Creates depth and premium visual appeal
* High-volume zones glow brighter (configurable boost: 0-50%)

**Dual-Tone Depth Borders:**

* Darker border lines offset slightly below each trace
* Creates 3D separation effect between volume levels
* Border darkness and offset fully customizable

***

#### 4. **Gradient Bias System**

Context-aware color tinting that reveals whether price levels act as support or resistance.

**How it works:**

* Traces above current price → Red tint (resistance)
* Traces below current price → Green tint (support)
* Tint intensity increases as price approaches each level
* Combines proximity to price + volume magnitude for strength calculation

**Advanced Mode - Approach Direction:**

* Enable to tint based on momentum direction
* Rising momentum + resistance above → Red tint (anticipate rejection)
* Falling momentum + support below → Green tint (anticipate bounce)
* Uses dual moving average bias (Fast: 5, Slow: 21) for momentum detection

**Customization:**

* Proximity threshold (default: 10 bins)
* Tint intensity (0-100%)
* Support/Resistance colors
* Approach-only mode toggle

***

<figure><img src="/files/ySiqMtXiylzRXlT01Z16" alt="volume dynamics pro settings"><figcaption></figcaption></figure>

#### 5. **Profile Anchoring**

Control how the volume profile calculates its range - critical for different trading styles.

**Five Modes:**

**Rolling (Default)**

* Calculates profile from last X bars (lookback setting)
* Profile updates every bar as new data arrives
* Best for: Intraday trading, continuous structure analysis

**Daily**

* Resets profile at start of each trading day
* Shows distribution for current day only
* Best for: Day traders, session-based strategies

**Weekly**

* Resets profile at start of each week
* Captures weekly accumulation patterns
* Best for: Swing traders, weekly timeframe analysis

**Monthly**

* Resets profile at start of each month
* Reveals long-term institutional positioning
* Best for: Position traders, macro trend identification

**Session**

* Define custom session times (default: 0930-1600)
* Profile calculates only during specified hours
* Best for: Strategy-specific timeframes, avoiding pre/post-market noise

**Previous Period Profile:**

* Toggle to display previous period's profile in gray (85% transparent)
* Instantly compare today's structure vs. yesterday (or last week, month)
* Identify structural shifts in market acceptance

***

#### 6. **Smart Range Calculation**

Three intelligent methods for determining which price levels to include in the profile.

**Fixed Lookback**

* Classic approach: highest high and lowest low over lookback period
* Reliable and predictable
* Best for: Standard analysis, stable markets

**Hybrid Smart (Recommended)**

* Automatically trims outlier price levels that have minimal volume
* Focuses profile on meaningful price action
* Eliminates noise from wicks and gaps
* Trim threshold: Remove levels with less than X% of total volume (default: 2%)
* Best for: Volatile markets, data with frequent spikes

**Percentage-Based**

* Creates range as percentage deviation from current price
* Range automatically centers on current market price
* Range size: ±X% from current close (default: 5%)
* Best for: Multi-asset analysis, normalized comparisons

***

<figure><img src="/files/IyD6Pvzmd1zknnpRYM7v" alt=""><figcaption></figcaption></figure>

#### 7. **Premium Statistics Box**

Real-time dashboard displaying critical market metrics.

**Metrics Displayed:**

* **POC Price**: Exact price level of Point of Control
* **POC Volume**: Total volume traded at POC
* **Range High/Low**: Current profile's upper/lower boundaries (color-coded green/red)
* **Range Size**: Total price distance covered by profile
* **Total Volume**: Sum of all volume across all bins
* **Price vs POC**: Current price's percentage deviation from POC (positive = above, negative = below)
* **POC Volume %**: POC's volume as percentage of total volume
* **Anchor Mode**: Active profile anchoring mode
* **Lookback**: Number of bars in current calculation

**Customization:**

* Toggle on/off
* Background color and transparency
* Border color
* Text color and header accent color
* Text size (Tiny/Small/Normal/Large)

***

#### 8. **Comprehensive Alert System**

Four alert types to never miss critical market events.

**POC Cross Alert**

* Triggers when price crosses above or below Point of Control
* Message: "Price crossed ABOVE/BELOW POC at \[price]"
* Use for: Identifying trend shifts, structural breaks

**Range Break Alert**

* Triggers when price exits profile range (breaks high or low)
* Message: "Price BROKE ABOVE/BELOW profile range at \[price]"
* Use for: Breakout confirmation, range expansion detection

**High-Volume Zone Entry Alert**

* Triggers when price enters a bin with volume ≥ threshold percentage
* Threshold customizable (default: 70% of max volume)
* Message: "Price entered HIGH-VOLUME ZONE (>X%)"
* Use for: Support/resistance test warnings, reversal setups

**Volume Spike Alert**

* Triggers when bar volume exceeds average by multiplier
* Multiplier customizable (default: 2.0x average)
* Message: "VOLUME SPIKE: \[volume] (Xx average)"
* Use for: Institutional activity detection, breakout confirmation

***

### How to Use Volume Dynamics Pro

#### For Beginners

**Step 1: Understand the Visual**

* Wide butterfly sections = lots of trading happened here
* Thin butterfly sections = minimal trading activity
* The thickest, brightest line = Point of Control (POC)

**Step 2: Identify Key Levels**

* POC acts as magnet - price often returns to it
* High-volume nodes (wide sections) = strong support/resistance
* Low-volume areas (thin sections) = price moves through quickly

**Step 3: Watch for Reactions**

* Enable "High-Volume Zone Entry" alerts
* When price approaches high-volume node, watch for rejection or acceptance
* Acceptance = price consolidates, volume increases
* Rejection = price bounces away, often with long wicks

**Step 4: Use POC for Context**

* Price above POC + holding = bullish structure intact
* Price below POC + holding = bearish structure intact
* Choppy movement around POC = balance, no clear direction

#### For Advanced Traders

**Institutional Order Flow Analysis**

* Compare current profile to previous period profile
* Shifting POC = changing market acceptance, institutional repositioning
* Widening profile = increased participation, healthy trend
* Narrowing profile = declining participation, potential reversal

**Volume Profile + Price Action Confluence**

* Overlay with your existing support/resistance
* Strongest levels: Where S/R aligns with high-volume nodes
* Use gradient bias to anticipate support/resistance behavior
* Volume confirms your technical levels - demand meets structure

**Breakout Validation**

* Before taking breakout: Check volume at breakout level
* High-volume node breakout = significant resistance overcome, validate move
* Low-volume node breakout = minimal resistance, higher failure risk
* Enable "Range Break" + "Volume Spike" alerts for automated validation

**Intraday vs. Multi-Day Analysis**

* Intraday: Use "Session" or "Daily" anchor with 5-15m timeframe
* Swing: Use "Weekly" anchor with 1H-4H timeframe
* Position: Use "Monthly" anchor with Daily timeframe
* Profile width/offset may need adjustment per timeframe

**Market Profile Integration**

* Value Area approximation: Bins with >40% volume
* Point of Control = exact market acceptance level
* High Volume Node (HVN) = clustering around POC
* Low Volume Node (LVN) = gaps in profile (thin areas)

***

### Settings Guide

#### Basic Settings

**LookBack**

* Bars to include in profile calculation
* Default: 200
* Lower values: More responsive, recent structure
* Higher values: More stable, longer-term context

**Dynamic Volume Traces**

* Toggle the volume distribution lines on/off
* Color: Sets base trace color (default: pink)
* Opacity: Transparency of traces (0-100)
* Base Width: Minimum line thickness

**Max Volume Trace**

* Toggle POC highlighting on/off
* Color: POC line color (default: blue)

#### POC Extension Line

**Extend POC into Future**

* Projects POC forward as reference level
* Extension Length: How many bars ahead (10-200)
* Line Style: Solid/Dashed/Dotted
* Line Width: Thickness (1-5)
* Transparency: (0-80)

#### POC Price Label

**Show POC Price Label**

* Displays "POC: \[price]" text label
* Position: Left or Right of profile
* Size: Tiny/Small/Normal/Large
* Background: Toggle on/off
* Text Color: Label text color
* Background Color: Label background color
* Background Transparency: (0-90)

#### Profile Anchoring

**Anchor Mode**

* Rolling / Daily / Weekly / Monthly / Session
* Session Time: Define custom hours (for Session mode)
* Show Previous Period Profile: Overlay last period in gray
* Previous Profile Transparency: (70-95)

#### Dynamic Range Calculation

**Range Mode**

* Fixed Lookback: Standard high/low range
* Hybrid Smart: Auto-trim outliers
* Percentage-Based: ±X% from current price

**Base Lookback**: Bars for range calculation (50-500)\
**Trim Threshold %**: Volume threshold for Hybrid mode (0.5-10%)\
**Range % from Price**: Deviation for Percentage mode (1-20%)

#### Alert System

**Enable Alerts**: Master toggle for all alerts

**Alert on POC Cross**: Price crosses POC\
**Alert on Range Break**: Price exits profile boundaries\
**Alert on High-Volume Zone Entry**: Price enters high-vol bin

* High-Volume Zone Threshold %: Define "high-volume" (50-95%)

**Alert on Volume Spike**: Bar volume exceeds average

* Volume Spike Multiplier: Define "spike" threshold (1.5x-5.0x)

#### Trace Line Styles

**Style Mode**

* Solid: All traces solid
* Dashed: All traces dashed
* Dotted: All traces dotted
* Volume-Based: Auto-style by volume percentage

**High Volume %**: Threshold for dashed lines (50-100)\
**Low Volume %**: Threshold for dotted lines (0-50)

#### Volume-Proportional Thickness

**Enable Volume-Based Width**: Scale thickness by volume\
**Min Width**: Thinnest line for low volume (1-3)\
**Max Width**: Thickest line for high volume (2-8)\
**POC Width Boost**: Additional thickness for POC (0-4)

#### Gradient Bias

**Proximity (bins)**: How close price must be for tinting (1-12)\
**Tint Intensity %**: Maximum tint strength (0-100)\
**Use approach direction**: Enable momentum-based tinting\
**Bias Fast MA**: Fast moving average period (1+)\
**Bias Slow MA**: Slow moving average period (2+)\
**Support Tint**: Color below price (default: green)\
**Resistance Tint**: Color above price (default: red)

#### Enhanced Glow System

**Glow Lines**: Enable glow layer behind traces\
**Glow Width +**: Additional width for glow (1-12)\
**Glow Base Transparency**: Starting transparency (70-95)\
**Volume-Responsive Glow Intensity**: Increase glow for high-volume\
**High-Volume Glow Boost %**: Intensity increase (0-50)\
**Glow Boxes**: Draw glowing boxes around profile bars\
**Glow Box Transparency**: (0-100)\
**Glow Box Thickening**: Extra padding (0-0.5 × step)

#### Dual-Tone Depth Borders

**Enable Depth Borders**: Draw darker border lines\
**Border Width +**: Additional width for borders (1-4)\
**Border Darkness %**: Border transparency (20-70)\
**Border Offset**: Vertical offset from trace (0.05-0.3 × step)

#### POC Pulse Animation

**Enable POC Pulse**: Rhythmic POC thickness variation\
**Pulse Speed**: Oscillation rate (0.02-0.2)\
**Pulse Amplitude**: Width change amount (0-3 pixels)

#### Volume Profile Display

**Show Volume Profile**: Toggle butterfly profile on/off\
**Profile Width**: Horizontal span in bars (20-100)\
**Profile Start Offset**: Bars ahead of current price (5-30)

***

### Interpretation Guide

#### Reading Volume Distribution

**Balanced Profile (Bell Curve)**

* Volume concentrated around POC
* Thin tails at extremes
* Interpretation: Market is in equilibrium, price accepted
* Strategy: Mean reversion trades around POC

**Bimodal Profile (Double Peak)**

* Two distinct high-volume nodes with gap between
* POC may be in the gap (low volume)
* Interpretation: Market indecision, two competing value zones
* Strategy: Trade the range between nodes, breakout when one fails

**P-Shaped Profile (Top Heavy)**

* High volume at upper range, thin at bottom
* POC near range high
* Interpretation: Distribution phase, sellers dominating
* Strategy: Look for shorts on POC rejections, avoid longs

**b-Shaped Profile (Bottom Heavy)**

* High volume at lower range, thin at top
* POC near range low
* Interpretation: Accumulation phase, buyers dominating
* Strategy: Look for longs on POC bounces, avoid shorts

**Flat Profile (Horizontal)**

* Even volume distribution across range
* No dominant POC
* Interpretation: Trending market, acceptance at all levels (weak structure)
* Strategy: Trend-following, avoid range-bound strategies

#### POC Behavior Patterns

**POC as Magnet**

* Price drifts toward POC during consolidation
* Trade: Fade extremes toward POC (mean reversion)

**POC as Pivot**

* Price above POC = bullish, POC acts as support
* Price below POC = bearish, POC acts as resistance
* Trade: Use POC as stop-loss reference

**POC Migration**

* POC shifts up = bull market, rising acceptance
* POC shifts down = bear market, falling acceptance
* Trade: Follow POC direction for trend

**Failed POC Tests**

* Price approaches POC but rejects hard
* Interpretation: Strong directional bias, trend continuation
* Trade: Trade in direction of rejection

#### Volume Node Strategies

**High Volume Node (HVN) Bounce**

1. Price approaches HVN from above or below
2. Volume spike on approach (use volume spike alert)
3. Price rejects with strong candle (long wick)
4. Trade: Enter in direction of rejection, stop beyond HVN

**Low Volume Node (LVN) Breakout**

1. Price consolidates before LVN gap
2. Volume increases as price enters LVN
3. Price accelerates through LVN (minimal resistance)
4. Trade: Enter breakout, target next HVN

**POC + HVN Confluence**

* When POC sits within HVN cluster = strongest level
* Highest probability support/resistance
* Trade: Biggest bounce/rejection setups occur here

***

### Common Questions

**Q: Why does the profile sometimes look different on refresh?**\
A: If you're using Rolling mode, the profile recalculates with each new bar. Anchor to Daily/Weekly/Monthly for consistent structure that only resets at period boundaries.

**Q: How do I know if a volume node is "high enough" to matter?**\
A: Use the statistics box - look for nodes with >40% relative volume. The indicator auto-styles high-volume nodes (>70%) with dashed lines when Volume-Based styling is enabled.

**Q: Should I use Hybrid Smart or Fixed Lookback range mode?**\
A: Hybrid Smart is recommended for volatile assets (crypto, small caps) as it removes noise from outlier wicks. Fixed Lookback is better for stable assets (indices, large caps) where every price level matters.

**Q: The profile is overlapping my candles - how do I fix this?**\
A: Increase "Profile Start Offset" (default: 10 bars). This pushes the butterfly further ahead of current price. You can also reduce "Profile Width" to make it narrower.

**Q: What's the best lookback period?**\
A: It depends on your timeframe:

* 5-15min chart: 100-200 bars (recent intraday structure)
* 1H-4H chart: 200-300 bars (multi-day swing structure)
* Daily chart: 50-100 bars (longer-term trends)

**Q: Can I use this with other indicators?**\
A: Absolutely. Volume Dynamics Pro works exceptionally well with:

* Moving averages (Smart Moving Average Dynamics for ChartNation users)
* Momentum oscillators (Smart Divergence Engine for reversal confirmation)
* Support/resistance indicators
* Any price action-based strategy

**Q: Why isn't my POC extension line showing?**\
A: Check that "Extend POC into Future" is enabled, and verify your chart has enough blank bars ahead of current price for the extension to display.

**Q: How do I set up alerts?**\
A:

1. Enable "Enable Alerts" in Alert System settings
2. Enable specific alert types you want (POC Cross, Range Break, etc.)
3. Right-click the indicator → Add Alert
4. Set alert frequency to "Once Per Bar Close" for confirmed signals

***

### Best Practices

#### Do's

✅ Use anchor modes that match your trading timeframe\
✅ Compare current profile to previous period for structural shifts\
✅ Combine high-volume nodes with your existing support/resistance\
✅ Enable Volume Spike alerts to confirm breakouts\
✅ Adjust profile width/offset for clean, readable charts\
✅ Use gradient bias to anticipate support/resistance behavior\
✅ Focus on POC as primary reference level

#### Don'ts

❌ Don't trade volume nodes in isolation - confirm with price action\
❌ Don't use tiny lookback periods (<50 bars) - insufficient data\
❌ Don't ignore POC shifts - they signal major structural changes\
❌ Don't assume all high-volume nodes are equal - context matters\
❌ Don't set profile width so large it obscures your chart\
❌ Don't rely solely on alerts - verify setups visually\
❌ Don't use Rolling mode for backtesting - anchor to fixed periods

***

### Advanced Tips

**1. Composite Profile Analysis**

* Run indicator twice: one on Daily anchor, one on Weekly anchor
* Daily shows intraday structure, Weekly shows bigger picture
* Trade levels where both profiles show high-volume nodes

**2. Volume Shelf Identification**

* Look for flat sections in profile with consistent high volume
* These "shelves" act as strong magnets for price
* Trade reversals at shelf edges

**3. POC Velocity**

* Track how fast POC is migrating
* Fast POC shifts = strong directional move
* Slowing POC shift = trend exhaustion approaching

**4. Opening Range Profile**

* Use Session anchor (0930-1000 for US markets)
* First hour profile often predicts daily range
* High volume in opening range = likely to hold as support/resistance all day

**5. Naked POC Strategy**

* Identify old POC levels that haven't been retested
* Price often returns to "fill" these naked POCs
* Trade pullbacks to old POC for high-probability entries

***

### Recommended Pairings (ChartNation Ecosystem)

**Volume Dynamics Pro +** [**Smart Divergence Engine**](/documentation/indicators/smart-divergence-engine.md)

* Use Volume Dynamics Pro to identify high-volume reversal zones
* Wait for Smart Divergence Engine to signal divergence at those zones
* Entry: Divergence + high-volume node = highest probability reversal

**Volume Dynamics Pro +** [**Smart Moving Average Dynamics**](/documentation/indicators/smart-moving-average-dynamics.md)

* Volume Dynamics Pro shows WHERE price might react
* SMAD shows momentum strength and trend direction
* Entry: SMAD extreme + price at high-volume node

**Volume Dynamics Pro +** [**Smart Divergence Engine Overlay**](/documentation/indicators/smart-divergence-engine-overlay.md)

* Overlay marks exact divergence points on price chart
* Volume Dynamics Pro confirms divergence occurs at significant volume levels
* Entry: Divergence at POC or HVN with volume confirmation

***

### Troubleshooting

**Issue: Profile not updating**\
Solution: Check that LookBack period isn't exceeding available bars on chart. Reduce lookback or increase chart history.

**Issue: POC label overlapping candles**\
Solution: Change Label Position from Right to Left, or disable Label Background for transparency.

**Issue: Too many alerts firing**\
Solution: Increase High-Volume Zone Threshold % (stricter filtering) or Volume Spike Multiplier (fewer spike alerts).

**Issue: Profile looks cluttered**\
Solution: Disable Glow Boxes, reduce Glow Width +, or disable Depth Borders for cleaner appearance.

**Issue: Can't see gradient bias colors**\
Solution: Increase Tint Intensity %, reduce Proximity bins (colors appear closer to price), or boost the Glow Intensity for brighter visualization.

**Issue: Previous period profile not showing**\
Solution: Previous profile only displays in Daily/Weekly/Monthly/Session anchor modes (not Rolling), and only after first period change occurs.

***

### Technical Specifications

* **Script Version**: Pine Script v6
* **Indicator Type**: Overlay
* **Volume Bins**: 25 (fixed)
* **Calculation**: Bar volume attribution via distance-weighted distribution
* **Update Frequency**: Real-time (every bar)

***

### Credits & Support

**Developed by**: ChartNation\
**Version**: 1.0\
Discord **Community**: [discord.gg/qNCSAMZuFk](https://discord.gg/qNCSAMZuFk)

[Join ChartNation](https://chartnation.net/)


---

# 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/volume-dynamics-pro.md?ask=<question>
```

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.