Skip to main content
GET
/
polymarket
/
builders
/
composition
Bucketed top-N with 'other' builder composition
curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders/composition
{
  "data": [
    {
      "t": 1,
      "code": "<string>",
      "r": 1,
      "v": 123,
      "bv": 123,
      "sv": 123,
      "ut": 123,
      "um": 123,
      "uk": 123,
      "tc": 123,
      "bc": 123,
      "sc": 123,
      "f": 123,
      "bf": 123,
      "sh": 123,
      "yv": 123,
      "nv": 123,
      "yc": 123,
      "nc": 123,
      "bd_u10": 123,
      "bd_100": 123,
      "bd_1k": 123,
      "bd_10k": 123,
      "bd_50k": 123,
      "bd_50p": 123,
      "nu": 123,
      "ar": 123,
      "av": 123
    }
  ],
  "builder_metadata": {}
}

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

​
metric
enum<string>

Ranking metric used to pick the top-N. 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
​
resolution
enum<string>

Bucket size. Default: 60 (hourly). Bucket size for /analytics/timeseries and /analytics/deltas responses. Each value picks the time interval that one row in the output covers: 60 = 1 hour, 240 = 4 hours, D/1D = 1 day, W/1W = 7 days, M/1M = calendar month.

Available options:
60,
240,
D,
1D,
W,
1W,
M,
1M
​
from
integer<int64>

Inclusive start ts (unix seconds).

​
to
integer<int64>

Inclusive end ts (unix seconds).

​
count_back
integer<int64>

Max buckets returned (default 500, max 2500). Limits the COUNT of bucket rows; the response carries top_n entries per bucket plus one other row.

​
top_n
integer<int32>

Number of top builders broken out individually (clamped 1..50). Default: 10.

Required range: x >= 0
​
series
enum<string>

cumulative (end-of-bucket snapshot) or delta (in-bucket change). Default: cumulative. Series mode — cumulative end-of-bucket snapshot or in-bucket delta.

Available options:
cumulative,
delta

Response

200 - application/json

Bucketed composition rows plus a builder_metadata map keyed by builder_code

Composition response: bucket rows plus a top-level builder_metadata lookup keyed by builder_code. Metadata is returned once per builder here rather than embedded on each bucket row.

​
data
object[]
required

Bucket rows, ordered ascending by t and then by r within each bucket.

​
builder_metadata
object
required

Display metadata for each unique builder code present in data, keyed by builder_code. Builders with no registered metadata are absent from the map. The synthetic "other" aggregate row is never a key here.

Last modified on May 1, 2026