---
title: "Get Total Value Staked Of Obol for a network"
method: GET
path: "/tvs/{network}"
tags: ["tvs"]
---

# Get Total Value Staked Of Obol for a network

`GET /tvs/{network}`

Returns either summary (total balance) or detailed (validator-level) TVS data for a specific timestamp. All returned data (balances, counts, totals) corresponds to the timestamp shown in the response. Each network has one data snapshot per day.

## Path parameters

- `network` string, required

## Query parameters

- `limit` integer
- `page` integer
- `details` string
- `timestamp` string

## Response `200`

TVS data retrieved successfully

- union
  - TVSSummaryResponse
    - `total_balance_eth` number, required — Total balance in ETH across all clusters at the specified timestamp (rounded to nearest integer)
    - `total_balance_usd` number, required — Total balance in USD across all clusters at the specified timestamp (calculated using ETH closing price for that day, rounded to nearest integer)
    - `timestamp` string, required — Timestamp of the data snapshot. All data in this response is for this specific timestamp.
    - `network` string, required — Network name
    - `total_unclaimed_balance_eth_denominated` number — Total unclaimed balance in ETH (from daily fees/revenue data for the snapshot date, rounded to 2 decimal places)
    - `total_claimed_balance_eth_denominated` number — Total claimed balance in ETH (from daily fees/revenue data for the snapshot date, rounded to 2 decimal places)
    - `total_eth_transferred` number — Total ETH transferred (from daily fees/revenue data for the snapshot date, rounded to 2 decimal places)
    - `total_revenue` number — Total revenue (from daily fees/revenue data for the snapshot date, rounded to 2 decimal places)
    - `total_fees_eth_denominated` number — Total fees in ETH (from daily fees/revenue data for the snapshot date, rounded to 2 decimal places)
  - TVSDetailedResponse
    - `timestamp` string, required — Timestamp of the data snapshot. All data in this response (balances, counts) is for this specific timestamp.
    - `network` string, required — Network name
    - `balances` ValidatorBalance[], required — Array of validator balances at the snapshot timestamp
      - `public_key` string, required — Validator public key
      - `balance_eth` number, required — Balance in ETH at the snapshot timestamp
    - `total_count` number, required — Total number of validators at the snapshot timestamp (used for pagination)
    - `total_pages` number, required — Total number of pages based on the limit parameter and total_count at the snapshot timestamp

## Other responses

- `400` — Invalid parameters
- `404` — No data found for the specified network/timestamp
- `500` — An unknown error occurred

---

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