---
title: "UTXO Cohort History"
method: GET
path: "/v1/utxo/history"
tags: ["UTXO Analytics"]
---

# UTXO Cohort History

`GET /v1/utxo/history`

## 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/utxo/history`
- Auth: none declared

Provides a detailed breakdown of the UTXO (Unspent Transaction Output) set by age cohort. This allows for deep analysis of coin dormancy and accumulation patterns.

This endpoint is powerful for tracking the behavior of "old hands" and identifying when dormant supply begins to move, which can often precede significant price action.

## Query parameters

- `date_processed` string, date, nullable: Specific processing date
- `cohort_start` string, date, nullable: Start of cohort date range
- `cohort_end` string, date, nullable: End of cohort date range
- `limit` integer: Number of records to return

## Response `200`

Successful Response

- ApiResponse: Standard API response model
  - `success` boolean, required
  - `data` unknown, required
  - `message` string, nullable
  - `count` integer, nullable
  - `timestamp` string, date-time

## 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)