Bitcoin Monthly Returns Heatmap

Visualisation of Bitcoin monthly returns from 2010-2026

How to call

Request format

GET

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

Monthly Returns

Data used by the Bitcoin Monthly Returns Heatmap chart.

Endpoint

https://newhedge.io/api/v2/metrics/monthly-returns-heatmap/monthly_returns?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response

200 Successful response

[
  {
    "x": 5,
    "y": 2026,
    "value": -20.39,
    "open_price": 73537.83,
    "close_price": 58545.95
  },
  {
    "x": 6,
    "y": 2026,
    "value": 7.31,
    "open_price": 58545.95,
    "close_price": 62826.2
  },
  {
    "x": 7,
    "y": 2026,
    "value": 2.97,
    "open_price": 62826.2,
    "close_price": 64692.35
  }
]