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
  }
]

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.

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
Required range: x >= 0
​
v
number<double>
required
​
bv
number<double>
required
​
sv
number<double>
required
​
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
​
bc
integer<int64>
required
​
sc
integer<int64>
required
​
f
number<double>
required
​
bf
number<double>
required

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

​
sh
number<double>
required
​
yv
number<double>
required
​
nv
number<double>
required
​
yc
integer<int64>
required
​
nc
integer<int64>
required
​
bd_u10
integer<int64>
required
​
bd_100
integer<int64>
required
​
bd_1k
integer<int64>
required
​
bd_10k
integer<int64>
required
​
bd_50k
integer<int64>
required
​
bd_50p
integer<int64>
required
​
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 May 1, 2026