# mcp.yield.xyz – Historical APY / Reward Rate History

> mcp.yield.xyz – Historical APY / Reward Rate History is a paid API for AI agents from mcp.yield.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns the historical APY and reward rate for a specific yield over a given time window and interval, enabling trend plotting and average yield computation.

## Facts

- Endpoint: POST https://mcp.yield.xyz/x402/yields_get_reward_rate_history
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mcp-yield-xyz-historical-apy-reward-rate-history-b7b3f6d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w7H8kwXDQRtpJ43ddwAMU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mcp-yield-xyz-historical-apy-reward-rate-history-b7b3f6d8 -d '<json body>'
```

Example prompt: Show me the daily APY history for yield ID 'eth-lido-steth' over the past 30 days — pull up to 365 data points so I can plot how the reward rate has trended.

## When to prefer this

Use this endpoint when you need historical APY or reward rate data for a specific yield over time — for trend analysis, charting, or computing average yields. Prefer it over current-yield endpoints when the user needs past performance rather than live rates, and over TVL history when the focus is yield/APY rather than liquidity size.

## Known failure modes

- Invalid or unknown yieldId returns a 404 or empty result
- Date range with no available data returns an empty array
- limit exceeds maximum of 365 — validation error returned
- Invalid period or interval enum value causes a 400 bad request
- Malformed ISO date strings for from/to fields cause parse errors
- Payment failure or insufficient USDC balance blocks the request

## How this service works

Historical APY / reward-rate for a yield over time — plot APY trends or compute average yield across 1d/7d/30d/90d/1y windows.

## Output

A time-series of APY / reward-rate data points for the specified yield, bucketed by the chosen interval (day/week/month), covering the requested period or date range, with pagination support via limit and offset.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "description": "ISO date upper bound"
  },
  "from": {
   "type": "string",
   "description": "ISO date lower bound"
  },
  "limit": {
   "type": "integer",
   "maximum": 365,
   "minimum": 1
  },
  "offset": {
   "type": "integer",
   "minimum": 0
  },
  "period": {
   "enum": [
    "1d",
    "7d",
    "30d",
    "90d",
    "1y",
    "all"
   ],
   "type": "string"
  },
  "yieldId": {
   "type": "string",
   "description": "Yield ID from yields_get_all"
  },
  "interval": {
   "enum": [
    "day",
    "week",
    "month"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "timestamp": "2026-06-01T00:00:00.000Z",
    "rewardRate": "0.031"
   }
  ],
  "yieldId": "ethereum-eth-lido-staking",
  "interval": "day"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mcp-yield-xyz-historical-apy-reward-rate-history-b7b3f6d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.yield.xyz](https://www.zero.xyz/host/mcp.yield.xyz/llms.txt)