Skip to main content
GET
/
polymarket
/
builders
/
{builder_code}
Get a single builder's cumulative stats
curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders/{builder_code}
{
  "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>"
  }
}

Path Parameters

builder_code
string
required

Builder code.

Query Parameters

timeframe
enum<string>

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

Available options:
lifetime,
1d,
7d,
30d

Response

200 - application/json

Builder snapshot with embedded display metadata.

Latest builder stats with builder display metadata (name, icon, links) merged onto each row. Returned by endpoints that embed display metadata, such as /, /{builder_code}, and /tags/{tag}.

builder_code
string
required

Builder code.

block
integer<int64>
required

Latest block number for the metric snapshot.

Required range: x >= 0
ts
integer<int32>
required

Unix timestamp in seconds.

Required range: x >= 0
volume_usd
number<double>
required

Volume in USD.

buy_volume_usd
number<double>
required

Buy volume in USD.

sell_volume_usd
number<double>
required

Sell volume in USD.

unique_traders
integer<int64>
required

Unique traders.

Required range: x >= 0
unique_makers
integer<int64>
required

Unique makers.

Required range: x >= 0
unique_takers
integer<int64>
required

Unique takers.

Required range: x >= 0
txn_count
integer<int64>
required

Transaction count.

Required range: x >= 0
buy_count
integer<int64>
required

Buy count.

Required range: x >= 0
sell_count
integer<int64>
required

Sell count.

Required range: x >= 0
fees_usd
number<double>
required

Fees in USD.

builder_fees
number<double>
required

Builder fees.

shares_volume
number<double>
required

Shares volume.

yes_volume_usd
number<double>
required

Yes volume in USD.

no_volume_usd
number<double>
required

No volume in USD.

yes_count
integer<int64>
required

Yes count.

Required range: x >= 0
no_count
integer<int64>
required

No count.

Required range: x >= 0
buy_dist_under_10
integer<int64>
required

Buy trade count in the under-10 USD bucket.

Required range: x >= 0
buy_dist_10_100
integer<int64>
required

Buy trade count in the 10-100 USD bucket.

Required range: x >= 0
buy_dist_100_1k
integer<int64>
required

Buy trade count in the 100-1k USD bucket.

Required range: x >= 0
buy_dist_1k_10k
integer<int64>
required

Buy trade count in the 1k-10k USD bucket.

Required range: x >= 0
buy_dist_10k_50k
integer<int64>
required

Buy trade count in the 10k-50k USD bucket.

Required range: x >= 0
buy_dist_50k_plus
integer<int64>
required

Buy trade count in the 50k-plus USD bucket.

Required range: x >= 0
new_users
integer<int64>
required

New users.

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 June 17, 2026