Discovery

Get historical reward rate snapshots for a yield

Returns a chronological time series of reward rate snapshots for the specified yield, suitable for charting and analytics. Supports configurable time ranges, sampling intervals (day/week/month), and pagination.

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

Request

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

Path parameters

yieldIdstring required
Example:ethereum-eth-lido-staking

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.

Response

Returns a time series of reward rate snapshots

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

Changes

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