Builder Leaderboard

Rank Polymarket builders by V2-attributed share notional, fill count, fees, and enriched builder profile metadata.

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 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 local volume fields are null.

volume is the canonical total builder volume. It counts the outcome shares attributed to the builder, with one share represented as $1 of par notional. This matches Polymarket’s builder-volume convention over the same CLOB V2 history. Polymarket may show additional legacy volume from before onchain V2 builder attribution; Polynode does not import that historical total.

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": "18512535904523",
      "buy_volume_usdc": "18512535.904523000000",
      "buy_volume": "18512535.904523000000",
      "sell_volume_e6": "0",
      "sell_volume_usdc": "0.000000000000000000000000",
      "sell_volume": "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": "18512535904523",
      "volume_usdc": "18512535.904523000000",
      "volume": "18512535.904523000000",
      "volume_scope": "clob_v2_onchain",
      "volume_semantics": "outcome_share_par_notional"
    }
  ],
  "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	Legacy decimal-scaled maker amount. Depending on the fill side, this raw leg can be collateral or outcome shares.
total_taker_volume	string	Sum of raw taker-side amount fields in 6-decimal units, kept for compatibility
total_taker_volume_usdc	string | null	Legacy decimal-scaled taker amount. Depending on the fill side, this raw leg can be collateral or outcome shares.
volume_e6	string | null	Canonical total builder volume as outcome-share par notional in raw 6-decimal units
volume	string | null	Preferred decimal total builder volume; one outcome share counts as $1 of par notional
volume_usdc	string | null	Compatibility alias for volume; it is par notional, not collateral cash paid
buy_volume_e6	string | null	Buy-side outcome-share par notional in raw 6-decimal units
buy_volume	string | null	Decimal buy-side outcome-share par notional
buy_volume_usdc	string | null	Compatibility alias for buy_volume
sell_volume_e6	string | null	Sell-side outcome-share par notional in raw 6-decimal units
sell_volume	string | null	Decimal sell-side outcome-share par notional
sell_volume_usdc	string | null	Compatibility alias for sell_volume
volume_scope	string	clob_v2_onchain; legacy pre-V2 builder attribution is outside this total
volume_semantics	string	outcome_share_par_notional
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 local-volume fields are nullable. external_volume is separate public profile context and is never substituted into volume. Buy and sell volume use the same share-notional basis and add to total builder volume. Use external_active_users for the current public builder user-count signal.

Related endpoints

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