CVD PRO USER MANUAL

1. About This Manual

This manual describes CVD Pro — a TradingView PineScript v6 indicator that aggregates Cumulative Volume Delta across multiple crypto exchanges, both Spot and Futures, into one or more unified plots. The indicator pulls CVD data from up to four Spot exchanges and four Futures exchanges for the chart’s base currency, sums or compares them as the user selects, and presents the result in any of 13 different plot styles.

Unlike single-exchange CVD indicators that show only what one venue saw, CVD Pro answers a different question: “across the major venues for this asset, what was the cumulative net aggression?” The aggregated view smooths over per-exchange quirks and surfaces the consensus aggression direction across the broader market.

The manual is organized in the order most users will need information:

  • Sections 2–3 explain what CVD Pro shows and the underlying concepts (CVD itself, tick rule, cross-exchange aggregation, Spot vs Futures, the precision timeframe).
  • Section 4 walks through setup and reading the output.
  • Section 5 is the complete settings reference, organized by the UI’s grouping.
  • Section 6 covers the 13 plot styles in detail.
  • Section 7 covers the Data Analysis Table.
  • Sections 8–10 cover practical workflows, troubleshooting, and design notes.

Quick Start

  1. Apply CVD Pro to any TradingView crypto chart. The indicator uses the chart’s base currency to construct exchange-specific ticker strings (e.g., BINANCE:BTCUSDT for Spot, BINANCE:BTCUSDT.P for Futures).
  2. Default settings produce an aggregated Spot + Futures CVD displayed as candles, with all four configured exchanges of each type contributing: Binance, Bybit, Bitget, and CoinW for Futures; Binance, Bybit, MEXC, and OKX for Spot. The reset period is daily (1D), the precision timeframe is 1 second (1S).
  3. The teal/red candles show the aggregated cumulative volume delta — teal when current value is above the period’s open, red when below. The candle wicks show the high-water and low-water marks reached during the cumulative period.
  4. A vertical line appears at every reset point, marking where each cumulative period begins.
  5. Once you understand the default output, explore the Primary Plot Type & Style dropdown — 13 different ways to visualize Spot, Futures, or both. The Data Analysis Table can be enabled separately to see exact percent and absolute changes across a user-defined date range.

 

2. What CVD Pro Shows

CVD Pro plots cumulative volume delta as a candle, line, or delta curve in the chart’s lower pane, computed from a configurable aggregation of multiple exchanges. The y-axis is volume units (not price); zero is the cumulative-period start.

Two Independent Plot Slots

CVD Pro renders two plots simultaneously, each independently configurable from the same set of 13 style options. Primary plot defaults to “Spot + Futures (Candles)”; Secondary defaults to “None” (disabled). Both can be set to any combination — two different views of the same data, or two different data combinations, or one plus disabled.

This dual-slot design lets the trader overlay, for example, Spot+Futures candles (the consensus aggregation) with a Spot×Futures Delta line (the divergence between Spot and Futures). One pane, two analytical layers.

The 13 Plot Styles

Each plot slot can be set to one of these (or None):

  • Spot Only (Candles / High-Low Lines / Close Line) — Spot CVD aggregated across the enabled Spot exchanges, in three rendering styles.
  • Futures Only (Candles / High-Low Lines / Close Line) — same for Futures aggregation.
  • Spot + Futures (Candles / High-Low Lines / Close Line) — Spot and Futures CVDs summed into one combined series, then rendered.
  • Spot × Futures (High-Low Lines) — Spot and Futures CVDs plotted as separate paired lines on the same pane. Lets you see them side by side.
  • Spot × Futures (Close Line) — same idea, just the close values.
  • Spot × Futures (Close Line + Delta) — Spot and Futures close lines AND the absolute delta between them.
  • Spot × Futures (Delta) — only the absolute delta between Spot and Futures aggregations. The most distilled view of where the two diverge.

Cumulative Reset

The cumulative volume delta resets to zero at the start of each Reset Period. Default is 1D — each day the CVD starts fresh. The reset can be configured to any standard timeframe (15m, 1H, 4H, 1D, 1W, etc.).

A subtle vertical white-transparent line is drawn at each reset point on the chart to mark where each new cumulative period begins. Visible but unobtrusive — the line spans the chart’s full vertical range.

Precision Timeframe

The underlying volume delta calculation needs a precision timeframe — a lower timeframe at which buy/sell direction is decided per bar. Default is 1S (1 second) — the finest TradingView resolution available.

Why this matters: the tick-rule classification (each bar’s volume gets labeled buy or sell based on whether close > open) only works well when each bar is short enough to plausibly represent one-directional aggression. On longer bars, both buyers and sellers are mixed within the same bar’s volume and the tick rule misattributes most of it. Shorter precision = more accurate CVD; longer precision = covers more history.

TradingView limits how much history each precision timeframe can serve. 1S precision typically gives you the last few days; 1m precision gives you weeks; 5m precision can go back months. Choose the lowest precision that covers your analysis window.

 

3. Concepts You Need

This section covers the foundational concepts. Skip if you already know what CVD is, how the tick rule works, and why cross-exchange aggregation matters.

Volume Delta and the Tick Rule

Volume delta is the difference between volume traded with the aggressor on the buy side (lifting offers) and volume traded with the aggressor on the sell side (hitting bids). On platforms with order-flow data, this is reported directly. On TradingView’s standard candle data, it isn’t — the platform doesn’t break each bar’s volume into buy and sell sides.

The tick rule is the standard workaround: classify each bar’s entire volume as either buy-side or sell-side based on the bar’s directional bias. CVD Pro uses this rule:

  • If close > open, the bar is classified as buy-driven. All its volume counts as buy volume.
  • If close < open, the bar is classified as sell-driven. All its volume counts as sell volume.
  • If close == open (a doji), fall back to tick rule via the prior close: if current close > previous close, buy; if less, sell.
  • If still tied, inherit the most recent direction (the bar gets classified the same way the previous bar was).

This is an approximation — not the actual aggressor-side breakdown from the exchange — but on small enough timeframes (1S, where each bar represents at most one second of trading) it’s a reasonable proxy. As bars get longer, the approximation degrades quickly.

Cumulative Volume Delta

CVD is the running sum of volume delta across bars. Each bar adds its signed contribution: buy-classified volume adds positively, sell-classified volume adds negatively (well, its absolute value subtracts). The running total rises when buyers have been more aggressive over time and falls when sellers have been.

Within a cumulative period (e.g., one day), CVD starts at zero and accumulates. At the period’s end (or reset point), it resets and starts over. The shape of CVD within a period tells you about the day’s aggression flow:

  • CVD steadily rising → sustained buying pressure throughout the period.
  • CVD steadily falling → sustained selling pressure.
  • CVD oscillating around zero → balanced two-sided action.
  • CVD rises early, falls late → exhaustion of early buyers, sellers regaining control.

Spot vs Futures CVD

CVD Pro tracks two separate categories of exchange — Spot markets and Futures (perpetual) markets — because they often behave differently:

  • Spot CVD: Reflects actual buying and selling of the underlying asset. Driven by investors actually moving capital in and out of the asset. Tends to be slower-moving and more representative of long-term positioning.
  • Futures CVD: Reflects perpetual-contract activity. Driven by leveraged traders speculating on price direction. Tends to be faster-moving and more reactive to short-term sentiment. Often diverges from Spot during sharp moves — leveraged shorts get squeezed while spot accumulates, or leveraged longs get liquidated while spot exits.

When Spot and Futures CVD agree (both rising or both falling), there’s broad cross-market consensus. When they diverge, one side of the market is doing something different than the other — often where the interesting analytical opportunities are.

Cross-Exchange Aggregation

Looking at CVD from a single exchange has two issues: that exchange’s CVD reflects only its own users’ activity, and any data feed glitch on that exchange corrupts the picture. Aggregating across multiple exchanges solves both — the aggregated CVD reflects a broader sample of the market, and gaps in any one exchange’s feed get smoothed by the others.

CVD Pro aggregates up to 4 Spot exchanges and 4 Futures exchanges. Each enabled exchange contributes its CVD to a running total; disabled exchanges contribute zero. The defaults cover major venues: Binance, Bybit, Bitget, CoinW for Futures; Binance, Bybit, MEXC, OKX for Spot. The user can replace any of the eight with any other exchange TradingView supports.

Why Spot × Futures Comparisons Matter

Beyond the aggregated views, CVD Pro offers Spot × Futures comparison plots. These show Spot CVD and Futures CVD as separate parallel curves, or compute the absolute delta between them. The comparison answers questions like:

  • Is one market leading the other? Often Futures leads (leverage moves faster), but reversals into Spot leading often signal turning points.
  • Is there a persistent divergence? When Spot is buying while Futures is selling (or vice versa), large participants on each side disagree. Worth understanding.
  • Are they converging or diverging? The Δ between the two — particularly in absolute terms — quantifies how disconnected the two market structures currently are.

 

4. Setup and Reading the Output

Installation

CVD Pro is a TradingView PineScript v6 indicator. Install via TradingView’s standard indicator-management workflow — copy the source into the Pine Editor and click “Add to Chart”.

Chart Compatibility

CVD Pro is designed for crypto charts. It uses the chart’s base currency to construct exchange-specific tickers like BINANCE:BTCUSDT (Spot) and BINANCE:BTCUSDT.P (Futures Perpetual). It expects the chart’s base currency to be a token symbol that has a USDT pair on the configured exchanges — works for BTC, ETH, SOL, and most major and mid-cap tokens; may not work for tokens that don’t trade against USDT or that aren’t listed on the configured exchanges.

Non-crypto charts (equities, forex, commodities) won’t produce useful output — the constructed tickers won’t exist and the indicator will return na for every exchange request. Use the “Disable Aggregation” toggle if you want to plot CVD for the current chart’s exact symbol regardless of what it is.

Pane Placement

CVD Pro is not an overlay indicator — it draws in a separate pane below the price chart. The y-axis shows volume units (typically thousands or millions of contracts/coins depending on the asset). Zero is the cumulative-period start; the line/candle position relative to zero shows the running net delta within the current period.

Reading CVD Candles

When a Candles plot style is enabled, each chart bar gets a CVD candle:

  • Open — CVD at the start of this bar (i.e., at this bar’s open time).
  • Close — CVD at the end of this bar (current value as of bar close).
  • High — highest CVD reached during this bar’s lifetime (within the current cumulative period).
  • Low — lowest CVD reached during this bar’s lifetime (within the current cumulative period).

Color is dynamic: teal when CVD increased over the bar (close > open), red when it decreased. Visually mirrors how price candles work, applied to the CVD series.

Reading Line Plots

High/Low Lines styles render the period’s high-water and low-water marks as two horizontal lines per bar. Close Line styles render just the closing value. Both are useful for tracking CVD’s path without the visual weight of candles.

Color conventions vary by style: aggregated Spot+Futures plots use teal for highs and red for lows; Spot×Futures comparisons use green for Spot and purple for Futures, distinguishable at a glance.

Reading Delta

Delta-style plots show the absolute difference between Spot CVD and Futures CVD — abs(Futures CVD − Spot CVD). The value is always positive (it’s the magnitude of divergence, not the direction). High delta means Spot and Futures are far apart; low delta means they’re moving in lockstep.

Direction of divergence isn’t encoded in the delta line — you need to read Spot and Futures separately to see which side is leading. The Spot × Futures (Close Line + Delta) style combines both: Spot and Futures lines side by side, plus the absolute delta as a third line. Most informative single plot when divergence is the focus.

Reset Markers

A faint vertical line is drawn on the chart at each reset point — the moment the cumulative period changes and CVD snaps back to zero. By default this fires daily. The line is intentionally subtle (semi-transparent white) — visible enough to mark the reset but not loud enough to distract from the CVD data.

 

5. Settings Reference

CVD Pro’s settings are organized into four groups: Data Collection (precision and reset settings, primary/secondary plot choice), Futures Exchanges (4 rows of exchange config), Spot Exchanges (4 rows of exchange config), and CVD Data Analysis & Table. The reference below covers each group in the order it appears.

Data Collection

Reset Period   Default: 1D

How often CVD resets to zero. At each reset boundary, the running cumulative delta starts over.

Choose from any TradingView-supported timeframe (15m, 1H, 4H, 1D, 1W, etc.). Use a daily reset (1D) for session-by-session analysis, a weekly reset (1W) for swing-style analysis, or shorter resets (1H, 4H) for ongoing intraday analysis.

A vertical reset marker is drawn on the chart at each reset boundary.

Precision TimeFrame   Default: 1S

The timeframe at which the underlying volume delta is calculated. Each bar at this resolution is classified buy or sell via the tick rule, and contributes its volume signed to the running CVD.

Lower precision (1S, 5S, 10S) produces more accurate CVD because the tick rule is more reliable at finer timeframes — each bar represents a smaller, more directional slice of trading.

Higher precision (1m, 5m, 15m) covers more history because TradingView retains finer-resolution data for less time. 1S typically gives a few days; 1m a few weeks; 5m several months.

Choose the lowest precision that covers your analysis window. The tooltip in the source: “Choose the LOWEST timeframe that can plot through the time window you’re interested in.”

Primary Plot Type & Style   Default: Spot + Futures (Candles)

Which combination of CVD series to plot in the primary plot slot, and in which style. 13 options spanning Spot only, Futures only, Spot+Futures aggregated, and Spot×Futures comparison views (covered in Section 6).

Headers like “0️⃣ ———-” through “6️⃣ ———-” act as visual separators in the dropdown — selecting any of them is functionally equivalent to selecting None.

Default “Spot + Futures (Candles)” produces the consensus aggregation view: teal/red candles showing the combined Spot+Futures CVD across all enabled exchanges.

Secondary Plot Type & Style   Default: None

Same 13 options as the primary, applied to the secondary plot slot.

Defaults to None — secondary plot is disabled, only the primary draws. Enable when you want two simultaneous views (e.g., primary as candles, secondary as Delta).

Both slots render in the same pane, so visual interference can occur if both produce dense plots. Common pairings: Candles primary + Delta secondary; Close Line primary + Close Line secondary at different aggregations.

Disable Aggregation / Use Chart’s Exchange:Pair   Default: Off

Override toggle. When on, all aggregation settings are ignored and CVD is computed only for the chart’s actual exchange:ticker. Only the Chart Ticker Candles plot draws (the same Candles styling as the aggregated plot, but for one exchange).

Useful when you want to see CVD for a specific exchange’s view of the asset, without any cross-exchange aggregation. Also useful on non-crypto charts where the aggregated tickers don’t exist.

When this is on, every “Aggregate” exchange toggle in the Futures and Spot groups, and all force-plot toggles, are effectively ignored — only the chart’s ticker matters.

Futures Exchanges

Four rows of futures exchange configuration, each row containing four inline settings: Aggregate toggle, Exchange name, Force Plot toggle, and Force Plot color.

Aggregate (Row 1-4)   Default: On / On / On / On

Whether this exchange’s Futures CVD contributes to the aggregated Futures plot.

When on, the exchange’s CVD (constructed as EXCHANGE:BASE+USDT.P) is added to the running Futures aggregation.

When off, the exchange contributes zero — the aggregation continues without it.

Exchange Name (Row 1-4)   Default: BINANCE / BYBIT / BITGET / COINW

The exchange’s TradingView prefix string. The indicator constructs the ticker as EXCHANGE:BASE+USDT.P where BASE is the chart’s base currency.

Examples: BINANCE → BINANCE:BTCUSDT.P for a BTC chart; OKX → OKX:BTCUSDT.P.

Replace with any exchange you prefer. The exchange must support USDT-margined perpetuals for the base currency on TradingView; check by trying the constructed ticker in TradingView’s symbol search.

Force Plot In (Row 1-4)   Default: Off / Off / Off / Off

When on, this exchange’s individual Futures CVD is plotted as a separate close-line on the chart, regardless of the aggregation setting.

Use to compare the Aggregated view against individual exchanges — see which exchange is leading or lagging the consensus.

The line is colored with the corresponding Color setting (next item).

Only active when Disable Aggregation is OFF.

Color (Row 1-4)   Default: Yellow / Orange / Light Blue / White

Color for the force-plot line of this exchange. Each exchange gets its own distinct color so they’re identifiable when multiple are force-plotted.

Only relevant when Force Plot is on for this exchange.

Spot Exchanges

Four rows of spot exchange configuration, identical in structure to the Futures Exchanges group but for spot markets (constructing tickers as EXCHANGE:BASE+USDT, without the .P suffix).

Aggregate / Exchange Name / Force Plot / Color (Row 1-4)   Default: All On / BINANCE BYBIT MEXC OKX / All Off / Yellow Orange Blue White

Same semantics as the Futures Exchanges group but for Spot markets.

Default Spot exchanges: Binance, Bybit, MEXC, OKX — major spot venues with good liquidity for most major cryptos.

Tickers constructed as EXCHANGE:BASE+USDT (no .P). Example: MEXC → MEXC:BTCUSDT for a BTC chart.

CVD Data Analysis & Table

Controls the Data Analysis Table — a separate output showing exact percent and absolute CVD changes across a user-defined date range.

From   Default: 2026-04-05 00:00 UTC

Start of the analysis date range. CVD values at this timestamp become the reference for all change calculations in the table.

Defaults to a fixed date that will likely need updating for live analysis. Pick a date marking the start of the period you want to analyze.

To   Default: 2026-04-08 00:00 UTC

End of the analysis date range. CVD values at this timestamp (or at the live bar, if Override End Date is on) become the comparison point.

Ignored when Override End Date is on.

Override End Date   Default: On

When on, the To date is ignored and the table calculates against the live bar continuously. CVD values update as new bars arrive.

When off, the table is locked to the configured From-To range. Useful for analyzing a completed historical window.

Delta Percent Changes   Default: Off

Toggle for the percentage-format columns in the Data Analysis Table. When on, shows percent change from the From reference at the period’s Low, Close, and High points.

Can be combined with Delta Absolute Changes for both formats.

Delta Absolute Changes   Default: Off

Toggle for the absolute-format columns in the Data Analysis Table. Shows raw CVD unit changes at the period’s Low, Close, and High points.

Can be combined with Delta Percent Changes for both formats.

With neither toggle on, the table is hidden entirely.

 

6. The 13 Plot Styles

The Primary and Secondary plot style dropdowns each offer 13 ways to render CVD data. Understanding what each one shows is key to using CVD Pro effectively.

Single-Source Styles

  • Spot Only (Candles) — OHLC candles for the Spot CVD aggregation. Teal when close > open, red when close < open.
  • Spot Only (High/Low Lines) — Just the high-water and low-water marks of the Spot CVD aggregation, plotted as paired lines. Less visually cluttered than candles.
  • Spot Only (Close Line) — Only the closing value of the Spot CVD aggregation — a single line.
  • Futures Only (Candles / High/Low Lines / Close Line) — Same three views, but for the Futures CVD aggregation instead of Spot.

Combined Aggregation Styles

  • Spot + Futures (Candles / High/Low Lines / Close Line) — Spot and Futures CVDs SUMMED into one combined series, rendered in the chosen style. This is the “consensus aggregation” — when most users think “CVD,” this is what they imagine.

Comparison Styles

  • Spot × Futures (High/Low Lines) — Spot and Futures CVDs plotted as separate paired lines. Spot in green, Futures in purple. Lets you see both market structures simultaneously and read their disagreement directly.
  • Spot × Futures (Close Line) — Same idea, just the closing values. Two lines, one green (Spot) and one purple (Futures), tracking each market’s CVD over time.
  • Spot × Futures (Close Line + Delta) — Spot and Futures close lines PLUS a third line showing the absolute delta between them (yellow). Most informative single plot when Spot/Futures divergence is the focus.
  • Spot × Futures (Delta) — Just the absolute delta between Spot and Futures aggregations — a single red line. The most distilled view of divergence magnitude. High = Spot and Futures are far apart; low = they’re moving in lockstep.

Force-Plot Overlays

In addition to the 13 styles, the per-exchange Force Plot toggles can add up to 8 additional close-lines to the pane — one per exchange (Futures 1-4, Spot 1-4) — when those toggles are on. Each Force-Plotted line is drawn in its configured Color. Useful for granular comparison of which individual exchanges are contributing what to the aggregation.

Force Plots respect the Disable Aggregation toggle — when aggregation is off, individual force plots are also off.

 

7. The Data Analysis Table

Beyond plots, CVD Pro renders a sortable table summarizing CVD activity across a user-defined date range. The table is shown only when at least one of the Delta Percent Changes or Delta Absolute Changes toggles is on.

Layout

The table is 7 columns × 6 rows in the bottom-right corner of the chart pane:

  • Row 0 — column headers (Δ, Price, Spot Vol, Fut. Vol, Tot. Vol, Δ(S/F Δ)).
  • Rows 1-5 — data rows for Price, Spot Volume, Futures Volume, Total Volume, and Δ(S/F Δ) (the absolute delta between Spot and Futures).
  • Columns 0-6 — Δ marker, then alternating Percent (columns 2, 4, 6 — Low, Close, High) and Absolute (columns 1, 3, 5 — Low, Close, High) views.

The structure surfaces three pieces of analytical information for the chosen date range:

  • Low / Close / High — The CVD at the period’s lowest point, at its end (close), and at its highest point. Tells you where CVD was at the extremes vs where it ended.
  • Percent vs Absolute — Two parallel formats. Percent shows the change as a percentage relative to the From-date reference; Absolute shows the raw unit change. Both formats are independently toggleable.
  • Spot / Futures / Total / Delta breakdown — Each row shows the corresponding view: Spot CVD only, Futures CVD only, combined Total, and the absolute Spot-Futures delta.

Color Coding

Cell colors carry directional information: green when the value is positive (CVD increased), red when negative (CVD decreased). Magnitude is in the cell value itself — color just tells you direction at a glance.

Use Cases

The table is most useful for analyzing specific time windows after the fact — “what happened to CVD between Tuesday and Friday this week?”

  • Set From to the start of your analysis window and To to the end.
  • Toggle on Delta Percent Changes (or Absolute, or both).
  • Read the table: was the period’s high CVD reached early or late? Did the close end up above or below the open? Did Spot lead Futures or vice versa?

For live analysis, leave Override End Date on so the To date updates continuously. The table will show the current state of the analysis window in real time.

 

8. Practical Workflow

First Session With a New Asset

Apply CVD Pro to a crypto chart with USDT-paired Spot and Futures markets on the major exchanges (any of: BTC, ETH, SOL, XRP, ADA, and most large-caps). Leave settings at default and observe the output through a meaningful range.

After observing, evaluate by these criteria:

  • CVD candles are very small or very large — adjust the Reset Period. Shorter resets (4H, 1H) produce smaller-amplitude CVD curves; longer resets (1W) produce larger-amplitude ones.
  • Chart shows na for many bars / CVD line breaks frequently — the precision timeframe is too low to cover this much history. Increase precision (1S → 5S → 1m → 5m) until the history is continuous.
  • Want to see how individual exchanges contribute — enable Force Plot for each exchange of interest. Adds individual close-lines per exchange on top of the aggregation.
  • Want to focus on Spot vs Futures divergence — change Primary Plot to “Spot × Futures (Close Line + Delta)”. Shows both series simultaneously plus the absolute delta.

Reset Period Strategy

Reset Period determines the analysis horizon — what counts as “one cumulative period.”

  • 1H or 4H — short-term, captures intraday momentum shifts. CVD resets to zero often, making each period a small story.
  • 1D (default) — session-based analysis. Each day is one CVD story; reset markers fall at midnight UTC.
  • 1W — swing-style analysis. Each week’s CVD captures multi-day positioning shifts. Reset markers fall at the start of each ISO week.

Match the Reset Period to the timeframe of analysis you’re doing. For day-trading, 1H or 4H. For position-trading, 1D or 1W.

Precision Trade-Off

Precision Timeframe sets the underlying tick-rule resolution. Lower = more accurate; higher = covers more history.

  • 1S — most accurate, but only a few days of history available.
  • 5S — slightly less accurate, more history.
  • 1m — moderate accuracy, weeks of history.
  • 5m — less accurate, months of history.

Start with 1S for analyzing recent action; increase precision only when you need to look further back. The accuracy degradation at longer precision timeframes is real but usually subtle — the broad CVD shape stays informative.

Combining With Other Indicators

CVD Pro identifies cumulative net aggression direction across exchanges. It doesn’t generate signals or identify price levels. Practical use typically combines CVD Pro with:

  • Volume profile or footprint analysis on the price chart for level-based context — where is price relative to the cumulative-period range?
  • Higher-timeframe market structure (swing highs/lows, trend lines) for directional bias.
  • Curator (the family’s cross-asset performance tracker) on a separate pane — see how multiple assets’ CVDs compare in their own panes alongside CVD Pro for the chart asset.
  • ZZ Div + ST with External oscillator set to CVD — feed CVD Pro’s series into ZZ Div + ST’s divergence detector for CVD-vs-price divergence detection on the same chart.

 

9. Troubleshooting & FAQ

“NO VOLUME DATA” error at the end of chart load

The chart’s volume data is empty. CVD Pro requires volume to compute. This usually means the chart’s symbol doesn’t have volume data on TradingView (some forex symbols, certain synthetic instruments) or the data feed is broken. Try a different exchange’s version of the same symbol, or apply CVD Pro to a different asset.

“Invalid LTF” runtime error

The Precision TimeFrame is set higher than the chart’s current timeframe. PineScript’s request.security_lower_tf-style functions require the lower timeframe to be lower than or equal to the chart timeframe. Switch the chart to a lower timeframe, or increase the Precision TimeFrame to be lower or equal to the chart.

CVD lines have gaps / show na frequently

The Precision TimeFrame is too low to cover the visible history. TradingView retains finer-resolution data for less time. Increase precision (1S → 5S → 1m → 5m) until the line is continuous. The tradeoff is slightly less accurate tick-rule classification at higher precision; for most analysis the gain in coverage is worth it.

Force-plotted exchange line is missing

Either the exchange doesn’t have the constructed ticker (e.g., the asset isn’t listed on that exchange with the USDT pair), or Disable Aggregation is on. Force-plots respect the disable-aggregation toggle. Verify the exchange has the asset’s USDT pair by trying the constructed ticker (EXCHANGE:BASE+USDT or BASE+USDT.P) in TradingView’s symbol search.

Spot-only or Futures-only aggregation is zero or missing

All exchanges in that category are disabled. At least one Aggregate toggle in the Spot or Futures group needs to be on for that aggregation to produce data. Re-enable the exchanges you want to include.

The data table is hidden

The table requires at least one of Delta Percent Changes or Delta Absolute Changes to be toggled on. With both off, the table is hidden entirely. Toggle one or both on.

CVD looks completely different from another CVD indicator

Different CVD indicators make different choices: (1) what tick rule, (2) what precision timeframe, (3) what exchanges aggregated, (4) what reset period. CVD Pro uses close-vs-open with prior-close fallback. Other indicators may use the bar’s intra-bar volume profile (more accurate but requires order-flow data not available on TradingView), or different tie-breaking rules. Differences are expected; what matters is the SHAPE of CVD over time, not the exact units, when comparing across indicators.

Delta plot is always positive

Expected. The Spot × Futures Delta plot uses abs(Futures − Spot), so it’s always non-negative. Direction of divergence isn’t encoded in the delta line — read Spot and Futures separately to see which side is leading.

Reset marker line is barely visible

Expected. The reset marker is intentionally subtle (semi-transparent white) — it marks the reset boundary without competing with CVD data for visual attention. If you want it more visible, edit the source’s line.new call to change the color.

CVD aggregation produces strange values for a niche token

If the token isn’t listed on all four Spot/Futures exchanges with USDT pairs, missing exchanges contribute na, which suppresses the aggregation entirely (the indicator requires all enabled exchanges to be valid simultaneously). Disable Aggregate for the missing exchanges to enable partial aggregation across only the exchanges that have the asset.

 

10. Limitations and Design Notes

What CVD Pro Does Not Do

  • It does not predict price. CVD shows historical net aggression flows; future flows and resulting price moves are open questions.
  • It does not generate trading signals. Divergences and aggregation patterns are interpretation context, not commands.
  • It does not use actual exchange-reported aggressor data. TradingView doesn’t expose this on standard candle feeds. The tick rule is an approximation — useful, but not the same as real per-tick aggressor data.
  • It does not adjust for exchange-specific volume scaling. Each exchange’s volume is summed as-is into the aggregation — venues with larger volumes contribute more to the running total, which is usually what the user wants.

The Tick Rule’s Limits

The tick rule classifies entire bar volumes as buy or sell based on directional bias. At very small bars (1S resolution), this is a reasonable proxy — each bar’s volume is likely dominated by aggression in one direction. At larger bars, both buyers and sellers operate within the same bar, and the tick rule misattributes most of the volume.

This is why precision timeframe matters so much. 1S is the sweet spot for accuracy. Using 5m or larger precision will produce a CVD shape that may be technically valid but progressively less representative of actual order flow.

Why Spot and Futures Are Tracked Separately

Combining them at the data layer would obscure the divergence information that’s often the most valuable insight. CVD Pro keeps them separate and lets the user choose how to combine: summed (Spot + Futures aggregation), compared (Spot × Futures views), or as just one side (Spot only / Futures only). The flexibility comes from keeping the two streams independent until the rendering layer.

Why Up To 4 Exchanges Each

Eight total request.security calls (four Spot + four Futures) is well within TradingView’s per-script budget. Each enabled exchange costs one request.security call, plus additional ones for the chart ticker if aggregation is disabled. The 4-per-side limit accommodates major venues without exceeding script limits.

Within each side, the exchanges are user-replaceable. The defaults (Binance, Bybit, Bitget, CoinW for Futures; Binance, Bybit, MEXC, OKX for Spot) cover the highest-volume crypto venues at time of writing, but they’re just defaults.

Frozen Reset vs Rolling Reset

CVD Pro uses TradingView’s standard period boundaries for resets — e.g., 1D reset fires at midnight UTC. This is anchored, not rolling — the reset doesn’t depend on when the chart was opened or when the indicator was applied.

Consequence: applying the indicator partway through a session shows partial CVD from the most recent reset, not a freshly-started CVD from the moment of application. This is consistent with how TradingView’s other timeframe-aware indicators work.

Why the Reset Marker Is Subtle

A loud reset marker would visually compete with the CVD data. The subtle semi-transparent white line is enough to mark the boundary without distracting the eye. Reset markers don’t typically need to be prominent — they’re reference points, not the data itself.

Closing Note

CVD Pro answers a specific question: across the major crypto venues for this asset, what has the cumulative net aggression looked like, and how does it differ between Spot and Futures markets? The cross-exchange aggregation smooths over per-venue noise; the Spot/Futures split surfaces divergences that often matter more than the combined view. The 13 plot styles and the analysis table let the user choose how to read the answer — visual at one extreme, tabular at the other.