Sign in
Traders

Get a trader's position timeline for one market

Returns every Polymarket fill for one trader in one market, newest first, with server-computed running_amount and running_avg_price. Only HOT and WARM tier traders are tracked; other traders return 404. running_avg_price is a buy-weighted entry basis (sells do not change the running average) matching Polymarket /positions avgPrice semantics. Cursor-paginated. An id-keyed alias exists at GET /api/v1/traders/{id}/position-timeline.

get/api/v1/trader/{address}/position-timeline

Path parameters

addressstring required

Trader wallet address (0x...) or trd_-prefixed trader ID emitted by this API. Case-insensitive wallet addresses are lowercased server-side.

Query parameters

condition_idstring required

Market condition_id. One timeline per (trader, market).

limitinteger
cursorstring

Pagination cursor from previous response's next_cursor.

Headers

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

Position timeline page

object'list' required
has_moreboolean required
next_cursorstring nullable

Changes