Discovery

Get historical TVL snapshots for a yield

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.

get/v1/yields/{yieldId}/tvl/history

Request

Base URL: https://api.yield.xyz
URL: https://api.yield.xyz/v1/yields/{yieldId}/tvl/history
Auth: API key in header x-api-key

Path parameters

yieldIdstring required

Example:ethereum-usdc-aave-v3-lending

The unique identifier of the yield

Query parameters

offsetnumber

Pagination offset

limitnumber

Example:20

Maximum number of data points to return (default 100, max 365)

fromstring

Example:2025-01-01T00:00:00Z

Start of time range (ISO 8601). Overrides period when provided.

tostring

Example:2025-07-10T00:00:00Z

End of time range (ISO 8601). Defaults to now.

period'1d' | '7d' | '30d' | '90d' | '1y' | 'all'

Predefined time window. Ignored when from/to are provided. Default: 30d.

interval'day' | 'week' | 'month'

Sampling resolution (day/week/month). Default: day.

feeConfigurationIdstring

Example:66f299cd-aaaa-bbbb-cccc-d1f26e3a02db

Fee configuration ID used to resolve partner allocator vault TVL history. Omit for underlying yield TVL history.

Response

Returns a time series of TVL snapshots in token units

totalnumber required

Total number of items available

offsetnumber required

Offset of the current page

limitnumber required

Limit of the current page

yieldIdstring required

Unique identifier of the yield

interval'day' | 'week' | 'month' required

Sampling interval used for this response

fromstring required

Start of the returned date range (ISO 8601)

tostring required

End of the returned date range (ISO 8601)

Example response

{
  "total": 100,
  "limit": 20,
  "yieldId": "ethereum-usdc-aave-v3",
  "interval": "day",
  "from": "2025-06-12T00:00:00.000Z",
  "to": "2025-07-12T00:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.