Sign in
Core

Get current positions for a user

Returns positions filtered by user and optional filters.

get/positions

Request

  • Base URL: https://data-api.polymarket.com
  • URL: https://data-api.polymarket.com/positions
  • Auth: none declared

Query parameters

userstring required

User Profile Address (0x-prefixed, 40 hex chars)

Example:0x56687bf447db6ffa42ffe2204a05edaa20f55839

User address (required)

marketHash64[]

Comma-separated list of condition IDs. Mutually exclusive with eventId.

[
  "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
]
eventIdinteger[]

Comma-separated list of event IDs. Mutually exclusive with market.

sizeThresholdnumber
redeemableboolean
mergeableboolean
limitinteger
offsetinteger
sortBy'CURRENT' | 'INITIAL' | 'TOKENS' | 'CASHPNL' | 'PERCENTPNL' | 'TITLE' | 'RESOLVING' | 'PRICE' | 'AVGPRICE'
sortDirection'ASC' | 'DESC'
titlestring

Response

Success

proxyWalletstring

User Profile Address (0x-prefixed, 40 hex chars)

assetstring
conditionIdstring

0x-prefixed 64-hex string

sizenumber
avgPricenumber
initialValuenumber
currentValuenumber
cashPnlnumber
percentPnlnumber
totalBoughtnumber
realizedPnlnumber
percentRealizedPnlnumber
curPricenumber
redeemableboolean
mergeableboolean
titlestring
slugstring
iconstring
eventSlugstring
outcomestring
outcomeIndexinteger
oppositeOutcomestring
oppositeAssetstring
endDatestring
negativeRiskboolean

Example response

[
  {
    "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
  }
]

Changes

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