Bitcoin Volatility Index

Measure of Bitcoin’s price fluctuation on a specific day, relative to its price

View in Newhedge External link

How to call

Request format

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

api_token (required) — 24 character token.

resolution (optional) — 1d (default), 12h, 4h, 1h, 30m, 10m, coarsest to finest. Finer buckets are served to Advanced and Enterprise accounts, and only for the metrics that ingest them (listed per metric below); 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.

3 metrics
Metric

Bitcoin Price 1 Week Volatilityprice_1w_volatility

Data used by the Bitcoin Volatility Index chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/volatility-index/price_1w_volatility?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    2.7707446
  ],
  [
    1790812800000,
    2.2164179
  ],
  [
    1790899200000,
    3.0425789
  ]
]
Definition (from the chart description)

Value: Bitcoin Price 1 Week Volatility — Bitcoin Volatility Index: Measure of Bitcoin’s price fluctuation on a specific day, relative to its price.

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

Bitcoin Price 1 Month Volatilityprice_1m_volatility

Data used by the Bitcoin Volatility Index chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/volatility-index/price_1m_volatility?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    11.1174755
  ],
  [
    1790812800000,
    11.051489
  ],
  [
    1790899200000,
    11.12341
  ]
]
Definition (from the chart description)

Value: Bitcoin Price 1 Month Volatility — Bitcoin Volatility Index: Measure of Bitcoin’s price fluctuation on a specific day, relative to its price.

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

Bitcoin Price 1 Year Volatilityprice_1y_volatility

Data used by the Bitcoin Volatility Index chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/volatility-index/price_1y_volatility?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    43.596885
  ],
  [
    1790812800000,
    43.53329
  ],
  [
    1790899200000,
    43.501532
  ]
]
Definition (from the chart description)

Value: Bitcoin Price 1 Year Volatility — Bitcoin Volatility Index: Measure of Bitcoin’s price fluctuation on a specific day, relative to its price.

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily