Skip to main content
GET
/
v2
/
polymarket
/
builders
/
leaderboard
Get Builder Leaderboard
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/builders/leaderboard \
  --header 'x-api-key: <api-key>'
{
  "window": "<string>",
  "entries": [
    {
      "rank": 123,
      "builder_code": "<string>",
      "volume_usd": 123,
      "builder_fee_usd": 123,
      "platform_fee_usd": 123,
      "trade_count": 123,
      "unique_traders": 123,
      "unique_markets": 123,
      "current_taker_bps": 123,
      "current_maker_bps": 123
    }
  ]
}

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.

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.
V2-only. Builder attribution is a Polymarket V2 concept — V1 fills, the zero-sentinel builder, and reversed (sign != 1) fills are excluded.

Sorting

sort_byBehavior
volume (default)Ranks by volume_usd — surfaces the highest-throughput builders, many of which charge 0 bps.
feeRanks by builder_fee_usd — more useful when you care about revenue-earning builders.

Windows

24h, 7d (default), 30d, or all.
ConstraintValue
limit1–500 (default 50)

Authorizations

x-api-key
string
header
required

Query Parameters

window
string
default:7d

Rolling window: 24h, 7d, 30d, or all

sort_by
string
default:volume

Sort field: 'volume' or 'fee'

limit
integer
default:50

Max entries to return

Required range: 1 <= x <= 500

Response

Successful Response

Response for builder leaderboard endpoint.

window
string
required

Time window for metrics (e.g. 24h, 7d, 30d, all)

entries
BuilderLeaderboardEntry · object[]
required

Builder leaderboard rows, sorted by volume