---
title: "Cycle Performance Comparison"
method: GET
path: "/v1/cycle-performance"
tags: ["Market Data"]
---

# Cycle Performance Comparison

`GET /v1/cycle-performance`

## 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/cycle-performance`
- Auth: none declared

Compares Bitcoin price performance across historical market cycles. Aligns cycles by a common
event (cycle low, all-time high, or halving) and shows percentage change from the starting price.

Returns data indexed by `day_offset` from the cycle event, with one field per cycle.
Historical cycles that lasted longer than the current one extend beyond today's date.

## Query parameters

- `type` string, required: Cycle type: low, ath, or halving
- `symbol` string: Cryptocurrency symbol
- `days` integer: Number of days to show from cycle start (0 = full range)

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