Skip to main content
GET
Cumulative volume delta
Aggressor buy volume, sell volume, their per-bucket difference, and the running cumulative across the window. Derived from the same buy/sell columns /market/candles already carries, so requesting candles and CVD over one window costs a single underlying read rather than two.

On OHLC

delta is exact: buy minus sell for that bucket. open and close are the running cumulative at the bucket’s boundaries, also exact.
high and low are returned as null, with ohlc_complete: false.They would require the path the cumulative took inside the bucket, and bucket totals do not carry that. We return nulls rather than interpolating, because a fabricated wick looks exactly like data and isn’t.If you need true intra-bucket extremes, request a finer interval and aggregate client-side.

Reading the cumulative

The cumulative is relative to the start of the window, not an all-time figure. It begins at zero on the first bucket returned. Compare shapes across windows, not levels: two requests with different hours will not produce the same absolute values, and neither is wrong.

See also

Candles

Market bundle

Authorizations

X-API-Key
string
header
required

Your BackQuant API key (same key as v1)

Headers

X-API-Key
string | null

Query Parameters

symbol
enum<string>
default:BTCUSDT

Trading symbol: BTCUSDT, ETHUSDT, SOLUSDT, or HYPEUSDT.

Available options:
BTCUSDT,
ETHUSDT,
SOLUSDT,
HYPEUSDT
market
enum<string>
default:perp

perp for the perpetual aggregate, spot for spot.

Available options:
perp,
spot
interval
enum<string>
default:1h

Series interval.

Available options:
1m,
5m,
15m,
30m,
1h,
4h,
1d
hours
integer
default:168

Lookback window in hours.

Required range: 1 <= x <= 8760

Response

Successful Response