Percentage Volume Oscillator (PVO)

Calculate the Percentage Volume Oscillator (PVO) for a given volume series.

The Percentage Volume Oscillator is the Percentage Price Oscillator applied to volume: the difference between a short-term and a long-term EMA of volume as a share of the long-term EMA, with a signal line and a histogram as for the MACD.

The formula is as follows:

\[\text{PVO} = \frac{\operatorname{EMA}(\text{Volume},\; \text{short\_window}) - \operatorname{EMA}(\text{Volume},\; \text{long\_window})}{\operatorname{EMA}(\text{Volume},\; \text{long\_window})}\] \[\text{Signal Line} = \operatorname{EMA}(\text{PVO},\; \text{signal\_window})\] \[\text{Histogram} = \text{PVO} - \text{Signal Line}\]

A positive PVO means recent volume runs above its longer-term average, which gives weight to a breakout or a trend in price; a PVO below zero in a rising market says the move happens on thinning volume. Because it is a share of the average volume, the PVO can be compared across stocks whatever the number of shares they trade. It says nothing about the direction of price.

For more information, see the following sources:

Also known as: PVO, volume oscillator. See momentum_model.get_percentage_volume_oscillator for the references.

Percentage Volume Oscillator (PVO) in Python or via the MCP

Install the Finance Toolkit with:

pip install financetoolkit -U

Then call get_percentage_volume_oscillator as shown below.

from financetoolkit import Toolkit

toolkit = Toolkit(
    tickers=["NVDA"],
    api_key="FINANCIAL_MODELING_PREP_KEY",
    start_date="2025-01-01",
    end_date="2025-12-31",
)

toolkit.technicals.get_percentage_volume_oscillator().xs("NVDA", level=1, axis="columns").tail(5)

Or, after setting up the Finance Toolkit MCP, ask:

How did the Percentage Volume Oscillator of Nvidia, with its signal line and histogram, move from 24 to 31 December 2025?

Which returns:

Date Histogram Percentage Volume Oscillator Signal Line
2025-12-24 -0.0392 -0.0687 -0.0295
2025-12-26 -0.0393 -0.0786 -0.0393
2025-12-29 -0.0451 -0.0957 -0.0506
2025-12-30 -0.0559 -0.1205 -0.0646
2025-12-31 -0.0509 -0.1282 -0.0773

Parameters

get_percentage_volume_oscillator accepts the following parameters.

ParameterTypeDescriptionExample
periodstrThe time period to consider for historical data. Can be “intraday”, “daily”, “weekly”, “monthly”, “quarterly” or “yearly”. Defaults to “daily”."weekly"
short_windowintThe number of periods for the short-term moving average. Defaults to 12, as for the PPO and MACD.12, as for the PPO and MACD
long_windowintThe number of periods for the long-term moving average. Defaults to 26, as for the PPO and MACD.26, as for the PPO and MACD
signal_windowintThe number of periods for the signal line. Defaults to 9.9
roundingint | NoneThe number of decimals to round the results to. Defaults to None, which uses the rounding of the Toolkit (4 unless set otherwise).2
growthboolWhether to calculate the growth of the indicator values. Defaults to False.True
lagint | list[int]The lag to use for the growth calculation. Defaults to 1.4
standardizeboolWhether to standardize (Z-Score) the result. When combined with growth=True, standardizes the growth values instead of the raw values. Defaults to False.True
show_columnsstr | list[str] | NoneThe columns to keep, a name or a list of names, matched on every column level, or the rows when no column has those names (such as the line items of a financial statement). Names that do not exist are logged, and when none exist the result is returned in full. Defaults to None, which keeps every column.None, which keeps every column
Share