Builder Detail

Returns fill count, volume, fees, normalized side-aware volume, 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": "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.

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	Maker-side total normalized to decimal USDC
`total_taker_volume`	string	Sum of raw taker-side amount fields in 6-decimal units, kept for compatibility
`total_taker_volume_usdc`	string \| null	Taker-side total normalized to decimal USDC
`volume_e6`	string \| null	Side-aware builder volume in raw 6-decimal USDC units. For buys this uses maker collateral; for sells this uses taker collateral.
`volume_usdc`	string \| null	`volume_e6` normalized to decimal USDC. Prefer this for displayed builder volume.
`buy_volume_e6`	string \| null	Buy-side normalized-volume numerator in raw 6-decimal USDC units
`buy_volume_usdc`	string \| null	Buy-side normalized volume in decimal USDC
`sell_volume_e6`	string \| null	Sell-side normalized-volume numerator in raw 6-decimal USDC units
`sell_volume_usdc`	string \| null	Sell-side normalized volume in decimal USDC
`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

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

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)

Request

Path parameters

Example

Response fields

​Request

​Path parameters

​Example

​Response fields

​Related endpoints

Request

Path parameters

Example

Response fields

Related endpoints