---
title: "Get historical reward rate snapshots for a yield"
method: GET
path: "/v1/yields/{yieldId}/reward-rate/history"
tags: ["YieldData"]
---

# Get historical reward rate snapshots for a yield

`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`
- TypeScript: <https://skmtc.dev/yield/apis/yield-xyz-api/docs/v1/yields/:yieldId/reward-rate/history/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `yieldId` string, required

## Query parameters

- `offset` number
- `limit` number
- `from` string
- `to` string
- `period` '1d' | '7d' | '30d' | '90d' | '1y' | 'all'
- `interval` 'day' | 'week' | 'month'

## Response `200`

Returns a time series of reward rate snapshots

- RewardRateHistoryResponseDto
  - `total` number, required: Total number of items available
  - `offset` number, required: Offset of the current page
  - `limit` number, required: Limit of the current page
  - `items` RewardRateSnapshotDto[], required: Reward rate snapshots for the current page
    - `timestamp` string, required: Timestamp of this snapshot (ISO 8601)
    - `rewardRate` string, required: Reward rate as a decimal string
  - `yieldId` string, required: Unique identifier of the yield
  - `interval` 'day' | 'week' | 'month', required: Sampling interval used for this response
  - `from` string, required: Start of the returned date range (ISO 8601)
  - `to` string, required: End of the returned date range (ISO 8601)

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key
- `404`: Yield not found with the specified ID
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/yield/apis/yield-xyz-api.md) - [All operations](https://skmtc.dev/yield/apis/yield-xyz-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yield/apis/yield-xyz-api/revisions/acfa80015ca5?raw)