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

# Builder Stats

> Single-builder summary plus full fee-rate history

Single-builder summary over a rolling window, plus the full history of `(taker_bps, maker_bps)` rate changes for that builder.

<Note>
  **V2-only.** Builder attribution is a Polymarket V2 concept - V1 fills are excluded from all metrics.
</Note>

### Windows

`24h`, `7d` (default), `30d`, or `all`.

### Fee-rate history

The `fee_rate_history` array returns every `(taker_bps, maker_bps)` rate the builder has used, in order, with `valid_from` and `valid_to` Unix timestamps. The current rate has a far-future `valid_to`.

| Field       | Range |
| ----------- | ----- |
| `taker_bps` | 0–100 |
| `maker_bps` | 0–50  |


## OpenAPI

````yaml GET /v2/polymarket/builders/{builder_code}
openapi: 3.1.0
info:
  title: Predexon API
  description: Prediction market data aggregation and matching API
  version: 2.0.0
servers:
  - url: https://api.predexon.com
security:
  - apiKey: []
paths:
  /v2/polymarket/builders/{builder_code}:
    get:
      tags:
        - polymarket
      summary: Get Builder Stats
      description: Single-builder summary plus full (taker_bps, maker_bps) history.
      operationId: get_builder_stats_v2_polymarket_builders__builder_code__get
      parameters:
        - name: builder_code
          in: path
          required: true
          schema:
            type: string
            description: Builder code (bytes32 hex)
            title: Builder Code
          description: Builder code (bytes32 hex)
        - name: window
          in: query
          required: false
          schema:
            type: string
            description: 'Rolling window: 24h, 7d, 30d, or all'
            default: 7d
            title: Window
          description: 'Rolling window: 24h, 7d, 30d, or all'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuilderStats'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal Server Error
components:
  schemas:
    BuilderStats:
      properties:
        builder_code:
          type: string
          title: Builder Code
          description: Builder code, bytes32 hex
        window:
          type: string
          title: Window
          description: Time window for the rolling metrics
        volume_usd:
          type: number
          title: Volume Usd
        builder_fee_usd:
          type: number
          title: Builder Fee Usd
        platform_fee_usd:
          type: number
          title: Platform Fee Usd
        trade_count:
          type: integer
          title: Trade Count
        unique_traders:
          type: integer
          title: Unique Traders
        unique_markets:
          type: integer
          title: Unique Markets
        current_taker_bps:
          anyOf:
            - type: integer
            - type: 'null'
          title: Current Taker Bps
          description: Current taker bps
        current_maker_bps:
          anyOf:
            - type: integer
            - type: 'null'
          title: Current Maker Bps
          description: Current maker bps
        first_seen_at:
          anyOf:
            - type: integer
            - type: 'null'
          title: First Seen At
          description: Unix timestamp of earliest attributed fill
        last_seen_at:
          anyOf:
            - type: integer
            - type: 'null'
          title: Last Seen At
          description: Unix timestamp of latest attributed fill
        fee_rate_history:
          items:
            $ref: '#/components/schemas/BuilderFeeRateHistoryEntry'
          type: array
          title: Fee Rate History
      type: object
      required:
        - builder_code
        - window
        - volume_usd
        - builder_fee_usd
        - platform_fee_usd
        - trade_count
        - unique_traders
        - unique_markets
      title: BuilderStats
      description: Detailed stats for a single builder.
    ErrorResponse:
      properties:
        error:
          type: string
          title: Error
        message:
          type: string
          title: Message
      type: object
      required:
        - error
        - message
      title: ErrorResponse
      description: Standard error response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    BuilderFeeRateHistoryEntry:
      properties:
        taker_bps:
          type: integer
          title: Taker Bps
          description: Taker-leg fee in basis points
        maker_bps:
          type: integer
          title: Maker Bps
          description: Maker-leg fee in basis points
        valid_from:
          type: integer
          title: Valid From
          description: Unix timestamp the rate took effect
        valid_to:
          type: integer
          title: Valid To
          description: Unix timestamp the rate stopped applying
      type: object
      required:
        - taker_bps
        - maker_bps
        - valid_from
        - valid_to
      title: BuilderFeeRateHistoryEntry
      description: A single taker/maker fee validity window for one builder.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````