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

Maximum number of timeline events to return.

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.

Changes

Changed in 7 of the 31 revisions of this API.108184

Aug 29, 20267c0c7cdd41ee9See the full diff
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
Aug 29, 20268582a359fa0720See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Jul 30, 202619193b17715418110See the full diff
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Jul 14, 202622ab6cfbf30049See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
Jul 1, 20261777a41bfb531See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Jun 1, 2026422bd4dc1611813See the full diff
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  api operation id get_position_timeline removed and replaced with getPositionTimeline
  api-operation-id-removed
- ○
  added the new optional header request parameter If-None-Match
  new-optional-request-parameter
- ○
  added the non-success response with the status
  response-non-success-status-added
May 7, 20262907497f4ca31See the full diff
- ○
  endpoint added
  endpoint-added

Full history