---
title: "Savings ratio and APY (time series)"
method: GET
path: "/savings/series"
tags: ["savings"]
---

# Savings ratio and APY (time series)

`GET /savings/series`

Returns **`savings_snapshots`** for the **rolling** window ending at request time. Each point: **`savingsRatio`** = `total_assets / total_supply`, **`apy7d`** / **`apy30d`** as stored on insert. Sampling and cache TTL match **`GET /tvl`** (`window`: **`1d`** all rows; **`7d`** last per **UTC hour**; **`1m` / `3m` / `1y`** last per **UTC day**; **`all`** last per **UTC month**; cache **`1d`** **5 min**, else **1 h**).

## Query parameters

- `window` '1d' | '7d' | '1m' | '3m' | '1y' | 'all', required

## Response `default`

- SavingsSeriesResponseDto
  - `window` '1d' | '7d' | '1m' | '3m' | '1y' | 'all', required
  - `range` SavingsSeriesRangeDto, required
    - `from` string, date-time — Lower bound of the requested window (omitted when `window` is `all`).
    - `to` string, date-time, required
  - `points` SavingsSeriesPointDto[], required — Same sampling rules as **`GET /tvl`**: **`1d`** — every snapshot; **`7d`** — last per **UTC hour**; **`1m` / `3m` / `1y`** — last per **UTC day**; **`all`** — last per **UTC month**. Each row is from **`savings_snapshots`** (`apy7d` / `apy30d` as stored when the cron inserted the row).
    - `t` string, date-time, required — Snapshot time (UTC)
    - `ratio` string, required — Savings ratio at this snapshot: `total_assets / total_supply` (on-chain wei values as `numeric`), as decimal text.
    - `apy7d` object — APY computed at snapshot time from the newest snapshot **at least 7 days** older, annualized by that snapshot’s actual age. Omitted when null in storage.
    - `apy30d` object — APY computed at snapshot time from the newest snapshot **at least 30 days** older, annualized by that snapshot’s actual age. Omitted when null in storage.

---

[API](https://skmtc.dev/dre/apis/dre-api.md) · [All operations](https://skmtc.dev/dre/apis/dre-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dre/dre-api/revisions/5d14beb9482b/schema)