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

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 5 of the 31 revisions of this API.27180

Aug 29, 20267c0c7cdd41ee9See the full diff
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 400
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 401
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 402
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 403
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 404
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 423
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 429
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 500
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 503
  response-property-enum-value-added
Aug 29, 20268582a359fa0720See the full diff
- ○
  added the optional property meta/ranking_as_of to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 503 status
  response-optional-property-added
Jul 30, 202619193b17715418110See the full diff
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 400
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 401
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 402
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 403
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 404
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 423
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 429
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 500
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 503
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 400
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 401
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 402
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 403
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 404
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 423
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 429
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 500
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 503
  response-property-enum-value-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 503 status
  response-optional-property-added
Jul 14, 202622ab6cfbf30049See the full diff
- ○
  added the optional property error/reason to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 500 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property total to the response with the 200 status
  response-optional-property-added
- ○
  added the required property meta/cost to the response with the 200 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 400 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 401 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 402 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 403 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 404 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 423 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 429 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 500 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 503 status
  response-required-property-added
Jul 1, 20261777a41bfb531See the full diff
- ○
  added the optional property data/items/token_id to the response with the 200 status
  response-optional-property-added

Full history