Positions

Get position ledger

Returns historical position changes for an account.

get/v1/positions/ledger

Request

Base URL
https://api.polymarket.us
Auth
API key in header X-PM-Access-Key and API key in header X-PM-Timestamp and API key in header X-PM-Signature
TypeScript
https://skmtc.dev/polymarket/apis/portfolio-api/docs/v1/positions/ledger/get.ts
A function with typed inputs. Its response is checked against the schema.

accountstring required

Required. Fully qualified resource name of the account. Example: firms/ISV-Alice/accounts/alice-trading.

symbolstring

Optional. Filter by instrument symbol.

start_timestring date-time

Optional. Inclusive lower bound on update_time (RFC3339). Clamped upstream to 2026-05-01T00:00:00Z.

end_timestring date-time

Optional. Inclusive upper bound on update_time (RFC3339).

page_sizeinteger

Optional. Maximum entries to return per page (max 1000). Values above 1000 return InvalidArgument.

page_tokenstring

Optional. Pagination token from a previous response's nextPageToken field. Omit for the first request.

newest_firstboolean

Optional. If true, return entries in descending update_time order. Default is false (oldest first).

A successful response.

nextPageTokenstring

Pagination token to fetch the next page. Empty when there are no more results.

eofboolean

true when this response contains the final page of results.

No recorded changes to this operation across all 1 revision of this API.