Skip to main content
Returns fill count, volume, fees, normalized side-aware volume, and public profile metadata for a specific builder.

​
Request

GET /v3/builders/{code}

​
Path parameters

ParameterTypeDescription
codestringBuilder hex code (with or without 0x prefix)

​
Example

curl https://api.polynode.dev/v3/builders/0xd1d9dd6983c40006b0dc8eab84a41ac9a4f27643296178479ffbebbc01ab7bde

{
  "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,
  "buy_volume_e6": "8805777867302",
  "buy_volume_usdc": "8805777.867302000000",
  "elapsed_ms": 3,
  "external_active_users": 3,
  "external_rank": 23,
  "external_volume": "18380636.129236996",
  "fee_semantics": "Builder-attributed trader-paid fees. This is not a builder rebate payout.",
  "fill_count": 23076,
  "first_fill": "1777382110",
  "last_fill": "1782307555",
  "sell_volume_e6": "0",
  "sell_volume_usdc": "0.000000000000000000000000",
  "source": "builder_fee_stats",
  "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",
  "stats_source": "local_order_filled_event_index",
  "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"
}

​
Response fields

Same fields as the Builder Leaderboard response, without rank.
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
sourcestringLegacy source label. builder_fee_stats means local builder stats are present; polymarket_builder_metadata means only profile metadata is present so far.
stats_sourcestring | nullLocal stats source, currently local_order_filled_event_index when local stats are populated
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
fee_semanticsstringReminder that builder fees are trader-paid fees attributed to builder order flow, not a builder rebate payout
elapsed_msintegerServer-side query time in milliseconds
EndpointDescription
GET /v3/buildersBuilder leaderboard
GET /v3/builders/{code}/tradesTrades attributed to this builder