Sign in

v1

latestOpenAPI 3.0.02026-07-2442138225.7 KB
YieldData

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

Path parameters

yieldIdstring required

The unique identifier of the yield

Query parameters

offsetnumber

Pagination offset

limitnumber

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

fromstring

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

tostring

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

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"
}