Traders

Get a trader's position timeline for one market

Changed on Sep 23, 2026

Returns stored Polymarket fills for one tracked trader in one market, newest first, with outcome-specific running_amount and running_avg_price including earlier stored fills before pagination. The {address} segment accepts the same identity shapes as the plural alias: wallet, username, trd_-prefixed trader id, bare integer traders.id, or @username, resolved with precedence @username -> wallet -> trd_ -> integer -> username. A leading @ resolves the rest as a username only, which is how to reach an all-digit username that the integer rule reads as an id. Only HOT and WARM traders are served; others return 404. The cumulative buy-weighted fill average is unchanged by sells. Split, merge, redemption and neg-risk activity are excluded; totals are not complete holdings or provider current-position avgPrice. Cursor-paginated; values stay stable across page sizes/cursors for unchanged source history.

get/api/v1/trader/{address}/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/trader/:address/position-timeline/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

addressstring 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); 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

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 (17 revisions)