---
title: "SOPR Cohort Distribution"
method: POST
path: "/v1/enterprise/sopr"
tags: ["Enterprise"]
---

# SOPR Cohort Distribution

`POST /v1/enterprise/sopr`

## 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/enterprise/sopr`
- Auth: HTTP bearer

Returns SOPR distribution across custom age cohorts. Enterprise only (grade >= 2).

## Request body

- SoprRequest: Request body for enterprise SOPR cohort distribution.
  - `start_date` string, date, required: Start date (YYYY-MM-DD)
  - `end_date` string, date, required: End date (YYYY-MM-DD)
  - `cohorts` SoprCohortDef[], required: Age cohort definitions
    - `name` string, required: Cohort display name
    - `min_days` integer, required: Minimum UTXO age in days (inclusive lower bound)
    - `max_days` integer, nullable: Maximum UTXO age in days (exclusive upper bound). Null = unbounded.
  - `aggregation` string: Time aggregation: daily, weekly, monthly, annual
  - `analysis_mode` string: Analysis mode: cohorts (custom age bands) or sth_lth (logistic weighting)
  - `value_type` string: Volume type: btc or usd

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