Builder Detail

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 code (with or without `0x`) or exact public Builder name. Hex digits, the prefix, and names are case-insensitive; names must be URL-encoded.

Example

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

You may also use the exact public name. A shared name returns HTTP 409; use the code from the Builder directory to disambiguate.

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

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

Name-resolution errors

Status	Error	Meaning
`404`	`builder_not_found` or `builder not found`	No Builder matches the supplied name or code
`409`	`ambiguous_builder_name`	More than one Builder uses the supplied name; use a code from the Builder directory

Endpoint	Description
`GET /v3/builders`	Builder leaderboard
`GET /v3/builders/{code}/leaderboard`	Rank every eligible trader active through this builder by global wallet P&L first, or by attributed activity
`GET /v3/builders/{code}/activity/daily`	Daily activity and recent top-market/category composition
`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

Name-resolution errors

​Request

​Path parameters

​Example

​Response fields

​Name-resolution errors

​Related endpoints

Request

Path parameters

Example

Response fields

Name-resolution errors

Related endpoints