---
title: "Get Builder Leaderboard"
method: GET
path: "/v2/polymarket/builders/leaderboard"
tags: ["polymarket"]
---

# Get Builder Leaderboard

`GET /v2/polymarket/builders/leaderboard`

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.

## Query parameters

- `window` string — Rolling window: 24h, 7d, 30d, or all
- `sort_by` string — Sort field: 'volume' or 'fee'
- `limit` integer — Max entries to return

## Response `200`

Successful Response

- BuilderLeaderboardResponse — Response for builder leaderboard endpoint.
  - `window` string, required — Time window for metrics
  - `entries` BuilderLeaderboardEntry[], required — Builder leaderboard rows
    - `rank` integer, required — Position in leaderboard, 1-indexed
    - `builder_code` string, required — Builder code, bytes32 hex
    - `volume_usd` number, required — Attributed trade notional in USD over the window
    - `builder_fee_usd` number, required — Builder fee revenue in USD over the window
    - `platform_fee_usd` number, required — Platform fee on attributed trades
    - `trade_count` integer, required — Number of V2 OrderFilled rows attributed to this builder
    - `unique_traders` integer, required — Unique non-internal addresses that traded via this builder
    - `unique_markets` integer, required — Unique condition_ids touched
    - `current_taker_bps` integer, nullable — Current taker bps
    - `current_maker_bps` integer, nullable — Current maker bps

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/versions/80a306fbdb39/schema)