Builder Leaderboard

Polymarket V2 trades include a builder field identifying which order routing service executed the trade. This endpoint is both the Builder ranking and the canonical public Builder directory. It returns each Builder’s display name and code, and it can resolve an exact display name case-insensitively. 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
`name`	string	—	Exact public Builder name, matched case-insensitively. All matches are returned when a display name is shared.

sort and name are case-insensitive. Responses retain canonical Builder names and codes.

Example

curl -H "x-api-key: $POLYNODE_API_KEY" \
  "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.

Find a Builder by name

Names are matched exactly after trimming whitespace and without case sensitivity. Because display names are not guaranteed to be unique, retain the returned builder_code as the stable identifier.

curl -H "x-api-key: $POLYNODE_API_KEY" \
  "https://api.polynode.dev/v3/builders?name=BetMoar"

Print every Builder name and code

The directory supports 300 rows per request. This loop follows has_more and prints a tab-separated directory without assuming how many Builders currently exist.

offset=0
while :; do
  page=$(curl -fsS -H "x-api-key: $POLYNODE_API_KEY" \
    "https://api.polynode.dev/v3/builders?sort=volume&limit=300&offset=${offset}")
  jq -r '.builders[] | [(.builder_name // ""), .builder_code] | @tsv' <<<"$page"
  [ "$(jq -r '.has_more' <<<"$page")" = "true" ] || break
  offset=$((offset + 300))
done

Endpoint	Description
`GET /v3/builders/{code}`	Stats for a single builder
`GET /v3/builders/{code}/leaderboard`	Rank every eligible trader active through one builder by P&L first, or by attributed activity, over 1D, 7D, 30D, or All Time
`GET /v3/builders/{code}/activity/daily`	Daily activity and recent top-market/category composition for one Builder
`GET /v3/builders/activity/daily`	Compare daily activity for up to 20 Builder codes
`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

Find a Builder by name

Print every Builder name and code

​Request

​Query parameters

​Example

​Response fields

​Find a Builder by name

​Print every Builder name and code

​Related endpoints

Request

Query parameters

Example

Response fields

Find a Builder by name

Print every Builder name and code

Related endpoints