Traders

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

Changed on Sep 23, 2026

Unified trader-timeline route (#4975). {trader} accepts all five identity shapes - 0x... wallet, username, trd_-prefixed trader id, bare integer id, and @username (a username lookup only, for all-digit usernames) - 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

Request

Base URL
https://api.0xinsider.com
Auth
- HTTP bearer
- or OAuth 2
  Authorization codehttps://0xinsider.com/oauth/authorize
  Token URLhttps://api.0xinsider.com/oauth/token
  Scopesread
TypeScript
https://skmtc.dev/0xinsider/apis/0xinsider-api/docs/api/v1/traders/:trader/position-timeline/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

traderstring required

Trader identity: 0x... wallet address, username, trd_-prefixed trader id, bare integer traders.id, or @username. Resolved with precedence @username -> wallet -> trd_ -> integer -> username (a leading @ forces a username lookup, for all-digit usernames). 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

X-Query-Validation'strict'

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

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

totalinteger

Total matching rows when the read model exposes a count; the key is absent when it does not.

Changes

Sep 23, 2026ece7a25b7a44 Revision changes
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- warning
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Sep 23, 20268462acf80f8c Revision changes
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status
- warning
  added the new export_expired enum value to the / response property for the response status

Operation history (15 revisions)