> ## 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.

# Get a count of unique token holders over time

> Fetches an object containing each vault's unique cumulative holders over time.



## OpenAPI

````yaml /v0.1.0/api-reference/openapi.yml get /v1/vaults/holders
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/holders:
    get:
      tags:
        - Vaults
      summary: Get a count of unique token holders over time
      description: >-
        Fetches an object containing each vault's unique cumulative holders over
        time.
      parameters:
        - name: vault_address
          in: query
          required: false
          description: The address of the vault. Optional.
          schema:
            type: string
            example: '0x9Ed15383940CC380fAEF0a75edacE507cC775f22'
        - name: time_start
          in: query
          required: false
          description: Return results starting from this timestamp. Optional.
          schema:
            type: integer
            example: 1732679943
        - name: time_end
          in: query
          required: false
          description: Return results before this timestamp. Optional.
          schema:
            type: integer
            example: 173868000
        - name: latest
          in: query
          required: false
          description: >-
            Indicate if the results should show the most recent snapshot of
            holders count. Defaults to false. Optional.
          schema:
            type: boolean
            example: false
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HolderTimestamp'
        '400':
          description: Invalid request.
        '500':
          description: Internal server error.
components:
  schemas:
    HolderTimestamp:
      type: object
      properties:
        id:
          type: integer
          description: ID of the blockchain.
          example: 1
        vault:
          type: string
          description: Ethereum address of the vault.
          pattern: ^0x[a-fA-F0-9]{40}$
          example: '0x19e099b7aed41fa52718d780dda74678113c0b32'
        timestamp:
          type: integer
          description: Unix timestamp when the transaction occurred.
          example: 1733053355
        total_count:
          type: integer
          description: Total number of unique holders at this timestamp, cumulative.
          example: 888

````