Skip to main content
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

ParameterTypeDefaultDescription
sortstringfillsSort by: fills, volume, fees
limitinteger100Max 300
offsetinteger0Pagination 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

FieldTypeDescription
builderstringBuilder code (0x-prefixed hex, 32 bytes)
builder_codestringSame builder code, included for profile-style naming consistency
builder_namestring | nullPublic builder profile name when available
builder_logostring | nullPublic builder profile image URL when available
builder_verifiedboolean | nullWhether the builder profile is verified, when available
fill_countintegerTotal fills attributed to this builder
first_fillstringUnix timestamp of first fill
last_fillstringUnix timestamp of most recent fill
rankintegerPosition in the leaderboard
sourcestringlocal_order_filled_event_index when local stats are present, otherwise polymarket_builder_metadata
total_feesstringTotal fees generated in raw 6-decimal USDC units
total_fees_usdcstring | nullTotal fees normalized to decimal USDC
total_maker_volumestringSum of raw maker-side amount fields in 6-decimal units, kept for compatibility
total_maker_volume_usdcstring | nullMaker-side total normalized to decimal USDC
total_taker_volumestringSum of raw taker-side amount fields in 6-decimal units, kept for compatibility
total_taker_volume_usdcstring | nullTaker-side total normalized to decimal USDC
volume_e6string | nullSide-aware builder volume in raw 6-decimal USDC units. For buys this uses maker collateral; for sells this uses taker collateral.
volume_usdcstring | nullvolume_e6 normalized to decimal USDC. Prefer this for displayed builder volume.
buy_volume_e6string | nullBuy-side normalized-volume numerator in raw 6-decimal USDC units
buy_volume_usdcstring | nullBuy-side normalized volume in decimal USDC
sell_volume_e6string | nullSell-side normalized-volume numerator in raw 6-decimal USDC units
sell_volume_usdcstring | nullSell-side normalized volume in decimal USDC
external_rankinteger | nullPolymarket’s public builder leaderboard rank, when available
external_volumestring | nullPolymarket’s public builder leaderboard volume, when available
external_active_usersinteger | nullPolymarket’s public active-user count, when available
stats_refreshed_atstring | nullTime PolyNode last rewrote local stats for this builder
stats_checked_atstring | nullTime PolyNode last checked this builder, including no-op refreshes
stats_pendingbooleantrue 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.
EndpointDescription
GET /v3/builders/{code}Stats for a single builder
GET /v3/builders/{code}/tradesTrades attributed to a builder, with market and profile enrichment