Builder Detail

Get stats and public profile metadata for a single builder by hex code.

Returns fill count, Polymarket-compatible V2 share-notional volume, fees, buy/sell volume, raw maker/taker totals, and public profile metadata for a specific builder.

Request

GET /v3/builders/{code}

Path parameters

Parameter	Type	Description
code	string	Builder 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": "18512535904523",
  "buy_volume_usdc": "18512535.904523000000",
  "buy_volume": "18512535.904523000000",
  "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",
  "sell_volume": "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": "18512535904523",
  "volume_usdc": "18512535.904523000000",
  "volume": "18512535.904523000000",
  "volume_scope": "clob_v2_onchain",
  "volume_semantics": "outcome_share_par_notional"
}

Response fields

Same fields as the Builder Leaderboard response, without rank.

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
source	string	Legacy source label. builder_fee_stats means local builder stats are present; polymarket_builder_metadata means only profile metadata is present so far.
stats_source	string | null	Local stats source, currently local_order_filled_event_index when local stats are populated
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
fee_semantics	string	Reminder that builder fees are trader-paid fees attributed to builder order flow, not a builder rebate payout
elapsed_ms	integer	Server-side query time in milliseconds

Related endpoints

Endpoint	Description
GET /v3/builders	Builder leaderboard
GET /v3/builders/{code}/trades	Trades attributed to this builder