Volume Participation Curve [JOAT]Volume Participation Curve
Introduction
VPC Volume Participation Curve is an open-source volume seasonality indicator that compares current volume against historical participation for the same time bucket. It helps answer a simple but important question: is current activity meaningful compared with what usually happens at this time?
Instead of treating all volume bars equally, VPC builds recurring buckets by minute, hour, day, or month, then compares live volume against the expected bucket value. It also tracks session pace so traders can see whether the session is leading or lagging expected participation.
Core Concepts
1. Time-Bucketed Expected Volume
The indicator builds historical volume samples by time bucket. Auto mode chooses practical buckets based on the chart timeframe.
2. Median or Mean Summary
Expected volume can be calculated by median or mean. Median is the default because it is more robust against abnormal spikes.
3. Participation Ratio
The main curve is current smoothed volume divided by expected volume. A value above 1.0 means current activity is above expectation.
4. Session Pace
Session cumulative volume is compared with cumulative expected volume to determine whether the whole session is leading or lagging.
5. Regime Bands
Expansion and compression thresholds are shown as clean bands around the 1.0 baseline.
Features
Expected volume engine: Learns recurring volume behavior from historical buckets
Participation curve: Displays current volume relative to expected activity
Session pace curve: Shows whether cumulative session activity is ahead or behind
Expansion and compression bands: Identifies above-expected or below-expected participation
Dark-mode fills: Uses restrained green/red/neutral blends
Top-right dashboard: Shows bucket, participation, pace, surprise, growth, state, and sample count
Confirmed alerts: Includes expansion, compression, pace lead, and pace lag alerts
Input Parameters
Seasonality:
Historical Samples per Bucket
Bucket Mode: Auto, Minute, Hour, Day, or Month
Expected Value: Median or Mean
Curve:
Volume Smoothing
Session Pace Window
Visual:
Show Regime Bands
Show Pace Curve
Color Background
How to Use
Step 1: Read the participation curve relative to the 1.0 baseline.
Step 2: Treat readings above 1.2 as expansion context and readings below 0.8 as compression context.
Step 3: Confirm whether session pace agrees with the current bar's participation.
Step 4: Use the output as a participation filter for breakout, continuation, or reversal tools.
Limitations
New symbols or sparse histories may need time to build useful bucket samples
Unusual news or event-driven sessions can distort expected-volume comparisons
Volume reporting differs by asset class and exchange
This indicator does not predict direction; it measures participation context
Originality Statement
VPC is an original JOAT volume model combining time-bucketed expected volume, session pace, expansion/compression bands, and confirmed alerts in a Pine Script v6 pane indicator.
Disclaimer
This script is for educational and informational purposes only. It is not financial advice and does not guarantee future results. Trading involves risk, and users should apply their own risk management.
Made with passion by jackofalltrades
Indicatore Pine Script®






















