OBobol
tvs

Get Total Value Staked Of Obol for a network

Changed on

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/v1/tvs/{network}

Request

  • Base URL
    https://api.obol.tech
  • Auth
    none declared

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
}

Changes

  • c545dd14c211Revision changes
    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

  • 6393352e05fdRevision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status