Skip to main content
GET
/
polymarket
/
builders
/
{builder_code}
/
analytics
/
timeseries
Builder analytics timeseries (cumulative)
curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders/{builder_code}/analytics/timeseries
[
  {
    "t": 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
  }
]

Path Parameters

​
builder_code
string
required

Builder code.

Query Parameters

​
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>

Start timestamp (unix seconds). Omit for all-time.

​
to
integer<int64>

End timestamp (unix seconds).

​
count_back
integer<int32>

Max data points to return (default 500, max 2500).

​
pagination_key
string

Opaque cursor from a previous response.

Response

200 - application/json

Cumulative time-bucketed builder stats

​
t
integer<int32>
required

Bucket start time as Unix seconds.

Required range: x >= 0
​
v
number<double>
required

Volume in USD.

​
bv
number<double>
required

Buy volume in USD.

​
sv
number<double>
required

Sell volume in USD.

​
ut
integer<int64>
required

Distinct trader addresses.

​
um
integer<int64>
required

Distinct maker addresses (order-resting side).

​
uk
integer<int64>
required

Distinct taker addresses (order-initiator side).

​
tc
integer<int64>
required

Transaction count.

​
bc
integer<int64>
required

Buy count.

​
sc
integer<int64>
required

Sell count.

​
f
number<double>
required

Fees in USD.

​
bf
number<double>
required

Builder's share of fees_usd (which is Polymarket's total fee).

​
sh
number<double>
required

Shares volume.

​
yv
number<double>
required

Yes volume in USD.

​
nv
number<double>
required

No volume in USD.

​
yc
integer<int64>
required

Yes count.

​
nc
integer<int64>
required

No count.

​
bd_u10
integer<int64>
required

Buy trade count in the under-10 USD bucket.

​
bd_100
integer<int64>
required

Buy trade count in the 10-100 USD bucket.

​
bd_1k
integer<int64>
required

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

​
bd_10k
integer<int64>
required

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

​
bd_50k
integer<int64>
required

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

​
bd_50p
integer<int64>
required

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

​
nu
integer<int64>
required

Onboarding metric — traders whose first ever builder-attributed trade touched this builder/grain. Cumulative on timeseries, delta on deltas. Each trader contributes at most once globally (any builder).

​
ar
number<double>
required

Average revenue per user — builder_fees / unique_traders. Zero when the bucket has no traders. Cumulative on timeseries, in-window on deltas.

​
av
number<double>
required

Average volume per user — volume_usd / unique_traders. Same scoping as avg_rev_per_user (cumulative on timeseries, in-window on deltas).

Last modified on June 17, 2026