---
title: "Get vault timeseries data"
method: GET
path: "/v1/vaults/{vault_id}/timeseries"
tags: ["Vaults"]
---

# Get vault timeseries data

`GET /v1/vaults/{vault_id}/timeseries`

Returns historical metric data points. Default order is `asc` (oldest first, chart-friendly); pass `?order=desc` for newest-first list views. Supports date range filtering and cursor pagination — pass `meta.next_cursor` back as `?next=` for the next page (cursor is bound to the order it was created with). Defaults to `granularity=day` (one UTC-midnight snapshot per day); `week` returns Monday 00:00 UTC snapshots, `month` returns first-of-month 00:00 UTC snapshots, and `hour` returns the raw hourly cadence. Default page size is 1000.

## Path parameters

- `vault_id` string, required

## Query parameters

- `start` string
- `end` string
- `next` string
- `limit` integer
- `order` string
- `granularity` string

## Response `200`

Timeseries data points

- VaultTimeseriesResponse
  - `data` VaultTimeseriesPoint[], required
    - `apy_30d` number, double, nullable
    - `apy_7d` number, double, nullable
    - `apy_90d` number, double, nullable
    - `timestamp` string, date-time, required
    - `total_supply` string, required
    - `tvl` AmountPair, required — Decimal-string metric paired across native (numeraire-token) and USD. `native` is always present; `usd` is JSON null when pricing is unavailable.
      - `native` string, required
      - `usd` string, nullable
    - `unit_price` string, required
  - `meta` TimeseriesMeta, required
    - `count` integer, required — Number of points in this response.
    - `end` string, date-time, nullable
    - `limit` integer, required — Page-size cap actually applied.
    - `next_cursor` string, nullable — Set when more pages exist; pass back as `?next=`.
    - `refreshed_at` string, date-time, required
    - `request_id` string, required
    - `start` string, date-time, nullable — Window bounds the response covers (echoes the request when set).

## Other responses

- `401` — Missing or invalid auth
- `404` — Vault not found
- `422` — Invalid parameters

---

[API](https://skmtc.net/gauntlet/apis/gauntlet-api.md) · [All operations](https://skmtc.net/gauntlet/apis/gauntlet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gauntlet/gauntlet-api/revisions/bd6a0a40d4fc/schema)