Skip to main content
GET
/
v1
/
valuations
/
positions
List position valuations (MTM)
curl --request GET \
  --url https://api.polymarketexchange.com/v1/valuations/positions
{
  "positions": [
    {
      "account": "<string>",
      "symbol": "<string>",
      "netPosition": "<string>",
      "cost": "<string>",
      "realized": "<string>",
      "markPrice": "<string>",
      "markPriceType": "MARK_PRICE_TYPE_LAST",
      "marketValue": "<string>",
      "unrealizedPnl": "<string>",
      "valuationTime": "2023-11-07T05:31:56Z",
      "priceSource": "<string>"
    }
  ],
  "summary": {
    "account": "<string>",
    "currency": "<string>",
    "totalCost": "<string>",
    "totalMarketValue": "<string>",
    "totalUnrealizedPnl": "<string>",
    "totalRealizedPnl": "<string>",
    "positionCount": 123,
    "valuationTime": "2023-11-07T05:31:56Z"
  }
}

Query Parameters

​
name
string
required

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

​
symbol
string

Optional. Filter by symbol.

​
as_of_time
string<date-time>

Optional. Query valuations as of this timestamp. If set, returns historical position valuations. Mutually exclusive with as_of_date.

​
as_of_date.year
integer<int32>

Year for end-of-trading-day valuation query (e.g., 2026). Use with as_of_date.month and as_of_date.day.

​
as_of_date.month
integer<int32>

Month (1-12) for end-of-trading-day valuation query.

Required range: 1 <= x <= 12
​
as_of_date.day
integer<int32>

Day (1-31) for end-of-trading-day valuation query.

Required range: 1 <= x <= 31
​
mark_price_type
enum<string>

Optional. Method for determining mark price. Default is LAST. MarkPriceType specifies how the mark price is determined. LAST uses last traded price, VWAP uses volume-weighted average price (notional / volume), MID uses mid price ((high + low) / 2).

Available options:
MARK_PRICE_TYPE_LAST,
MARK_PRICE_TYPE_VWAP,
MARK_PRICE_TYPE_MID
​
include_zero_positions
boolean

Optional. Include positions with zero quantity. Default is false.

Response

200 - application/json

A successful response.

Response with position valuations.

​
positions
object[]

Position valuations

​
summary
object

Account-level summary