> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rhaios.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/yield/history

> Get historical APY data for a vault.

# GET /v1/yield/history

<Note>**Free** — No payment required.</Note>

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

<ParamField query="vaultId" type="string" required>
  Vault ID from yield discovery or prepare
</ParamField>

<ParamField query="period" type="enum" optional>
  Time period for history

  Allowed values: `1h`, `24h`, `7d`, `30d`, `90d`

  Default: `"7d"`
</ParamField>

<ParamField query="resolution" type="enum" optional>
  Data resolution (defaults based on period)

  Allowed values: `hourly`, `daily`
</ParamField>

## Example

```bash theme={null}
curl "https://api.staging.rhaios.com/v1/yield/history?vaultId=42&period=30d&resolution=daily"
```

## Response

```json theme={null}
{
  "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.