Bitcoin 4Y+ HODL Wave

Percentage of circulating supply held in UTXOs that have not moved for over 4 years

How to call

Request format

GET
curl -X GET "https://newhedge.io/api/v2/metrics/4y-hodl-waves/METRIC_NAME?api_token=YOUR_TOKEN"
Query params

api_token (required) — 24 character token.

resolution (optional) — day1 (default), hour12, hour4, hour1, 30mn, 10mn. Finer buckets are served to Advanced and Enterprise accounts; see Resolutions.

before (optional) — exclusive cursor, returns observations older than this timestamp_ms. Finer resolutions only.

limit (optional) — page size for finer resolutions. Default 2500, maximum 5000. Ignored for day1.

Path params

:metric_name — one of the metric names listed below.

Responses

200 with JSON payload, 401 for missing/invalid token, 404 for missing resources.

Metrics

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

1 metrics
Metric

Utxos Over 4y Old Supply Rel To Circulating Supply

Data used by the 4Y+ HODL Wave chart.

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

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1786752000000,
    37.81866427170411
  ],
  [
    1786838400000,
    37.81769856738126
  ],
  [
    1786924800000,
    37.81877275607106
  ]
]