Get reward rate history

Get a time series of a yield’s reward rate snapshots for charting and comparison.

GET /v1/yields/{yieldId}/reward-rate/history

Get historical reward rate snapshots for a yield

cURL

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

200

{
  "total": 100,
  "offset": 0,
  "limit": 20,
  "items": [
    {
      "timestamp": "2025-07-10T00:00:00.000Z",
      "rewardRate": "0.0312"
    }
  ],
  "yieldId": "ethereum-eth-lido-staking",
  "interval": "day",
  "from": "2025-06-01T00:00:00.000Z",
  "to": "2025-07-10T00:00:00.000Z"
}

Choose the window with either period (1d, 7d, 30d, 90d, 1y, all; default 30d) or from and to (ISO 8601). When from or to is set, period is ignored, and to defaults to now. interval sets the sampling resolution: day (default), week or month. period=all with interval=day returns weekly points.

Pagination uses offset and limit (default 100, max 365). This is the yield’s rate over time, not a position’s earnings. For holdings, use balances. See Data.

Authorizations

x-api-key · string · header · required

Path Parameters

yieldId · string · required

The unique identifier of the yield

Example:

"ethereum-eth-lido-staking"

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

Response

200

application/json

Returns a time series of reward rate snapshots

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

items · object[] · required

Reward rate snapshots for the current page

Show child attributes

yieldId · string · required

Unique identifier of the yield

Example:

"ethereum-eth-lido-staking"

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-01T00:00:00.000Z"

to · string · required

End of the returned date range (ISO 8601)

Example:

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