Bitcoin Realized Cap HODL Waves

Age-banded breakdown of realized capitalization by UTXO holding period.

Bitcoin's realized capitalization (sum of all coins valued at the price they last moved), split into the same age bands as Hodl Waves Supply. Each band shows the dollar value of realized cap held by coins that last moved within that age window.

View in Newhedge External link

How to call

Request format

GET 
curl -X GET "https://newhedge.io/api/v2/metrics/realized-cap-hodl-waves/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. A 404 for a metric withdrawn on purpose adds withdrawn, withdrawn_on and reason, for example {"error":"Metric not found","withdrawn":true,"withdrawn_on":"2026-09-07","reason":"The venue's public feed reports insurance-fund settlements, not liquidation orders."}; a removed chart can add successor.

Plan and quota refusals keep these statuses and error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. A Pro token whose history window removed points also gets the X-Newhedge-History-Truncated headers, and for a Pro token X-Newhedge-Available-From is the start of the window. See Errors and plan limits.

Metrics

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

13 metrics
Metric

10y+hw_age_realized_cap_10y

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    441792636.94
  ],
  [
    1792627200000,
    442116069.74
  ],
  [
    1792713600000,
    442912611.36
  ]
]
Definition (from the chart description)

Units: usd

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

7y to 10yhw_age_realized_cap_7y_10y

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    11141814661.92
  ],
  [
    1792627200000,
    11140004222.25
  ],
  [
    1792713600000,
    11139760422.5
  ]
]
Definition (from the chart description)

Units: usd

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

5y to 7yhw_age_realized_cap_5y_7y

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    49362173445.2
  ],
  [
    1792627200000,
    49422050167.56001
  ],
  [
    1792713600000,
    51768174887.76
  ]
]
Definition (from the chart description)

Units: usd

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

4y to 5yhw_age_realized_cap_4y_5y

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    28345561576.97
  ],
  [
    1792627200000,
    28277431406.19
  ],
  [
    1792713600000,
    25728981409.93999
  ]
]
Definition (from the chart description)

Units: usd

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

3y to 4yhw_age_realized_cap_3y_4y

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    22726159279.62
  ],
  [
    1792627200000,
    22740722399.2
  ],
  [
    1792713600000,
    22798407524.33
  ]
]
Definition (from the chart description)

Units: usd

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

2y to 3yhw_age_realized_cap_2y_3y

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    78578672000.52002
  ],
  [
    1792627200000,
    78629531360.31
  ],
  [
    1792713600000,
    78650910224.31001
  ]
]
Definition (from the chart description)

Units: usd

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

1y to 2yhw_age_realized_cap_1y_2y

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    306904439419.34
  ],
  [
    1792627200000,
    306816504445.01
  ],
  [
    1792713600000,
    308535174563.36
  ]
]
Definition (from the chart description)

Units: usd

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

6m to 1yhw_age_realized_cap_6m_1y

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    286415640601.7
  ],
  [
    1792627200000,
    282349346029.79
  ],
  [
    1792713600000,
    279315100685.46
  ]
]
Definition (from the chart description)

Units: usd

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

3m to 6mhw_age_realized_cap_3m_6m

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    77623315595.04004
  ],
  [
    1792627200000,
    71578074076.6499
  ],
  [
    1792713600000,
    72181599297.75
  ]
]
Definition (from the chart description)

Units: usd

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

1m to 3mhw_age_realized_cap_1m_3m

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    100921394609.62
  ],
  [
    1792627200000,
    97413901719.55005
  ],
  [
    1792713600000,
    97645976842.33997
  ]
]
Definition (from the chart description)

Units: usd

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

1w to 1mhw_age_realized_cap_1w_1m

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    80625160147.69006
  ],
  [
    1792627200000,
    78504342745.21997
  ],
  [
    1792713600000,
    79510172746.38
  ]
]
Definition (from the chart description)

Units: usd

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

1d to 1whw_age_realized_cap_1d_1w

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    25127958976.3999
  ],
  [
    1792627200000,
    24949002899.96008
  ],
  [
    1792713600000,
    42667699804.71997
  ]
]
Definition (from the chart description)

Units: usd

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

0d to 1dhw_age_realized_cap_0d_1d

Data used by the Bitcoin Realized Cap HODL Waves chart.

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

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    15708416663.88
  ],
  [
    1792627200000,
    34020437662.79993
  ],
  [
    1792713600000,
    16118365054.06006
  ]
]
Definition (from the chart description)

Units: usd

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