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

# Get event holders history

> Retrieve historical unique holder counts for an event over a time range.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/holders/events/{event_slug}/history
openapi: 3.1.0
info:
  title: Polymarket API
  description: >-
    RESTful API for querying Polymarket prediction markets data including
    events, markets, traders, holders, and real-time metrics
  license:
    name: ''
  version: 1.0.0
servers:
  - url: https://api.struct.to/v1
security: []
paths:
  /polymarket/holders/events/{event_slug}/history:
    get:
      tags:
        - Holders
      summary: Get event holders history
      description: Retrieve historical unique holder counts for an event over a time range.
      operationId: get_event_holders_history
      parameters:
        - name: event_slug
          in: path
          description: Event slug
          required: true
          schema:
            type: string
        - name: from
          in: query
          description: Start timestamp (Unix seconds). If omitted, derived from `hours`.
          required: false
          schema:
            type: integer
            format: int64
        - name: to
          in: query
          description: End timestamp (Unix seconds). Defaults to now.
          required: false
          schema:
            type: integer
            format: int64
        - name: count_back
          in: query
          description: 'Number of candles to return (default: 500, max: 2500)'
          required: false
          schema:
            type: integer
            format: int32
        - name: hours
          in: query
          description: >-
            Fallback time range in hours when `from`/`to` are not provided
            (default: 24, max: 336 = 14 days)
          required: false
          schema:
            type: number
            format: double
        - name: pagination_key
          in: query
          description: Cursor-based pagination key from previous response
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Event holder count history.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HolderCountHistoryCandle'
        '404':
          description: Event not found
components:
  schemas:
    HolderCountHistoryCandle:
      type: object
      description: Holder count at a point in a history series.
      required:
        - t
      properties:
        t:
          type: integer
          format: int64
          description: Bucket timestamp as Unix seconds.
        h:
          type:
            - integer
            - 'null'
          format: int64
          description: Holder count at the end of the bucket.
        block:
          type:
            - integer
            - 'null'
          format: int64
          description: Latest block represented by this bucket.

````