Bucketed top-N with 'other' builder composition

Bucketed timeseries for stacked-bar / area charts. For each bucket in the range, returns up to top_n plus one rows: one per top-N builder plus an other aggregate. Top-N is fixed across the whole window so chart legends stay stable.

GET /polymarket/builders/composition

Bucketed top-N with 'other' builder composition

cURL

curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders/composition

200

{
  "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": {}
}

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.

Show child attributes

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.