Skip to main content

Documentation Index

Fetch the complete documentation index at: https://polynode.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Polymarket V2 trades include a builder field identifying which order routing service executed the trade. This endpoint ranks all builders by their attributed fills.

Request

GET /v3/builders

Query parameters

ParameterTypeDefaultDescription
sortstringfillsSort by: fills, volume, fees, makers, takers
limitinteger100Max 1000
offsetinteger0Pagination offset

Example

curl https://api.polynode.dev/v3/builders?limit=2
{
  "builders": [
    {
      "builder": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "fill_count": 72023242,
      "first_fill": "1775220779",
      "last_fill": "1778488711",
      "rank": 1,
      "total_fees": "10921518739340",
      "total_maker_volume": "3344996649314321",
      "total_taker_volume": "5025649015227041",
      "unique_makers": 92465,
      "unique_takers": 86212
    },
    {
      "builder": "0x4898df15ec6590495dc6c0fedf951ade3e64001d47f9caf44a64e86fc11959df",
      "fill_count": 913811,
      "first_fill": "1777298664",
      "last_fill": "1778488703",
      "rank": 2,
      "total_fees": "118268898070",
      "total_maker_volume": "9200826455334",
      "total_taker_volume": "17670720174663",
      "unique_makers": 686,
      "unique_takers": 4004
    }
  ],
  "elapsed_ms": 3,
  "has_more": true,
  "rows_returned": 2
}

Response fields

FieldTypeDescription
builderstringBuilder code (0x-prefixed hex, 32 bytes)
fill_countintegerTotal fills attributed to this builder
first_fillstringUnix timestamp of first fill
last_fillstringUnix timestamp of most recent fill
rankintegerPosition in the leaderboard
total_feesstringTotal fees generated (6-decimal USDC)
total_maker_volumestringSum of maker-side volume (6-decimal USDC)
total_taker_volumestringSum of taker-side volume (6-decimal USDC)
unique_makersintegerDistinct maker wallets
unique_takersintegerDistinct taker wallets
EndpointDescription
GET /v3/builders/{code}Stats for a single builder
GET /v3/builders/{code}/tradesTrades attributed to a builder (requires ?after= time filter)