Cumulative bucket timeseries across all builders

[ { "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 } ]

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 ts (Unix seconds).

integer<int64>

End ts (Unix seconds).

count_back

integer<int64>

Max buckets (default 500, max 2500).

pagination_key

string

Opaque cursor.

Response

200 - application/json

Global cumulative bucket series

integer<int32>

required

Bucket start time as Unix seconds.

Required range: x >= 0

number<double>

required

Volume in USD.

number<double>

required

Buy volume in USD.

number<double>

required

Sell volume in USD.

integer<int64>

required

Distinct trader addresses.

integer<int64>

required

Distinct maker addresses (order-resting side).

integer<int64>

required

Distinct taker addresses (order-initiator side).

integer<int64>

required

Transaction count.

integer<int64>

required

Buy count.

integer<int64>

required

Sell count.

number<double>

required

Fees in USD.

number<double>

required

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

number<double>

required

Shares volume.

number<double>

required

Yes volume in USD.

number<double>

required

No volume in USD.

integer<int64>

required

Yes count.

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.

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).

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.

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).