Skip to main content
GET
/
polymarket
/
builders
List builders ranked by activity
curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders
[
  {
    "builder_code": "<string>",
    "block": 1,
    "ts": 1,
    "volume_usd": 123,
    "buy_volume_usd": 123,
    "sell_volume_usd": 123,
    "unique_traders": 1,
    "unique_makers": 1,
    "unique_takers": 1,
    "txn_count": 1,
    "buy_count": 1,
    "sell_count": 1,
    "fees_usd": 123,
    "builder_fees": 123,
    "shares_volume": 123,
    "yes_volume_usd": 123,
    "no_volume_usd": 123,
    "yes_count": 1,
    "no_count": 1,
    "buy_dist_under_10": 1,
    "buy_dist_10_100": 1,
    "buy_dist_100_1k": 1,
    "buy_dist_1k_10k": 1,
    "buy_dist_10k_50k": 1,
    "buy_dist_50k_plus": 1,
    "new_users": 1,
    "avg_rev_per_user": 123,
    "avg_vol_per_user": 123,
    "builder_maker_fee_rate_bps": 1,
    "builder_taker_fee_rate_bps": 1,
    "metadata": {
      "name": "<string>",
      "website": "<string>",
      "twitter": "<string>",
      "icon_url": "<string>",
      "description": "<string>"
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.struct.to/llms.txt

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

Query Parameters

​
sort
enum<string>

Metric to sort by. Default: volume. Sort metric for the builders list endpoint.

Available options:
volume,
txns,
traders,
fees,
builder_fees,
new_users,
avg_rev_per_user,
avg_vol_per_user,
builder_maker_fee_rate_bps,
builder_taker_fee_rate_bps
​
sort_desc
boolean

Sort direction (default: true = highest first).

​
timeframe
enum<string>

Window to rank over. Default: lifetime. Time window for cumulative builder stats.

Available options:
lifetime,
1d,
7d,
30d
​
limit
integer<int64>

Max rows to return (default 50, max 500).

​
offset
integer<int64>

Number of rows 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

Ranked list of builders, each with embedded display metadata.

​
builder_code
string
required
​
block
integer<int64>
required
Required range: x >= 0
​
ts
integer<int32>
required
Required range: x >= 0
​
volume_usd
number<double>
required
​
buy_volume_usd
number<double>
required
​
sell_volume_usd
number<double>
required
​
unique_traders
integer<int64>
required
Required range: x >= 0
​
unique_makers
integer<int64>
required
Required range: x >= 0
​
unique_takers
integer<int64>
required
Required range: x >= 0
​
txn_count
integer<int64>
required
Required range: x >= 0
​
buy_count
integer<int64>
required
Required range: x >= 0
​
sell_count
integer<int64>
required
Required range: x >= 0
​
fees_usd
number<double>
required
​
builder_fees
number<double>
required
​
shares_volume
number<double>
required
​
yes_volume_usd
number<double>
required
​
no_volume_usd
number<double>
required
​
yes_count
integer<int64>
required
Required range: x >= 0
​
no_count
integer<int64>
required
Required range: x >= 0
​
buy_dist_under_10
integer<int64>
required
Required range: x >= 0
​
buy_dist_10_100
integer<int64>
required
Required range: x >= 0
​
buy_dist_100_1k
integer<int64>
required
Required range: x >= 0
​
buy_dist_1k_10k
integer<int64>
required
Required range: x >= 0
​
buy_dist_10k_50k
integer<int64>
required
Required range: x >= 0
​
buy_dist_50k_plus
integer<int64>
required
Required range: x >= 0
​
new_users
integer<int64>
required
Required range: x >= 0
​
avg_rev_per_user
number<double>
required

Average revenue per user — builder_fees / unique_traders.

​
avg_vol_per_user
number<double>
required

Average volume per user — volume_usd / unique_traders.

​
builder_maker_fee_rate_bps
integer<int32>
required

Builder's maker fee rate in basis points. Same value across all timeframes — this is a property of the builder, not a windowed metric.

Required range: x >= 0
​
builder_taker_fee_rate_bps
integer<int32>
required

Builder's taker fee rate in basis points. Same scoping as builder_maker_fee_rate_bps.

Required range: x >= 0
​
metadata
object

Builder display metadata (name, links, icon URL, description). null when no metadata has been registered for this builder.

Last modified on May 1, 2026