VLiner Market R1 - Complete User Manual

🎯 Overview

VLinerMarket R1 is an entry-level TradingView indicator that combines two powerful analytical tools optimized for both live trading and replay analysis:

📊 Volume Oscillator (X)

Session-aware volume momentum indicator using 15-minute EMA data, plotted around a baseline EMA. Features white/orange color scheme for clear trend identification.

🔵 Delta Bubbles (Y)

30-minute buy/sell pressure visualization with adaptive sizing (1-10 scale), 3D gradient effects, and intelligent percentile-based scaling system.

Key Features: Optimized performance with configurable lookback periods, works seamlessly in both live trading and replay mode, includes comprehensive debugging tools, and features independent controls for visual elements. Bubble labels are automatically managed at ~200 bars for optimal performance within TradingView's visual object limitations.

⚙️ Setup

Accessing Settings

Method 1: Right-click on the chart and select "Settings" next to "VLM R1"
Method 2: Click the gear icon (⚙️) next to the indicator name in the top-left corner
Method 3: Double-click on the indicator name "VLM R1" in the indicator list

⚠️ Important - Default Limits Are Intentional: The default bubble lookback (500 bars; All Timeframes) and label lookback (≈ 36 hours) settings are carefully calibrated for optimal trading performance and chart readability. These limits prevent information overload while maintaining sufficient historical context for accurate analysis. Increasing these values significantly may impact chart performance and visual clarity.

🎛️ Complete Settings Guide

Core Parameters

Setting	Default	Range	Description
VO Short EMA Length	5	1+	Fast EMA period for volume oscillator calculation
VO Long EMA Length	10	1+	Slow EMA period for volume oscillator calculation
Baseline EMA Length	50	1+	Trend reference line and bubble anchor point
EMA Time-Frame	Current Chart	Any TF	Timeframe for baseline EMA calculation
VO Time-Frame (X)	15 min	Any TF	Timeframe for volume oscillator data
Delta Time-Frame (Y)	30 min	Any TF	Timeframe for delta bubble calculations
Oscillator Scale Coefficient	1.0	0.1-10.0	Vertical scaling factor for VO visibility

Performance Controls

Setting	Default	Range	Description
Delta Bubble Lookback (Bars)	300	50-600	How many bars back to render bubble visuals
VO & EMA Lookback (Bars)	600	100-1200	How many bars back to render lines
Bubble Labels	Fixed at 200 bars	Not adjustable	Label display automatically spans ~200 bars for optimal performance ⚠️ Fixed due to TradingView visual object limitations

Color Customization

Element	Default Color	Description
Baseline EMA Color	Aqua	Trend reference line color
Volume Oscillator Up Color	White	VO line when volume momentum is positive
Volume Oscillator Down Color	Orange	VO line when volume momentum is negative
Delta Bubble Up Color	Lime	Bubbles for net buying pressure
Delta Bubble Down Color	Red	Bubbles for net selling pressure
Number Label Text Color	White	Text color for bubble scale numbers (1-10). Customize for better visibility against different candlestick or chart color schemes

Debug & Analysis Tools

Setting	Default	Purpose
Show Debug Info (Delta Values)	Not Enabled	Displays real-time debug table in top-right corner with detailed metrics. Also helps to debug incase of visual errors.

📊 Understanding the Visual Elements

Volume Oscillator (X) - The White/Orange Line

White Line (Positive)

Volume momentum above average - indicates increasing buying interest, market activity acceleration, or strong volume accumulation (**remember its tick-volume)

Orange Line (Negative)

Volume momentum below average - indicates decreasing activity, potential consolidation phase

Key Insights:

Distance from baseline: Further from the aqua line = stronger volume momentum
Color transitions: Watch for changes between white and orange for momentum shifts
Divergences: Price makes new highs/lows but VO doesn't follow - potential trend reversal signal
Baseline interaction: VO crossing above/below the aqua EMA indicates momentum direction changes

Volume Mechanics

Understanding the market dynamics behind volume patterns provides crucial insight into behavior:

High Volume = Strong Accumulation

When large market participants want to build significant positions, they must absorb available liquidity across multiple price levels. This creates sustained volume spikes as they work through the orderbook systematically. The increased volume reflects the market's effort to digest these strong volumeflows. Although this could lead to misconceptions due to tick-based volume, it is still a some-what valid indicator of strong volume accumulation just to be studied easily.

Low Volume = Distribution

Reduced volume often signals institutional withdrawal from active participation. Large players strategically pull their resting orders from the orderbook during uncertain periods - particularly before major news events, earnings releases, or economic announcements. This creates a thinner orderbook with reduced liquidity. Additionally, when they are distributing positions, they do so gradually to minimize market impact, resulting in lower overall volume as they wait for retail and smaller players to provide natural buying interest in the off-hours.

💡 Market Context: 'Higher' volume periods often present the best order entries due to increased liquidity. Low volume periods require more caution as liquidity is reduced.

Delta Bubbles (Y) - The Colored Bubbles/Circles

Bubble Colors & Meaning

Green Bubbles (+)

Net buying pressure during the 30-minute period. Size indicates magnitude of buy-side dominance and strong/institutional interest.

Red Bubbles (-)

Net selling pressure during the 30-minute period. Size indicates magnitude of sell-side dominance and potential distribution.

Bubble Sizing System (Scale 1-10)

Scale Level	Visual Size	Interpretation	Trading Context
1-2	Tiny	Minimal volume imbalance	Normal market activity, balanced flow, normal for off-hours
3-4	Small	Moderate volume imbalance	Some directional bias emerging
5-6	Normal	Significant volume imbalance	Clear market sentiment, good for trend confirmation
7-8	Large	Strong volume imbalance	High conviction moves, strong participation + pressure is likely
9-10	Huge	Extreme volume imbalance	Major institutional activity, potential key levels

Delta Bubble Plotting Timeline

Delta bubbles are plotted based on their configured timeframe (default: 30 minutes), meaning each bubble represents the cumulative volume imbalance over that entire period. When a new 30-minute bar closes, the indicator calculates the net difference between buying and selling volume for those complete 30 minutes, then plots the appropriately sized and colored bubble. This time-based approach ensures that each bubble reflects substantial volume activity rather than momentary fluctuations, providing more reliable flow signals for market insights.

Baseline EMA - The Aqua Reference Line

The aqua line serves multiple critical purposes:

Trend Direction: Price above/below indicates overall trend bias and market structure
Bubble Anchor: All delta bubbles are positioned relative to this line for consistent reference
Volume Context: VO oscillates around this line, providing volume momentum context

🔧 Debug Table Guide

Enabling Debug Mode

Open indicator settings (see Installation & Setup section)
Scroll down to find "Show Debug Info (Delta Values)"
Check the box to enable (set to True)
Click "OK" to apply changes
Debug table appears in the top-right corner of your chart

📋 Note: Table updates every 30 minutes (or your chosen delta timeframe)

Debug Table Metrics Explained

💡 Understanding Debug Data: Each field provides specific insights into volume analysis and indicator performance.

Field	Description	Usage & Interpretation
Bar Delta	Raw volume difference (Up Vol - Down Vol)	Actual delta value for current bubble - positive = buying, negative = selling
Scale Level	Calculated bubble size (1-10)	Percentile rank within recent 200-bar history - higher = more significant
History Size	Number of delta values in scaling calculation	Should build to ~200 for stable scaling - lower means still accumulating data
Up Vol	Total buying volume for current delta period	Raw buy-side activity measurement - compare with Dn Vol for context
Dn Vol	Total selling volume for current delta period	Raw sell-side activity measurement - higher = more selling pressure
Bar Index	Current bar number in the chart	Helps verify lookback calculations and chart position
Bubble Limit	Number of bars for bubble rendering	Shows your current bubble lookback setting (default: 500)
Label Bars	Fixed at 200 bars for label display (approximately 20 hours)	Shows fixed label lookback - always displays "200 bars" due to TradingView limitations

⚠️ Important: Debug table only updates when new delta timeframe bars complete (every 30 minutes by default). It shows data for the most recent delta calculation, not every chart bar.

⚡ Performance Optimization

💡 Default Settings Philosophy: The default configuration (300 bubble bars, 600 VO/EMA bars, 200 fixed label bars) represents the optimal balance between comprehensive analysis and chart performance. These limits were carefully chosen based on extensive testing to provide maximum trading value without visual clutter or performance degradation, while working within TradingView's platform limitations.

Timeframe-Specific Guidelines

💡 Optimization Guide: Adjust settings based on your primary trading timeframe for best performance.

Chart Timeframe	Recommended Bubble Bars	Recommended VO/EMA Bars	Label Coverage
1-5 minute	200-400	400-800	Fixed at 200 bars
15-30 minute	300-500	600-1000	Fixed at 200 bars
1-4 hour	400-600	800-1200	Fixed at 200 bars

⚠️ Updated Limits: Maximum settings have been optimized for TradingView compatibility: Delta Bubbles (600 bars max), VO/EMA Lines (1200 bars max), Labels (fixed at 200 bars). These limits ensure reliable performance across all subscription tiers while maintaining excellent analytical capability.

🛠️ Troubleshooting

Common Issues & Solutions

Bubbles not appearing in replay mode

Cause: Label lookback period too short for replay date
Solution: Increase "Bubble Label Lookback (Days)" to cover your replay timeframe. For replays older than 5 days, increase to 10-20 days.

All bubbles showing same small size (1-3 scale)

Cause: Insufficient historical data for scaling calculation
Solution: Check Debug Table "History Size" - should be ~200. If lower, wait for more data accumulation or refresh indicator.

VO line appears choppy or erratic

Cause: Scaling or smoothing issues
Solution: Increase "Oscillator Scale Coefficient" for better visibility, or adjust EMA lengths (try 7/15 instead of 5/10).

Chart loading slowly or freezing

Cause: Too much historical data being processed
Solution: Reduce lookback bar counts. Start with 200/400 configuration (bubbles/VO-EMA) and increase gradually up to the maximum limits (600/1200).

Debug table shows unexpected values

Cause: Various data or configuration issues
Solution: See Debug Mode Diagnostics below for specific troubleshooting.

Number labels on bubbles are hard to read or invisible

Cause: Label text color conflicts with chart color scheme or candlestick colors
Solution: Go to indicator settings → Color Customization → "Number Label Text Color" and choose a contrasting color (try black for light backgrounds, bright colors for dark themes).

Debug Mode Diagnostics

History Size < 50: Indicator still building data - wait 1-2 hours or refresh indicator
All Scale Levels = 1: No volume variance detected - check if market is open and timeframe settings are correct
Bar Delta = 0 consistently: No volume on recent bars - normal during market holidays or very low activity periods
Up Vol = Dn Vol = 0: No volume data available - check symbol or timeframe compatibility
Label Bars shows very high number: Label lookback calculation may be too aggressive for the timeframe

📋 Quick Reference

Default Settings Summary

Core Settings

VO Short EMA: 5
VO Long EMA: 10
Baseline EMA: 50
VO Timeframe: 15 minutes
Delta Timeframe: 30 minutes

Performance Settings

Delta Bubbles: 300 bars (max 600)
VO & EMA Lines: 600 bars (max 1200)
Bubble Labels: 200 bars (fixed)
Debug Mode: OFF
Scale Coefficient: 1.0

Color Scheme

Baseline EMA: Aqua
VO Up (Positive): White
VO Down (Negative): Orange
Bubbles Up (Buying): Lime
Bubbles Down (Selling): Red
Number Label Text: White

Essential Shortcuts

Quick Settings Access: Double-click indicator name "VLM R1"
Debug Toggle: Settings → Show Debug Info (Delta Values)
Performance Mode: Bubbles: 200 bars, VO/EMA: 400 bars
Analysis Mode: Bubbles: 600 bars, VO/EMA: 1200 bars, enable debug
Reset to Defaults: Remove indicator and re-add to chart

Key Interpretation Points

Strong Signals: Large bubbles (7-10) + matching VO color
Divergence Alerts: VO color change without price confirmation
Entry Timing: VO momentum + fresh large bubble in same direction

💡 Best Practice: Always validate settings in replay mode before live trading. Start with default settings (300/600 bars) and only increase to maximum limits (600/1200 bars) if your TradingView subscription and system performance allow. Labels are automatically optimized at 200 bars for all users.

📞 Support & Legal

Technical Support

This indicator is semi-maintained and will no longer be updated. For technical support, configuration assistance, or feature requests, contact the authorized development team:

MT Blue - Primary Development
NinetySevenGroup Co., Ltd. - Parent Company
Worakarn Phaola-or - Analyst & Lead Developer

📧 Contact Email: [email protected]

Version Information

Current Version

VLinerMarket R1 v1.0
Release Date: 13 December 2025
Build: Release
Manual Version: 2A (21 july 2026)

⚠️ EDUCATIONAL PURPOSES ONLY: VLiner Market R1 and this manual are provided strictly for educational and informational purposes. This is not financial advice and should not be used to make trading or investment decisions.