---
title: "Vault totals with historical series"
method: GET
path: "/v3/evk/vaults/{chainId}/{address}/totals"
tags: ["Vaults"]
---

# Vault totals with historical series

`GET /v3/evk/vaults/{chainId}/{address}/totals`

Returns totalAssets, totalBorrows, utilization, and APY from dynamic
snapshots. Raw amount fields are bigint strings; USD fields use the latest
asset price for current and bucket-aligned historical asset prices for
history entries when available. The effective end is `to` or the current
time. When `from` is omitted, the effective window is 7 days for `1h` and
30 days for `1d`. Ranges count both endpoint buckets and support at most
744 hourly buckets or 732 daily buckets.

## Path parameters

- `chainId` integer, required
- `address` string, required

## Query parameters

- `resolution` '1h' | '1d'
- `from` integer
- `to` integer
- `forceFresh` boolean

## Response `200`

Vault totals with current + historical data

- object
  - `data` VaultTotals
    - `current` VaultTotalsPoint
      - `totalAssets` string — Raw underlying asset amount as a bigint string.
      - `totalAssetsUsd` number, nullable — USD value of totalAssets. Uses the latest asset price for current and the bucket-aligned historical asset price for history entries when available.
      - `totalBorrows` string — Raw borrowed asset amount as a bigint string.
      - `totalBorrowsUsd` number, nullable — USD value of totalBorrows. Uses the latest asset price for current and the bucket-aligned historical asset price for history entries when available.
      - `cash` string, nullable — Raw cash amount as a bigint string.
      - `cashUsd` number, nullable — USD value of cash. Uses the latest asset price for current and the bucket-aligned historical asset price for history entries when available.
      - `utilization` number, nullable — Utilization ratio number.
      - `supplyApy` number, nullable — Public supply APY as a percent number.
      - `borrowApy` number, nullable — Public borrow APY as a percent number.
      - `sharePrice` number, nullable — Share price when available; populated for Earn totals.
      - `timestamp` string, date-time
    - `history` VaultTotalsPoint[]
      - `totalAssets` string — Raw underlying asset amount as a bigint string.
      - `totalAssetsUsd` number, nullable — USD value of totalAssets. Uses the latest asset price for current and the bucket-aligned historical asset price for history entries when available.
      - `totalBorrows` string — Raw borrowed asset amount as a bigint string.
      - `totalBorrowsUsd` number, nullable — USD value of totalBorrows. Uses the latest asset price for current and the bucket-aligned historical asset price for history entries when available.
      - `cash` string, nullable — Raw cash amount as a bigint string.
      - `cashUsd` number, nullable — USD value of cash. Uses the latest asset price for current and the bucket-aligned historical asset price for history entries when available.
      - `utilization` number, nullable — Utilization ratio number.
      - `supplyApy` number, nullable — Public supply APY as a percent number.
      - `borrowApy` number, nullable — Public borrow APY as a percent number.
      - `sharePrice` number, nullable — Share price when available; populated for Earn totals.
      - `timestamp` string, date-time
  - `meta` VaultTotalsMeta
    - `chainId` string
    - `vault` string
    - `resolution` '1h' | '1d'
    - `startTimestamp` string, date-time
    - `endTimestamp` string, date-time
    - `timestamp` string, date-time
    - `note` string
  - `freshness` VaultTotalsFreshness
    - `mode` 'fresh' | 'cached'
    - `forceFreshRequested` boolean
    - `refreshTriggered` boolean
    - `refreshCompleted` boolean
    - `timedOut` boolean
    - `rateLimited` boolean
    - `fallbackReason` string, nullable
    - `waitedMs` integer
    - `latestSnapshotTimestamp` string, date-time
    - `ageSeconds` integer

## Other responses

- `400` — Bad request
- `404` — Not found
- `503` — Vault totals history concurrency is at capacity

---

[API](https://skmtc.dev/euler/apis/euler-data-api-v3.md) · [All operations](https://skmtc.dev/euler/apis/euler-data-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/euler/euler-data-api-v3/revisions/2e0e17d09898/schema)