---
title: "Get Heatmap Data"
method: GET
path: "/v1/heatmap/{heatmap_id}"
tags: ["Heatmap"]
---

# Get Heatmap Data

`GET /v1/heatmap/{heatmap_id}`

## Request

- Base URL: `https://api.blocklens.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.blocklens.co/v1/heatmap/{heatmap_id}`
- Auth: HTTP bearer

Returns 2D heatmap matrix data. Currently supports: cost-basis-distribution.

## Path parameters

- `heatmap_id` string, required: Heatmap identifier (e.g., 'cost-basis-distribution')

## Query parameters

- `start` string, nullable: Start date (YYYY-MM-DD)
- `end` string, nullable: End date (YYYY-MM-DD)
- `period` string, nullable: Period for optimized bins: all, 10y, 5y, 3y, 1y, 6m, 3m, 1m, 1w
- `resolution` string, nullable: Resolution: 1d

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api.md) · [All operations](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api/revisions/dacc02ae0f9a?raw)