Bitcoin HODL Waves Supply

Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins

View in Newhedge External link

How to call

Request format

GET 
curl -X GET "https://newhedge.io/api/v2/metrics/hodl-waves-supply/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.

14 metrics
Metric

HODL Waves 0d to 1d Supplyhw_age_supply_0d_1d

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_0d_1d?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    181240.933770299
  ],
  [
    1790812800000,
    164342.3966440484
  ],
  [
    1790899200000,
    233499.0581473298
  ]
]
Definition (from the chart description)

Value: HODL Waves 0d to 1d Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 1d to 1w Supplyhw_age_supply_1d_1w

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_1d_1w?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    424879.6135629006
  ],
  [
    1790812800000,
    440681.9957056828
  ],
  [
    1790899200000,
    359636.8062527217
  ]
]
Definition (from the chart description)

Value: HODL Waves 1d to 1w Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 1w to 1m Supplyhw_age_supply_1w_1m

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_1w_1m?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    756609.8164009079
  ],
  [
    1790812800000,
    726465.1465405189
  ],
  [
    1790899200000,
    757707.8834611103
  ]
]
Definition (from the chart description)

Value: HODL Waves 1w to 1m Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 1m to 3m Supplyhw_age_supply_1m_3m

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_1m_3m?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    1443922.49311471
  ],
  [
    1790812800000,
    1483458.87396729
  ],
  [
    1790899200000,
    1474430.148639668
  ]
]
Definition (from the chart description)

Value: HODL Waves 1m to 3m Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 3m to 6m Supplyhw_age_supply_3m_6m

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_3m_6m?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    1115965.486344071
  ],
  [
    1790812800000,
    1115426.553142481
  ],
  [
    1790899200000,
    1110580.155785531
  ]
]
Definition (from the chart description)

Value: HODL Waves 3m to 6m Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 6m to 1y Supplyhw_age_supply_6m_1y

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_6m_1y?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    3461419.701092711
  ],
  [
    1790812800000,
    3453306.633029779
  ],
  [
    1790899200000,
    3451086.883648841
  ]
]
Definition (from the chart description)

Value: HODL Waves 6m to 1y Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 1y to 2y Supplyhw_age_supply_1y_2y

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_1y_2y?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    2964257.81777529
  ],
  [
    1790812800000,
    2967837.6973636
  ],
  [
    1790899200000,
    2966343.682958519
  ]
]
Definition (from the chart description)

Value: HODL Waves 1y to 2y Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 2y to 3y Supplyhw_age_supply_2y_3y

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_2y_3y?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    1200523.404675789
  ],
  [
    1790812800000,
    1199579.805931849
  ],
  [
    1790899200000,
    1199295.065104291
  ]
]
Definition (from the chart description)

Value: HODL Waves 2y to 3y Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 3y to 4y Supplyhw_age_supply_3y_4y

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_3y_4y?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    985876.5200850703
  ],
  [
    1790812800000,
    986431.0753279906
  ],
  [
    1790899200000,
    986642.4283321192
  ]
]
Definition (from the chart description)

Value: HODL Waves 3y to 4y Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 4y to 5y Supplyhw_age_supply_4y_5y

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_4y_5y?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    808781.5497584501
  ],
  [
    1790812800000,
    806767.0280308705
  ],
  [
    1790899200000,
    805809.7316705799
  ]
]
Definition (from the chart description)

Value: HODL Waves 4y to 5y Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 5y to 7y Supplyhw_age_supply_5y_7y

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_5y_7y?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    1489573.99717596
  ],
  [
    1790812800000,
    1489361.596099899
  ],
  [
    1790899200000,
    1489259.79476341
  ]
]
Definition (from the chart description)

Value: HODL Waves 5y to 7y Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 7y to 10y Supplyhw_age_supply_7y_10y

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_7y_10y?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    1683425.55695587
  ],
  [
    1790812800000,
    1682752.41561675
  ],
  [
    1790899200000,
    1679766.46120148
  ]
]
Definition (from the chart description)

Value: HODL Waves 7y to 10y Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

HODL Waves 10y Supplyhw_age_supply_10y

Data used by the Bitcoin HODL Waves Supply chart.

Resolutions: 1d only.

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/hw_age_supply_10y?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    3575074.23595217
  ],
  [
    1790812800000,
    3575564.90915792
  ],
  [
    1790899200000,
    3578358.65150542
  ]
]
Definition (from the chart description)

Value: HODL Waves 10y Supply — Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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

Calendar: calendar_daily

Metric

Circulating Supplytotal_circulating_bitcoin

Data used by the Bitcoin HODL Waves Supply chart.

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

Endpoint 
https://newhedge.io/api/v2/metrics/hodl-waves-supply/total_circulating_bitcoin?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    20091734.375
  ],
  [
    1790812800000,
    20092159.375
  ],
  [
    1790899200000,
    20092600.0
  ]
]
Definition (from the chart description)

Value: Bitcoin HODL Waves Supply: Visual representation of Bitcoin’s circulating supply segmented by the age of unspent coins.

Units: btc

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