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

# Builder analytics timeseries (cumulative)

> Returns cumulative values at the end of each bucket for one builder. Use for running-total charts over time.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/builders/{builder_code}/analytics/timeseries
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/builders/{builder_code}/analytics/timeseries:
    get:
      tags:
        - Builders
      summary: Builder analytics timeseries (cumulative)
      description: >-
        Returns cumulative values at the end of each bucket for one builder. Use
        for running-total charts over time.
      operationId: get_builder_analytics_timeseries
      parameters:
        - name: builder_code
          in: path
          description: Builder code.
          required: true
          schema:
            type: string
        - name: resolution
          in: query
          description: 'Bucket size. Default: 60 (hourly).'
          required: false
          schema:
            $ref: '#/components/schemas/AnalyticsResolution'
        - name: from
          in: query
          description: Start timestamp (unix seconds). Omit for all-time.
          required: false
          schema:
            type: integer
            format: int64
        - name: to
          in: query
          description: End timestamp (unix seconds).
          required: false
          schema:
            type: integer
            format: int64
        - name: count_back
          in: query
          description: Max data points to return (default 500, max 2500).
          required: false
          schema:
            type: integer
            format: int32
        - name: pagination_key
          in: query
          description: Opaque cursor from a previous response.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Cumulative time-bucketed builder stats
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BuilderTimeBucketRow'
components:
  schemas:
    AnalyticsResolution:
      type: string
      description: >-
        Bucket size for `/analytics/timeseries` and `/analytics/deltas`
        responses.

        Each value picks the time interval that one row in the output covers:

        `60` = 1 hour, `240` = 4 hours, `D`/`1D` = 1 day, `W`/`1W` = 7 days,

        `M`/`1M` = calendar month.
      enum:
        - '60'
        - '240'
        - D
        - 1D
        - W
        - 1W
        - M
        - 1M
    BuilderTimeBucketRow:
      type: object
      description: >-
        One time bucket of builder activity. In `timeseries` responses fields
        are

        cumulative values at the end of the bucket; in `deltas` responses they
        are

        the change within the bucket.
      required:
        - t
        - v
        - bv
        - sv
        - ut
        - um
        - uk
        - tc
        - bc
        - sc
        - f
        - bf
        - sh
        - yv
        - nv
        - yc
        - nc
        - bd_u10
        - bd_100
        - bd_1k
        - bd_10k
        - bd_50k
        - bd_50p
        - nu
        - ar
        - av
      properties:
        t:
          type: integer
          format: int32
          description: Bucket start time as Unix seconds.
          minimum: 0
        v:
          type: number
          format: double
          description: Volume in USD.
        bv:
          type: number
          format: double
          description: Buy volume in USD.
        sv:
          type: number
          format: double
          description: Sell volume in USD.
        ut:
          type: integer
          format: int64
          description: Distinct trader addresses.
        um:
          type: integer
          format: int64
          description: Distinct maker addresses (order-resting side).
        uk:
          type: integer
          format: int64
          description: Distinct taker addresses (order-initiator side).
        tc:
          type: integer
          format: int64
          description: Transaction count.
        bc:
          type: integer
          format: int64
          description: Buy count.
        sc:
          type: integer
          format: int64
          description: Sell count.
        f:
          type: number
          format: double
          description: Fees in USD.
        bf:
          type: number
          format: double
          description: Builder's share of `fees_usd` (which is Polymarket's total fee).
        sh:
          type: number
          format: double
          description: Shares volume.
        yv:
          type: number
          format: double
          description: Yes volume in USD.
        nv:
          type: number
          format: double
          description: No volume in USD.
        yc:
          type: integer
          format: int64
          description: Yes count.
        nc:
          type: integer
          format: int64
          description: No count.
        bd_u10:
          type: integer
          format: int64
          description: Buy trade count in the under-10 USD bucket.
        bd_100:
          type: integer
          format: int64
          description: Buy trade count in the 10-100 USD bucket.
        bd_1k:
          type: integer
          format: int64
          description: Buy trade count in the 100-1k USD bucket.
        bd_10k:
          type: integer
          format: int64
          description: Buy trade count in the 1k-10k USD bucket.
        bd_50k:
          type: integer
          format: int64
          description: Buy trade count in the 10k-50k USD bucket.
        bd_50p:
          type: integer
          format: int64
          description: Buy trade count in the 50k-plus USD bucket.
        nu:
          type: integer
          format: int64
          description: >-
            Onboarding metric — traders whose *first ever* builder-attributed
            trade

            touched this builder/grain. Cumulative on `timeseries`, delta on

            `deltas`. Each trader contributes at most once globally (any
            builder).
        ar:
          type: number
          format: double
          description: >-
            Average revenue per user — `builder_fees / unique_traders`. Zero
            when

            the bucket has no traders. Cumulative on `timeseries`, in-window on

            `deltas`.
        av:
          type: number
          format: double
          description: >-
            Average volume per user — `volume_usd / unique_traders`. Same
            scoping

            as `avg_rev_per_user` (cumulative on `timeseries`, in-window on
            `deltas`).

````