OPEN-SOURCE SCRIPT

Volume Participation Curve [JOAT]

580
Volume Participation Curve [JOAT]

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.

snapshot

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

Aviso legal

As informações e publicações não se destinam a ser, e não constituem, conselhos ou recomendações financeiras, de investimento, comerciais ou de outro tipo fornecidos ou endossados pela TradingView. Leia mais nos Termos de Uso.