> ## 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 percentage change over a lookback window

> Per-metric percentage change over the requested window for one builder.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/builders/{builder_code}/analytics/changes
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/changes:
    get:
      tags:
        - Builders
      summary: Builder percentage change over a lookback window
      description: Per-metric percentage change over the requested window for one builder.
      operationId: get_builder_analytics_changes
      parameters:
        - name: builder_code
          in: path
          description: Builder identifier (0x-prefixed hex).
          required: true
          schema:
            type: string
        - name: timeframe
          in: query
          description: 'Lookback window (default: 24h).'
          required: false
          schema:
            $ref: '#/components/schemas/ChangeTimeframe'
      responses:
        '200':
          description: Per-metric percentage change
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuilderPctChange'
components:
  schemas:
    ChangeTimeframe:
      type: string
      description: Lookback window for percentage-change endpoints.
      enum:
        - 1h
        - 24h
        - 7d
        - 30d
        - 1mo
        - 1y
    BuilderPctChange:
      type: object
      description: >-
        Per-metric percentage change for a builder over the requested lookback
        window.
      required:
        - builder_code
        - volume_usd
        - buy_volume_usd
        - sell_volume_usd
        - unique_traders
        - unique_makers
        - unique_takers
        - txn_count
        - buy_count
        - sell_count
        - fees_usd
        - builder_fees
        - shares_volume
        - yes_volume_usd
        - no_volume_usd
        - yes_count
        - no_count
        - buy_dist_under_10
        - buy_dist_10_100
        - buy_dist_100_1k
        - buy_dist_1k_10k
        - buy_dist_10k_50k
        - buy_dist_50k_plus
        - new_users
        - avg_rev_per_user
        - avg_vol_per_user
      properties:
        builder_code:
          type: string
          description: |-
            The builder this response is about. Always populated, even when no
            activity exists in either the current or previous window.
        volume_usd:
          type: number
          format: double
          description: Volume in USD.
        buy_volume_usd:
          type: number
          format: double
          description: Buy volume in USD.
        sell_volume_usd:
          type: number
          format: double
          description: Sell volume in USD.
        unique_traders:
          type: number
          format: double
          description: Unique traders.
        unique_makers:
          type: number
          format: double
          description: Unique makers.
        unique_takers:
          type: number
          format: double
          description: Unique takers.
        txn_count:
          type: number
          format: double
          description: Transaction count.
        buy_count:
          type: number
          format: double
          description: Buy count.
        sell_count:
          type: number
          format: double
          description: Sell count.
        fees_usd:
          type: number
          format: double
          description: Fees in USD.
        builder_fees:
          type: number
          format: double
          description: Builder fees.
        shares_volume:
          type: number
          format: double
          description: Shares volume.
        yes_volume_usd:
          type: number
          format: double
          description: Yes volume in USD.
        no_volume_usd:
          type: number
          format: double
          description: No volume in USD.
        yes_count:
          type: number
          format: double
          description: Yes count.
        no_count:
          type: number
          format: double
          description: No count.
        buy_dist_under_10:
          type: number
          format: double
          description: Buy trade count in the under-10 USD bucket.
        buy_dist_10_100:
          type: number
          format: double
          description: Buy trade count in the 10-100 USD bucket.
        buy_dist_100_1k:
          type: number
          format: double
          description: Buy trade count in the 100-1k USD bucket.
        buy_dist_1k_10k:
          type: number
          format: double
          description: Buy trade count in the 1k-10k USD bucket.
        buy_dist_10k_50k:
          type: number
          format: double
          description: Buy trade count in the 10k-50k USD bucket.
        buy_dist_50k_plus:
          type: number
          format: double
          description: Buy trade count in the 50k-plus USD bucket.
        new_users:
          type: number
          format: double
          description: New users.
        avg_rev_per_user:
          type: number
          format: double
          description: Average rev per user.
        avg_vol_per_user:
          type: number
          format: double
          description: Average vol per user.

````