Skip to main content
GET
/
polymarket
/
builders
/
tags
/
{tag}
Per-builder breakdown for a tag
curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders/tags/{tag}
[
  {
    "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,
    "metadata": {
      "name": "<string>",
      "website": "<string>",
      "twitter": "<string>",
      "icon_url": "<string>",
      "description": "<string>"
    }
  }
]

Path Parameters

tag
string
required

Tag label (URL-encoded).

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: lifetime, 1d, 24h, 7d, 30d, 1mo. 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>

Skip count.

pagination_key
string

Opaque cursor.

Response

200 - application/json

Per-builder breakdown, each with embedded display metadata.

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 rev per user.

avg_vol_per_user
number<double>
required

Average vol per user.

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