Get trader category PnL candles
Per-category PnL candles for a trader. Same shape as /candles, plus a required category.
Path Parameters
Trader wallet address
Query Parameters
Category to scope candles to. Required. Polymarket UI category.
Politics, Sports, Crypto, Finance, Culture, Mentions, Weather, Economics, Tech 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.
1m, 1h, 4h, 1d, auto Default: lifetime
1d, 7d, 30d, lifetime 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.
End unix seconds. Defaults to now. Synthetic buckets are never emitted past now.
Number of candle buckets to return. Default 500, max 2500. Ignored when resolution=auto (forced to 2500).
Cursor from a previous response
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
Timestamp in epoch seconds at the start of the candle bucket.
x >= 0Opening block for this candle.
Closing block for this candle.
Latest USDC balance at candle close.
Latest pUSD balance at candle close.
Latest open position count at candle close.
Total PnL low value for the candle (= realized + unrealized).
High price.
Open price.
Close price.
Realized PnL low.
Realized PnL high.
Realized PnL open.
Realized PnL close.
Unrealized PnL low.
Unrealized PnL high.
Unrealized PnL open.
Unrealized PnL close.
Portfolio value low.
Portfolio value high.
Portfolio value open.
Portfolio value close.