Bitcoin HODL Waves

Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins

View in Newhedge External link

How to call

Request format

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

13 metrics
Metric

HODL Waves 10yhw_age_10y

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    17.79375622445322
  ],
  [
    1790812800000,
    17.79582195434342
  ],
  [
    1790899200000,
    17.80933603170033
  ]
]
Definition (from the chart description)

Value: HODL Waves 10y — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 7y to 10yhw_age_7y_10y

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    8.378697057883382
  ],
  [
    1790812800000,
    8.375169558482316
  ],
  [
    1790899200000,
    8.360124927592647
  ]
]
Definition (from the chart description)

Value: HODL Waves 7y to 10y — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 5y to 7yhw_age_5y_7y

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    7.413864673770654
  ],
  [
    1790812800000,
    7.412650717637952
  ],
  [
    1790899200000,
    7.411981499474482
  ]
]
Definition (from the chart description)

Value: HODL Waves 5y to 7y — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 4y to 5yhw_age_4y_5y

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    4.025444168547303
  ],
  [
    1790812800000,
    4.01533261295301
  ],
  [
    1790899200000,
    4.01048013532634
  ]
]
Definition (from the chart description)

Value: HODL Waves 4y to 5y — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 3y to 4yhw_age_3y_4y

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    4.90687613963177
  ],
  [
    1790812800000,
    4.909532404741789
  ],
  [
    1790899200000,
    4.910476634841281
  ]
]
Definition (from the chart description)

Value: HODL Waves 3y to 4y — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 2y to 3yhw_age_2y_3y

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    5.975210413739056
  ],
  [
    1790812800000,
    5.970387669851192
  ],
  [
    1790899200000,
    5.968839598181873
  ]
]
Definition (from the chart description)

Value: HODL Waves 2y to 3y — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 1y to 2yhw_age_1y_2y

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    14.75361839077315
  ],
  [
    1790812800000,
    14.77112361081696
  ],
  [
    1790899200000,
    14.76336403929068
  ]
]
Definition (from the chart description)

Value: HODL Waves 1y to 2y — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 6m to 1yhw_age_6m_1y

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    17.22807815635732
  ],
  [
    1790812800000,
    17.18733446503821
  ],
  [
    1790899200000,
    17.17590995515185
  ]
]
Definition (from the chart description)

Value: HODL Waves 6m to 1y — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 3m to 6mhw_age_3m_6m

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    5.554351184996051
  ],
  [
    1790812800000,
    5.551551390391467
  ],
  [
    1790899200000,
    5.527309336698735
  ]
]
Definition (from the chart description)

Value: HODL Waves 3m to 6m — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 1m to 3mhw_age_1m_3m

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    7.186649326358662
  ],
  [
    1790812800000,
    7.383272480971385
  ],
  [
    1790899200000,
    7.338174992980839
  ]
]
Definition (from the chart description)

Value: HODL Waves 1m to 3m — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 1w to 1mhw_age_1w_1m

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    3.765776524212626
  ],
  [
    1790812800000,
    3.615664862008003
  ],
  [
    1790899200000,
    3.771079320053701
  ]
]
Definition (from the chart description)

Value: HODL Waves 1w to 1m — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

HODL Waves 1d to 1whw_age_1d_1w

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    2.114698540368806
  ],
  [
    1790812800000,
    2.193303305437681
  ],
  [
    1790899200000,
    1.789896809037771
  ]
]
Definition (from the chart description)

Value: HODL Waves 1d to 1w — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily

Metric

0d to 1dhw_age_0d_1d

Data used by the Bitcoin HODL Waves chart.

Resolutions: 1d only.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1790726400000,
    0.9029791989079996
  ],
  [
    1790812800000,
    0.8188549673266152
  ],
  [
    1790899200000,
    1.163026719669475
  ]
]
Definition (from the chart description)

Value: 0d to 1d — Bitcoin HODL Waves: Age distribution of unspent transaction outputs (UTXOs), showing the holding duration of bitcoins.

Units: percent

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

Calendar: calendar_daily