Get the builders leaderboard

The ranked board of builders by volume.

?time_period= is day (default), week, month or all and selects the window; one row per builder in it. Deeper pages come only from ?cursor=.

A cursor pins the window it was minted on, so following it needs no ?time_period=; and passing a different one is a 400 rather than a silent re-point, since an offset from one board means nothing on another.

volume is in SHARES, not USDC, the same unit as /v2/leaderboard’s volume. active_users counts distinct makers in the window.

builder is a display name that falls back to builder_code for a builder with no profile, so key on builder_code and render builder.

GET /v2/builders/leaderboard

Get the builders leaderboard

cURL

curl --request GET \
  --url https://data-api.polymarket.com/v2/builders/leaderboard \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "active_users": 1,
      "builder_code": "<string>",
      "builder_name": "<string>",
      "profile_image": "<string>",
      "rank": 1,
      "verified": true,
      "volume": 123
    }
  ],
  "pagination": {
    "has_more": true,
    "limit": 1,
    "offset": 1,
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

time_period · string | null

Window: day | week | month | all. Defaults to day.

limit · integer<int32> | null

First-page size. Ignored when cursor is supplied.

Required range: 0 <= x <= 1000

cursor · string | null

Opaque pagination cursor from a prior response's next_cursor.

Response

200

application/json

A page of the builders board

{ data, pagination } envelope for /v2/builders/leaderboard; an offset-cursor board, like LeaderboardPage. Its companion /v2/builders/volume is a series rather than a board and is NOT paged.

data · object[] · required

The page's rows.

Show child attributes

pagination · object · required

Paging envelope: follow next_cursor until null.

Show child attributes