Skip to main content
GET
/
polymarket
/
builders
/
{builder_code}
/
top-traders
Top traders for a builder
curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders/{builder_code}/top-traders
[
  {
    "trader": "<string>",
    "volume_usd": 123,
    "txn_count": 123,
    "fees_usd": 123,
    "builder_fees": 123
  }
]

Path Parameters

​
builder_code
string
required

Builder code.

Query Parameters

​
timeframe
enum<string>

Window: lifetime, 1d (24h), 7d, 30d (1mo). Default: 1d Time window for cumulative builder stats.

Available options:
lifetime,
1d,
7d,
30d
​
sort_by
enum<string>

Ranking key: volume (default), txns, fees, builder_fees Sort key for the top-traders ranking.

Available options:
volume,
txns,
fees,
builder_fees
​
sort_desc
boolean

Sort direction (default: true = highest first).

​
limit
integer<int64>

Traders per page (default 10, max 250)

​
offset
integer<int64>

Number of traders to skip. Default 0. Takes precedence over pagination_key.

​
pagination_key
string

Opaque cursor from a previous response. Ignored when offset is set.

Response

200 - application/json

Top traders for this builder

​
trader
string
required

Trader wallet or profile.

​
volume_usd
number<double>
required

Volume in USD.

​
txn_count
integer<int64>
required

Transaction count.

​
fees_usd
number<double>
required

Fees in USD.

​
builder_fees
number<double>
required

Builder fees.

Last modified on June 17, 2026