> ## Documentation Index > Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt > Use this file to discover all available pages before exploring further. # Builder Leaderboard > Rank Polymarket builders by fill count, normalized volume, fees, and enriched builder profile metadata. 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 | Parameter | Type | Default | Description | | --------- | ------- | ------- | ---------------------------------- | | `sort` | string | `fills` | Sort by: `fills`, `volume`, `fees` | | `limit` | integer | 100 | Max 300 | | `offset` | integer | 0 | Pagination offset | ## Example ```bash theme={null} curl "https://api.polynode.dev/v3/builders?sort=volume&limit=1" ``` ```json theme={null} { "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 | 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 | | `rank` | integer | Position in the leaderboard | | `source` | string | `local_order_filled_event_index` when local stats are present, otherwise `polymarket_builder_metadata` | | `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 | `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. ## Related endpoints | Endpoint | Description | | -------------------------------- | ------------------------------------------------------------------ | | `GET /v3/builders/{code}` | Stats for a single builder | | `GET /v3/builders/{code}/trades` | Trades attributed to a builder, with market and profile enrichment |