Skip to main content
GET
Get trader category PnL candles

Path Parameters

address
string
required

Trader wallet address

Query Parameters

category
enum<string>
required

Category to scope candles to. Required. Polymarket UI category.

Available options:
Politics,
Sports,
Crypto,
Finance,
Culture,
Mentions,
Weather,
Economics,
Tech
resolution
enum<string>

Candle bucket size. auto picks the finest resolution that fits the whole span within max count_back (2500) and overrides any caller-supplied count_back. Default: 1m for 1d, 1d otherwise.

Available options:
1m,
1h,
4h,
1d,
auto
timeframe
enum<string>

Default: lifetime

Available options:
1d,
7d,
30d,
lifetime
from
integer<int64>

Start unix seconds. Overrides the timeframe lower bound. Ignored when count_back and to are both supplied — that combination walks count_back buckets back from to.

to
integer<int64>

End unix seconds. Defaults to now. Synthetic buckets are never emitted past now.

count_back
integer<int32>

Number of candle buckets to return. Default 500, max 2500. Ignored when resolution=auto (forced to 2500).

pagination_key
string

Cursor from a previous response

fill_gaps
boolean

Forward-fill buckets the trader had no activity in, carrying the previous close through to to (or now). Default: true. When false, only buckets with activity are returned — no synthetic buckets at all, so the series ends at the trader's last activity rather than at to.

Response

Trader category PnL candles

t
integer<int64>
required

Timestamp in epoch seconds at the start of the candle bucket.

Required range: x >= 0
ob
integer<int64>
required

Opening block for this candle.

cb
integer<int64>
required

Closing block for this candle.

ub
number<double>
required

Latest USDC balance at candle close.

pb
number<double>
required

Latest pUSD balance at candle close.

nop
integer<int32>
required

Latest open position count at candle close.

l
number<double> | null

Total PnL low value for the candle (= realized + unrealized).

h
number<double> | null

High price.

o
number<double> | null

Open price.

c
number<double> | null

Close price.

rl
number<double> | null

Realized PnL low.

rh
number<double> | null

Realized PnL high.

ro
number<double> | null

Realized PnL open.

rc
number<double> | null

Realized PnL close.

ul
number<double> | null

Unrealized PnL low.

uh
number<double> | null

Unrealized PnL high.

uo
number<double> | null

Unrealized PnL open.

uc
number<double> | null

Unrealized PnL close.

pl
number<double> | null

Portfolio value low.

ph
number<double> | null

Portfolio value high.

po
number<double> | null

Portfolio value open.

pc
number<double> | null

Portfolio value close.

Last modified on July 28, 2026