---
title: "Get position ledger"
method: GET
path: "/v1/positions/ledger"
tags: ["Positions"]
---

# Get position ledger

`GET /v1/positions/ledger`

Returns historical position changes for an account.

## Query parameters

- `account` string, required
- `symbol` string
- `start_time` string, date-time
- `end_time` string, date-time
- `page_size` integer
- `page_token` string
- `newest_first` boolean

## Response `200`

A successful response.

- GetPositionLedgerResponse
  - `entries` PositionLedgerEntry[] — Position ledger entries for the requested account / time window.
    - `id` string — Unique entry identifier.
    - `account` string — Account this entry belongs to.
    - `symbol` string — Instrument symbol.
    - `quantityChange` string, int64 — Change in net position quantity (after - before).
    - `costChange` string, int64 — Change in cost basis (after - before).
    - `realizedChange` string, int64 — Change in realized P&L (after - before).
    - `netPosition` string, int64 — Net position quantity after this change.
    - `cost` string, int64 — Cost basis after this change.
    - `realized` string, int64 — Cumulative realized P&L after this change.
    - `updateTime` string, date-time — Timestamp of the position change.
    - `updateBusinessDate` string — Business date for this change in `YYYY-MM-DD` format.
    - `description` string — Human-readable reason for the change (e.g., trade fill, expiry, correction).
  - `nextPageToken` string — Pagination token to fetch the next page. Empty when there are no more results.
  - `eof` boolean — `true` when this response contains the final page of results.

---

[API](https://skmtc.net/polymarket/apis/portfolio-api.md) · [All operations](https://skmtc.net/polymarket/apis/portfolio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polymarket/portfolio-api/revisions/150874842db1/schema)