Bitcoin Cumulative Volume Delta (CVD)

Cumulative sum of net buying and selling pressure in Bitcoin markets, calculated in USD by aggregating the difference between market buy and sell volume across major exchanges

View in Newhedge External link

How to call

Request format

GET 
curl -X GET "https://newhedge.io/api/v2/metrics/cvd-dollars/METRIC_NAME?api_token=YOUR_TOKEN"
Query params

api_token (required) — 24 character token.

resolution (optional) — 1d only for the metrics on this chart. Any other value is refused with a 400 that names what is available; see Resolutions.

before (optional) — exclusive cursor, returns observations older than this timestamp_ms. Works on every resolution.

limit (optional) — the most recent N observations, maximum 5000. Finer resolutions page by default (2500); a 1d request returns the whole series unless you send limit or before.

before and limit narrow a time series. A response with no single time axis, such as a hash keyed by venue or a labelled snapshot table, has nothing to cut on. It is returned whole, and both parameters are ignored rather than rejected.

A before that is not a positive epoch-millisecond timestamp is a 400. It is the one paging value we reject rather than ignore, because a page size has a sensible default and a cursor does not.

include (optional) — definition wraps the response as {"definition": …, "data": …} and returns the record shown under each metric; see Definitions. Any other value is a 400.

Path params

:metric_name — one of the metric names listed below.

Responses

200 with JSON payload, 400 for an unknown include value, 401 for missing/invalid token, 404 for missing resources.

Metrics

Each metric is fetched independently. Responses are trimmed samples to show structure.

5 metrics
Metric

Binancebitcoin_cvd_dollars_binance

Data used by the Bitcoin CVD chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/cvd-dollars/bitcoin_cvd_dollars_binance?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    -20685083669.99552
  ],
  [
    1790812800000,
    -20786831804.51452
  ],
  [
    1790899200000,
    -20610439915.43452
  ]
]
Definition (from the chart description)

Value: Binance — Bitcoin Cumulative Volume Delta (CVD): Cumulative sum of net buying and selling pressure in Bitcoin markets, calculated in USD by aggregating the difference between market buy and sell volume across major exchanges.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Metric

Bybitbitcoin_cvd_dollars_bybit

Data used by the Bitcoin CVD chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/cvd-dollars/bitcoin_cvd_dollars_bybit?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    -8941455413.61092
  ],
  [
    1790812800000,
    -8837902755.991919
  ],
  [
    1790899200000,
    -8898573271.12092
  ]
]
Definition (from the chart description)

Value: Bybit — Bitcoin Cumulative Volume Delta (CVD): Cumulative sum of net buying and selling pressure in Bitcoin markets, calculated in USD by aggregating the difference between market buy and sell volume across major exchanges.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Metric

Deribitbitcoin_cvd_dollars_deribit

Data used by the Bitcoin CVD chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/cvd-dollars/bitcoin_cvd_dollars_deribit?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    -1202027557.574999
  ],
  [
    1790812800000,
    -1192552815.1599991
  ],
  [
    1790899200000,
    -1132754543.903999
  ]
]
Definition (from the chart description)

Value: Deribit — Bitcoin Cumulative Volume Delta (CVD): Cumulative sum of net buying and selling pressure in Bitcoin markets, calculated in USD by aggregating the difference between market buy and sell volume across major exchanges.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Metric

Hyperliquidbitcoin_cvd_dollars_hyperliquid

Data used by the Bitcoin CVD chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/cvd-dollars/bitcoin_cvd_dollars_hyperliquid?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    -10064647880.86098
  ],
  [
    1790812800000,
    -10079081906.14298
  ],
  [
    1790899200000,
    -10030644009.89498
  ]
]
Definition (from the chart description)

Value: Hyperliquid — Bitcoin Cumulative Volume Delta (CVD): Cumulative sum of net buying and selling pressure in Bitcoin markets, calculated in USD by aggregating the difference between market buy and sell volume across major exchanges.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Metric

OKXbitcoin_cvd_dollars_okx

Data used by the Bitcoin CVD chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/cvd-dollars/bitcoin_cvd_dollars_okx?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    -3065158315.130076
  ],
  [
    1790812800000,
    -3068283470.212077
  ],
  [
    1790899200000,
    -2986379579.236073
  ]
]
Definition (from the chart description)

Value: OKX — Bitcoin Cumulative Volume Delta (CVD): Cumulative sum of net buying and selling pressure in Bitcoin markets, calculated in USD by aggregating the difference between market buy and sell volume across major exchanges.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily