Sign in
latestOpenAPI 3.0.02026-08-138371125.7 KB

707a88e0b355

tvs

Get Total Value Staked Of Obol for a 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.

get/tvs/{network}

Path parameters

networkstring required
Example:mainnet

Network name (e.g., mainnet, hoodi)

Query parameters

limitinteger

Number of results per page (only applies when details=true).

pageinteger

Page number (only applies when details=true)

detailsstring

If true, returns detailed validator-level data

timestampstring
Example:2025-10-02

ISO 8601 timestamp or date (YYYY-MM-DD). If date-only format is used, returns data for that day regardless of exact time. If not provided, returns the latest available data.

Response

TVS data retrieved successfully

OR

Example response

{
  "total_balance_eth": 12346,
  "total_balance_usd": 45678901,
  "timestamp": "2025-10-02T00:00:00.000Z",
  "network": "mainnet",
  "total_unclaimed_balance_eth_denominated": 67.45,
  "total_claimed_balance_eth_denominated": 71.23,
  "total_eth_transferred": 4.56,
  "total_revenue": 142.89,
  "total_fees_eth_denominated": 504.12
}