TVS

TVS (Total Value Staked) related endpoints.

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

networkstringRequired

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

Example: mainnet

Query parameters

limitinteger · max: 1000Optional

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

Default: 100

pageintegerOptional

Page number (only applies when details=true)

Default: 0

detailsstringOptional

If true, returns detailed validator-level data

Default: false

timestampanyOptional

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.

Example: 2025-10-02

Responses

200

TVS data retrieved successfully

application/json

Responseone of

400

Invalid parameters

404

No data found for the specified network/timestamp

500

An unknown error occurred

get