v25

OpenAPI 3.1.0raw.githubusercontent.com2026-08-015486519.4 KB
Traders

Get a trader's position timeline (unified identity resolver)

Unified trader-timeline route (#4975). {trader} accepts all four identity shapes - 0x... wallet, username, trd_-prefixed trader id, and bare integer id - resolved by the single shared trader-identity resolver. Returns stored Polymarket fills for one tracked 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. Response payload matches the singular GET /api/v1/trader/{address}/position-timeline route for the same (trader, market), except for the per-request meta.request_id. The prior integer-id-only variant is preserved: the same path now accepts every identity shape.

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

Path parameters

traderstring required

Trader identity: 0x... wallet address, username, trd_-prefixed trader id, or bare integer traders.id. Resolved with precedence wallet -> trd_ -> integer -> username. Unknown identities return 404.

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
totalinteger nullable

Total matching rows when the read model exposes a count; absent (or null) when it does not.