Builder Leaderboard

Polymarket V2 trades include a builder field identifying which order routing service executed the trade. This endpoint ranks builders by attributed fills and includes profile metadata when a builder has a public builder profile. Builder profile metadata is synced from Polymarket’s public builder metadata. Local fill, fee, and normalized volume stats come from PolyNode’s indexed OrderFilled events. Builders can appear with metadata before their local stats row is refreshed; in that case stats_pending is true and normalized local volume fields are null.

Request

GET /v3/builders

Query parameters

Parameter	Type	Default	Description
`sort`	string	`fills`	Sort by: `fills`, `volume`, `fees`
`limit`	integer	100	Max 300
`offset`	integer	0	Pagination offset

Example

curl "https://api.polynode.dev/v3/builders?sort=volume&limit=1"

{
  "builders": [
    {
      "builder": "0xd1d9dd6983c40006b0dc8eab84a41ac9a4f27643296178479ffbebbc01ab7bde",
      "builder_code": "0xd1d9dd6983c40006b0dc8eab84a41ac9a4f27643296178479ffbebbc01ab7bde",
      "builder_logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/profile-image-5148537-b5dbf263-8d5f-41d7-bba1-387bfa17075c.png",
      "builder_name": "MagicMarkets",
      "builder_verified": true,
      "external_active_users": 3,
      "external_rank": 23,
      "external_volume": "18380636.129236996",
      "fill_count": 23076,
      "first_fill": "1777382110",
      "last_fill": "1782307555",
      "rank": 1,
      "source": "local_order_filled_event_index",
      "stats_checked_at": "2026-06-24 13:28:05.26204+00",
      "stats_pending": false,
      "stats_refreshed_at": "2026-06-24 13:28:03.133082+00",
      "buy_volume_e6": "8805777867302",
      "buy_volume_usdc": "8805777.867302000000",
      "sell_volume_e6": "0",
      "sell_volume_usdc": "0.000000000000000000000000",
      "total_fees": "116885095300",
      "total_fees_usdc": "116885.095300000000",
      "total_maker_volume": "8805777867302",
      "total_maker_volume_usdc": "8805777.867302000000",
      "total_taker_volume": "18512535904523",
      "total_taker_volume_usdc": "18512535.904523000000",
      "volume_e6": "8805777867302",
      "volume_usdc": "8805777.867302000000"
    }
  ],
  "elapsed_ms": 8,
  "has_more": true,
  "limit": 1,
  "offset": 0,
  "rows_returned": 1
}

Response fields

Field	Type	Description
`builder`	string	Builder code (`0x`-prefixed hex, 32 bytes)
`builder_code`	string	Same builder code, included for profile-style naming consistency
`builder_name`	string \| null	Public builder profile name when available
`builder_logo`	string \| null	Public builder profile image URL when available
`builder_verified`	boolean \| null	Whether the builder profile is verified, when available
`fill_count`	integer	Total fills attributed to this builder
`first_fill`	string	Unix timestamp of first fill
`last_fill`	string	Unix timestamp of most recent fill
`rank`	integer	Position in the leaderboard
`source`	string	`local_order_filled_event_index` when local stats are present, otherwise `polymarket_builder_metadata`
`total_fees`	string	Total fees generated in raw 6-decimal USDC units
`total_fees_usdc`	string \| null	Total fees normalized to decimal USDC
`total_maker_volume`	string	Sum of raw maker-side amount fields in 6-decimal units, kept for compatibility
`total_maker_volume_usdc`	string \| null	Maker-side total normalized to decimal USDC
`total_taker_volume`	string	Sum of raw taker-side amount fields in 6-decimal units, kept for compatibility
`total_taker_volume_usdc`	string \| null	Taker-side total normalized to decimal USDC
`volume_e6`	string \| null	Side-aware builder volume in raw 6-decimal USDC units. For buys this uses maker collateral; for sells this uses taker collateral.
`volume_usdc`	string \| null	`volume_e6` normalized to decimal USDC. Prefer this for displayed builder volume.
`buy_volume_e6`	string \| null	Buy-side normalized-volume numerator in raw 6-decimal USDC units
`buy_volume_usdc`	string \| null	Buy-side normalized volume in decimal USDC
`sell_volume_e6`	string \| null	Sell-side normalized-volume numerator in raw 6-decimal USDC units
`sell_volume_usdc`	string \| null	Sell-side normalized volume in decimal USDC
`external_rank`	integer \| null	Polymarket’s public builder leaderboard rank, when available
`external_volume`	string \| null	Polymarket’s public builder leaderboard volume, when available
`external_active_users`	integer \| null	Polymarket’s public active-user count, when available
`stats_refreshed_at`	string \| null	Time PolyNode last rewrote local stats for this builder
`stats_checked_at`	string \| null	Time PolyNode last checked this builder, including no-op refreshes
`stats_pending`	boolean	`true` when profile metadata exists but the local stats row has not been populated yet

builder_name, builder_logo, builder_verified, and the normalized local-volume fields are nullable. external_volume is Polymarket’s public leaderboard value; volume_usdc is PolyNode’s local indexed side-aware volume. Use external_active_users for the current public builder user-count signal.

Endpoint	Description
`GET /v3/builders/{code}`	Stats for a single builder
`GET /v3/builders/{code}/trades`	Trades attributed to a builder, with market and profile enrichment

Overview

V3 Data API

Wallet P&L

Wallet Activity

Credits

Identity

Fees

Combos

Rewards

Markets & Search

Orderbook

Leaderboard & Tags

Builders

Polymarket Profiles

Global

Tokens

Perps

Perps Market Data

Perps Wallets

Perps Analytics

Perps On-Chain

Perps Streaming

Crypto

Sports

BYOL

Backtesting

Market Card

System

Search & Context

Onchain V2 (legacy)

Builder Leaderboard

Request

Query parameters

Example

Response fields

​Request

​Query parameters

​Example

​Response fields

​Related endpoints

Request

Query parameters

Example

Response fields

Related endpoints