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

# Cumulative stats across all builders

> Returns one snapshot summing every builder-attributed trade over the chosen window.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/builders/global
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/global:
    get:
      tags:
        - Builders
      summary: Cumulative stats across all builders
      description: >-
        Returns one snapshot summing every builder-attributed trade over the
        chosen window.
      operationId: get_builder_global
      parameters:
        - name: timeframe
          in: query
          description: 'Window: lifetime, 1d, 24h, 7d, 30d, 1mo. Default: lifetime.'
          required: false
          schema:
            $ref: '#/components/schemas/BuilderTimeframe'
      responses:
        '200':
          description: Global builder snapshot
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuilderGlobalLatestRow'
components:
  schemas:
    BuilderTimeframe:
      type: string
      description: Time window for cumulative builder stats.
      enum:
        - lifetime
        - 1d
        - 7d
        - 30d
    BuilderGlobalLatestRow:
      type: object
      description: Cumulative stats across all builders.
      required:
        - block
        - ts
        - 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
        - distinct_builders
        - new_users
        - avg_rev_per_user
        - avg_vol_per_user
      properties:
        block:
          type: integer
          format: int64
          description: Latest block number for the metric snapshot.
          minimum: 0
        ts:
          type: integer
          format: int32
          description: Unix timestamp in seconds.
          minimum: 0
        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: integer
          format: int64
          description: Unique traders.
          minimum: 0
        unique_makers:
          type: integer
          format: int64
          description: Unique makers.
          minimum: 0
        unique_takers:
          type: integer
          format: int64
          description: Unique takers.
          minimum: 0
        txn_count:
          type: integer
          format: int64
          description: Transaction count.
          minimum: 0
        buy_count:
          type: integer
          format: int64
          description: Buy count.
          minimum: 0
        sell_count:
          type: integer
          format: int64
          description: Sell count.
          minimum: 0
        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: integer
          format: int64
          description: Yes count.
          minimum: 0
        no_count:
          type: integer
          format: int64
          description: No count.
          minimum: 0
        buy_dist_under_10:
          type: integer
          format: int64
          description: Buy trade count in the under-10 USD bucket.
          minimum: 0
        buy_dist_10_100:
          type: integer
          format: int64
          description: Buy trade count in the 10-100 USD bucket.
          minimum: 0
        buy_dist_100_1k:
          type: integer
          format: int64
          description: Buy trade count in the 100-1k USD bucket.
          minimum: 0
        buy_dist_1k_10k:
          type: integer
          format: int64
          description: Buy trade count in the 1k-10k USD bucket.
          minimum: 0
        buy_dist_10k_50k:
          type: integer
          format: int64
          description: Buy trade count in the 10k-50k USD bucket.
          minimum: 0
        buy_dist_50k_plus:
          type: integer
          format: int64
          description: Buy trade count in the 50k-plus USD bucket.
          minimum: 0
        distinct_builders:
          type: integer
          format: int64
          description: Distinct builder codes ever observed.
          minimum: 0
        new_users:
          type: integer
          format: int64
          description: |-
            Onboarding metric — traders whose *first ever* builder-attributed
            trade occurred within the chosen window. Each trader contributes at
            most once globally.
          minimum: 0
        avg_rev_per_user:
          type: number
          format: double
          description: Average revenue per user — `builder_fees / unique_traders`.
        avg_vol_per_user:
          type: number
          format: double
          description: Average volume per user — `volume_usd / unique_traders`.

````