Get TVL history

Get a time series of a yield’s total value locked, in underlying token units.

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

Get historical TVL snapshots for a yield

cURL

curl --request GET \
  --url https://api.yield.xyz/v1/yields/{yieldId}/tvl/history \
  --header 'x-api-key: <api-key>'

200

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

Window, interval and pagination work as in reward rate history: period (default 30d) or from/to, interval of day, week or month (period=all with day returns weekly points), and limit up to 365 (default 100).

Each point carries tvl in human-readable token units and tvlRaw in the smallest unit. feeConfigurationId selects a partner allocator vault: pass a fee configuration ID to get that vault’s TVL history, and omit it for the underlying yield’s TVL. See Data.

Authorizations

x-api-key · string · header · required

Path Parameters

yieldId · string · required

The unique identifier of the yield

Example:

"ethereum-usdc-aave-v3-lending"

Query Parameters

offset · number · default: 0

Pagination offset

Required range: x >= 0

Example:

0

limit · number · default: 100

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

Required range: 1 <= x <= 365

Example:

20

from · string

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

Example:

"2025-01-01T00:00:00Z"

to · string

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

Example:

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

period · enum<string>

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

Available options: 1d, 7d, 30d, 90d, 1y, all

interval · enum<string>

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

Available options: day, week, month

feeConfigurationId · string

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

Example:

"66f299cd-aaaa-bbbb-cccc-d1f26e3a02db"

Response

200

application/json

Returns a time series of TVL snapshots in token units

total · number · required

Total number of items available

Example:

100

offset · number · required

Offset of the current page

Example:

0

limit · number · required

Limit of the current page

Example:

20

yieldId · string · required

Unique identifier of the yield

Example:

"ethereum-usdc-aave-v3"

interval · enum<string> · required

Sampling interval used for this response

Available options: day, week, month

Example:

"day"

from · string · required

Start of the returned date range (ISO 8601)

Example:

"2025-06-12T00:00:00.000Z"

to · string · required

End of the returned date range (ISO 8601)

Example:

"2025-07-12T00:00:00.000Z"