v26

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-045486521.3 KB

Traders

Get a trader's position timeline for one market

Returns stored Polymarket fills for one tracked trader in one market, newest first, with server-computed running_amount and running_avg_price. The {address} segment accepts the same four identity shapes as the plural alias: 0x... wallet, username, trd_-prefixed trader id, or bare integer traders.id, resolved with precedence wallet -> trd_ -> integer -> username. 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.

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

Path parameters

addressstring required

Trader identity: 0x... wallet address, username, trd_-prefixed trader id, or bare integer traders.id. Resolved with precedence wallet -> trd_ -> integer -> username; wallet matching is case-insensitive.

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.