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

# Top traders for a builder

> Returns the highest-volume (or highest-fee / highest-txn) traders that have routed through this builder over the requested window. Paginate past the first page with `offset` or `pagination_key` to enumerate all of a builder's traders.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/builders/{builder_code}/top-traders
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}/top-traders:
    get:
      tags:
        - Builders
      summary: Top traders for a builder
      description: >-
        Returns the highest-volume (or highest-fee / highest-txn) traders that
        have routed through this builder over the requested window. Paginate
        past the first page with `offset` or `pagination_key` to enumerate all
        of a builder's traders.
      operationId: get_builder_top_traders
      parameters:
        - name: builder_code
          in: path
          description: Builder code.
          required: true
          schema:
            type: string
        - name: timeframe
          in: query
          description: 'Window: lifetime, 1d (24h), 7d, 30d (1mo). Default: 1d'
          required: false
          schema:
            $ref: '#/components/schemas/BuilderTimeframe'
        - name: sort_by
          in: query
          description: 'Ranking key: volume (default), txns, fees, builder_fees'
          required: false
          schema:
            $ref: '#/components/schemas/TopTradersSortBy'
        - name: sort_desc
          in: query
          description: 'Sort direction (default: true = highest first).'
          required: false
          schema:
            type: boolean
        - name: limit
          in: query
          description: Traders per page (default 10, max 250)
          required: false
          schema:
            type: integer
            format: int64
        - name: offset
          in: query
          description: >-
            Number of traders to skip. Default 0. Takes precedence over
            `pagination_key`.
          required: false
          schema:
            type: integer
            format: int64
        - name: pagination_key
          in: query
          description: >-
            Opaque cursor from a previous response. Ignored when `offset` is
            set.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Top traders for this builder
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TopTraderRow'
components:
  schemas:
    BuilderTimeframe:
      type: string
      description: Time window for cumulative builder stats.
      enum:
        - lifetime
        - 1d
        - 7d
        - 30d
    TopTradersSortBy:
      type: string
      description: Sort key for the top-traders ranking.
      enum:
        - volume
        - txns
        - fees
        - builder_fees
    TopTraderRow:
      type: object
      required:
        - trader
        - volume_usd
        - txn_count
        - fees_usd
        - builder_fees
      properties:
        trader:
          type: string
          description: Trader wallet or profile.
        volume_usd:
          type: number
          format: double
          description: Volume in USD.
        txn_count:
          type: integer
          format: int64
          description: Transaction count.
        fees_usd:
          type: number
          format: double
          description: Fees in USD.
        builder_fees:
          type: number
          format: double
          description: Builder fees.

````