---
title: "dreUSD and dreUSDs TVL (time series)"
method: GET
path: "/tvl/series"
tags: ["tvl"]
---

# dreUSD and dreUSDs TVL (time series)

`GET /tvl/series`

Returns `total_supplies` for the **rolling** window ending at request time. Each point: **`tvl`** = dreUSD total supply ÷ 1e18, **`dreUsds`** = dreUSDs total supply ÷ 1e18. Sampling: **`1d`** all snapshots; **`7d`** last snapshot per **UTC hour**; **`1m` / `3m` / `1y`** last per **UTC day**; **`all`** last per **UTC month**. In-memory cache: **`1d`** TTL **5 minutes**, every other **`window`** **1 hour**. `1d` = 24h, `7d` = 7d, `1m` = 30d, `3m` = 90d, `1y` = 365d, `all` = no lower bound.

## Query parameters

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

## Response `default`

- DreUsdTotalSupplySeriesResponseDto
  - `window` '1d' | '7d' | '1m' | '3m' | '1y' | 'all', required
  - `range` DreUsdTotalSupplySeriesRangeDto, required
    - `from` string, date-time — Lower bound of the requested window (omitted when `window` is `all`).
    - `to` string, date-time, required
  - `points` DreUsdTotalSupplyPointDto[], required — Granularity depends on `window`: **`1d`** — every snapshot. **`7d`** — last snapshot per **UTC hour**. **`1m` / `3m` / `1y`** — last snapshot per **UTC calendar day**. **`all`** — last snapshot per **UTC calendar month**. Each point includes **`tvl`** (dreUSD ÷ 1e18) and **`dreUsds`** (dreUSDs ÷ 1e18).
    - `t` string, date-time, required — Snapshot time (UTC)
    - `dreUSD` string, required — dreUSD total supply in token units (`dre_usd / 1e18`), as decimal text
    - `dreUSDs` string, required — dreUSDs total supply in token units (`dre_usds / 1e18`), as decimal text

---

[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)