GET
/
positions
curl --request GET \
  --url https://data-api.polymarket.com/positions
[
  {
    "proxyWallet": "<string>",
    "asset": "<string>",
    "conditionId": "<string>",
    "size": 123,
    "avgPrice": 123,
    "initialValue": 123,
    "currentValue": 123,
    "cashPnl": 123,
    "percentPnl": 123,
    "totalBought": 123,
    "realizedPnl": 123,
    "percentRealizedPnl": 123,
    "curPrice": 123,
    "redeemable": true,
    "title": "<string>",
    "slug": "<string>",
    "icon": "<string>",
    "eventSlug": "<string>",
    "outcome": "<string>",
    "outcomeIndex": 123,
    "oppositeOutcome": "<string>",
    "oppositeAsset": "<string>",
    "endDate": "2023-12-25",
    "negativeRisk": true
  }
]

Query Parameters

​
user
string
required

The Polygon/Profile address of the user. i.e. 0x6f05f5c...

​
market
string

One or more conditionIds, comma seperated. Cannot be used with eventId.

​
sizeThreshold
number
default:1

The minimum position size to include. Defaults to 1.0.

​
redeemable
boolean

Filter positions that are redeemable.

​
mergeable
boolean

Filter positions that are mergeable.

​
title
string

Filter by market title.

​
eventId
string

The ID of the event. Cannot be used with market.

​
limit
integer
default:50

Max number of positions to return. Defaults to 50, max is 500.

Required range: x <= 500
​
offset
integer
default:0

Index to start paginated results from. Defaults to 0.

​
sortBy
enum<string>

Criteria to sort results by:

  • TOKENS
  • CURRENT
  • INITIAL
  • CASHPNL
  • PERCENTPNL
  • TITLE
  • RESOLVING
  • PRICE
Available options:
TOKENS,
CURRENT,
INITIAL,
CASHPNL,
PERCENTPNL,
TITLE,
RESOLVING,
PRICE
​
sortDirection
enum<string>
default:DESC

Sorting direction, either ASC or DESC. Defaults to DESC.

Available options:
ASC,
DESC

Response

200
application/json

A list of user positions

The response is of type object[].