---
title: "Get live aggregate TVL"
method: GET
path: "/v1/tvl"
tags: ["TVL"]
---

# Get live aggregate TVL

`GET /v1/tvl`

Returns live aggregate Gauntlet TVL composed from indexed Gaia vault data and configured external TVL sources. Source totals are always returned; pass `?include_breakdown=true` for chain and external-source explainability rows.

## Query parameters

- `include_breakdown` boolean
- `include_sources` boolean

## Response `200`

Live aggregate TVL

- TvlResponse
  - `data` TvlSummary, required
    - `breakdown` TvlBreakdown[], nullable
      - `id` string, required
      - `label` string, required
      - `source_id` string, required
      - `tvl` TvlAmount, required
        - `usd` string, required
      - `updated_at` string, date-time, required
    - `totals` TvlTotal[], required
      - `id` string, required
      - `label` string, required
      - `tvl` TvlAmount, required
        - `usd` string, required
      - `updated_at` string, date-time, required
    - `tvl` TvlAmount, required
      - `usd` string, required
    - `updated_at` string, date-time, required
  - `meta` BasicMeta, required
    - `refreshed_at` string, date-time, required
    - `request_id` string, required

## Other responses

- `401` — Missing or invalid auth
- `503` — Data source unavailable

---

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