> ## Documentation Index
> Fetch the complete documentation index at: https://developers.paxoslabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch historic TVL data for a vault

> Returns TVL (Total Value Locked) data for a given vault address over a specified time period.



## OpenAPI

````yaml /v0.1.0/api-reference/openapi.yml get /v1/vaults/historical-tvl
openapi: 3.0.0
info:
  title: Paxos Labs API
  version: 1.0.0
  description: API for managing and querying vault data for Paxos Labs.
servers:
  - url: https://api.paxoslabs.com
security: []
tags: []
paths:
  /v1/vaults/historical-tvl:
    get:
      tags:
        - Vaults
      summary: Fetch historic TVL data for a vault
      description: >-
        Returns TVL (Total Value Locked) data for a given vault address over a
        specified time period.
      parameters:
        - name: vault_address
          in: query
          required: true
          description: The address of the vault.
          schema:
            type: string
            example: '0x19e099B7aEd41FA52718D780dDA74678113C0b32'
        - name: start_timestamp
          in: query
          required: false
          description: >-
            Start timestamp for the data range (in seconds). Defaults to 60 days
            ago if not provided.
          schema:
            type: integer
            example: 1732679943
        - name: end_timestamp
          in: query
          required: false
          description: >-
            End timestamp for the data range (in seconds). Defaults to current
            time if not provided.
          schema:
            type: integer
            example: 173868000
        - name: intervals
          in: query
          required: false
          description: >-
            Time interval between data points in seconds. Defaults to 86400 (1
            day) if not provided.
          schema:
            type: integer
            example: 86400
      responses:
        '200':
          description: Successful response with historic TVL data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  interval:
                    type: integer
                    description: The time interval between data points in seconds.
                    example: 86400
                  base_asset:
                    type: string
                    description: The address of the base asset of the vault.
                    example: 1.0970776880180083e+48
                  base_asset_name:
                    type: string
                    description: The name of the base asset of the vault.
                    example: WETH
                  data:
                    type: array
                    description: List of TVL data points for each time interval.
                    items:
                      type: object
                      properties:
                        time_stamp:
                          type: number
                          description: The timestamp of the TVL data point.
                          example: 1732679943
                        tvl:
                          type: number
                          description: The TVL value in USD for the given timestamp.
                          example: 1500000.5
        '400':
          description: Bad request. Missing or invalid parameters.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message indicating the issue.
                    example: vault_address is required
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message indicating an internal server issue.

````