Skip to main content
GET
/
polymarket
/
tags
/
{tag}
/
analytics
/
deltas
Tag analytics candles (per-bucket deltas)
curl --request GET \
  --url https://api.struct.to/v1/polymarket/tags/{tag}/analytics/deltas
[
  {
    "t": 1,
    "v": 123,
    "bv": 123,
    "sv": 123,
    "tc": 123,
    "bc": 123,
    "sc": 123,
    "rc": 123,
    "rv": 123,
    "mc": 123,
    "mv": 123,
    "sp": 123,
    "spv": 123,
    "f": 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,
    "ut": 123,
    "um": 123,
    "uk": 123
  }
]

Path Parameters

tag
string
required

Tag label (e.g. Politics, Sports)

Query Parameters

resolution
enum<string>

Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) Resolution for /analytics/timeseries and /analytics/deltas. Superset of CandlestickResolution — adds 7-day (W/1W) and calendar month (M/1M) buckets, which are pre-aggregated for global and tag domains and re-bucketed from the _1d MV for market/event/trader.

Available options:
60,
240,
D,
1D,
W,
1W,
M,
1M
from
integer<int64>

Start timestamp (Unix seconds)

to
integer<int64>

End timestamp (Unix seconds)

count_back
integer<int32>

Max data points (default: 500, max: 2500)

pagination_key
string

Cursor from previous response

Response

200 - application/json

Delta time-bucketed tag analytics

t
integer<int32>
required
Required range: x >= 0
v
number<double>
required
bv
number<double>
required
sv
number<double>
required
tc
integer<int64>
required
bc
integer<int64>
required
sc
integer<int64>
required
rc
integer<int64>
required
rv
number<double>
required
mc
integer<int64>
required
mv
number<double>
required
sp
integer<int64>
required
spv
number<double>
required
f
number<double>
required
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

Buy distribution — count of buy trades falling in each USD bucket.

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
ut
integer<int64>
required

Distinct traders ACTIVE in this bucket (window-unique, not first-time).

um
integer<int64>
required

Distinct makers active in this bucket.

uk
integer<int64>
required

Distinct takers active in this bucket.

Last modified on April 25, 2026