---
title: "Get historical TVL snapshots for a yield"
method: GET
path: "/v1/yields/{yieldId}/tvl/history"
tags: ["YieldData"]
---

# Get historical TVL snapshots for a yield

`GET /v1/yields/{yieldId}/tvl/history`

Returns a chronological time series of Total Value Locked for the specified yield, expressed in underlying token units. Supports configurable time ranges, sampling intervals (day/week/month), and pagination.

## Path parameters

- `yieldId` string, required

## Query parameters

- `offset` number
- `limit` number
- `from` string
- `to` string
- `period` '1d' | '7d' | '30d' | '90d' | '1y' | 'all'
- `interval` 'day' | 'week' | 'month'
- `feeConfigurationId` string

## Response `200`

Returns a time series of TVL snapshots in token units

- TvlHistoryResponseDto
  - `total` number, required — Total number of items available
  - `offset` number, required — Offset of the current page
  - `limit` number, required — Limit of the current page
  - `yieldId` string, required — Unique identifier of the yield
  - `interval` 'day' | 'week' | 'month', required — Sampling interval used for this response
  - `from` string, required — Start of the returned date range (ISO 8601)
  - `to` string, required — End of the returned date range (ISO 8601)

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `404` — Yield not found with the specified ID
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/yield/apis/yield-xyz-api.md) · [All operations](https://skmtc.net/yield/apis/yield-xyz-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yield/yield-xyz-api/revisions/acfa80015ca5/schema)