Per-bucket deltas across all builders

GET /polymarket/builders/global/analytics/deltas

Per-bucket deltas across all builders

cURL

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

200

[
  {
    "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.

to · integer<int64>

End ts.

count_back · integer<int64>

Max buckets (default 500, max 2500).

pagination_key · string

Opaque cursor.

Response

200 - application/json

Global per-bucket deltas

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