Skip to main content

​
yield_history

Free — No payment required.
Get historical APY data for a vault. Returns time-series data showing APY and TVL over the specified period. Useful for analyzing vault performance and yield consistency.

​
Parameters

​
vaultId
string
required
Vault ID from yield_prepare
​
period
enum
Time period for historyAllowed values: 1h, 24h, 7d, 30d, 90dDefault: "7d"
​
resolution
enum
Data resolution (defaults based on period)Allowed values: hourly, daily

​
Response

{
  "vaultId": "42",
  "period": "30d",
  "resolution": "daily",
  "data": [
    { "timestamp": "2026-01-25T00:00:00Z", "apy": 0.148, "tvl": 42000000 },
    { "timestamp": "2026-01-26T00:00:00Z", "apy": 0.155, "tvl": 43200000 },
    { "timestamp": "2026-01-27T00:00:00Z", "apy": 0.162, "tvl": 45000000 }
  ],
  "summary": {
    "avgApy": 0.1148,
    "maxApy": 0.1572,
    "minApy": 0.0823,
    "avgTvl": 41500000,
    "dataPoints": 30
  }
}
Each entry in data contains timestamp, apy, and tvl. The summary provides aggregate statistics over the period.