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

> Ranked list of V2 builders by attributed volume or fee revenue

Ranks Polymarket V2 builders over a rolling window by either attributed trade volume (default) or builder-fee revenue. Each row carries the builder's volume, fee revenue, trade count, unique traders/markets, and the current `(taker_bps, maker_bps)` rate.

<Note>
  **V2-only.** Builder attribution is a Polymarket V2 concept - V1 fills, the zero-sentinel builder, and reversed (`sign != 1`) fills are excluded.
</Note>

### Sorting

| `sort_by`          | Behavior                                                                                      |
| ------------------ | --------------------------------------------------------------------------------------------- |
| `volume` (default) | Ranks by `volume_usd` - surfaces the highest-throughput builders, many of which charge 0 bps. |
| `fee`              | Ranks by `builder_fee_usd` - more useful when you care about revenue-earning builders.        |

### Windows

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

| Constraint | Value              |
| ---------- | ------------------ |
| `limit`    | 1–500 (default 50) |


## OpenAPI

````yaml GET /v2/polymarket/builders/leaderboard
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/leaderboard:
    get:
      tags:
        - polymarket
      summary: Get Builder Leaderboard
      description: >-
        Ranked list of builders over the window.


        Defaults to ranking by attributed volume; `sort_by=fee` ranks by

        `builder_fee_usd` instead (more useful when looking at revenue-earning

        builders, since the highest-volume builders often charge 0 bps).


        `builder_fee_usd` is computed at the rate in force when each fill

        happened (ASOF against `builder_fee_rates`), not today's rate.

        `current_taker_bps`/`current_maker_bps` surface today's rate for
        display.

        Excludes V1 fills, zero-sentinel builders, and rows with sign != 1.
      operationId: get_builder_leaderboard_v2_polymarket_builders_leaderboard_get
      parameters:
        - 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'
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
            description: 'Sort field: ''volume'' or ''fee'''
            default: volume
            title: Sort By
          description: 'Sort field: ''volume'' or ''fee'''
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            minimum: 1
            description: Max entries to return
            default: 50
            title: Limit
          description: Max entries to return
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuilderLeaderboardResponse'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '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:
    BuilderLeaderboardResponse:
      properties:
        window:
          type: string
          title: Window
          description: Time window for metrics
        entries:
          items:
            $ref: '#/components/schemas/BuilderLeaderboardEntry'
          type: array
          title: Entries
          description: Builder leaderboard rows
      type: object
      required:
        - window
        - entries
      title: BuilderLeaderboardResponse
      description: Response for builder leaderboard endpoint.
    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
    BuilderLeaderboardEntry:
      properties:
        rank:
          type: integer
          title: Rank
          description: Position in leaderboard, 1-indexed
        builder_code:
          type: string
          title: Builder Code
          description: Builder code, bytes32 hex
        volume_usd:
          type: number
          title: Volume Usd
          description: Attributed trade notional in USD over the window
        builder_fee_usd:
          type: number
          title: Builder Fee Usd
          description: Builder fee revenue in USD over the window
        platform_fee_usd:
          type: number
          title: Platform Fee Usd
          description: Platform fee on attributed trades
        trade_count:
          type: integer
          title: Trade Count
          description: Number of V2 OrderFilled rows attributed to this builder
        unique_traders:
          type: integer
          title: Unique Traders
          description: Unique non-internal addresses that traded via this builder
        unique_markets:
          type: integer
          title: Unique Markets
          description: Unique condition_ids touched
        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
      type: object
      required:
        - rank
        - builder_code
        - volume_usd
        - builder_fee_usd
        - platform_fee_usd
        - trade_count
        - unique_traders
        - unique_markets
      title: BuilderLeaderboardEntry
      description: One row in the builder leaderboard.
    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

````