Positions

Polymarket

Returns every non-zero Polymarket outcome-share position held by a user.

Endpoint

POST /info

Request Body

Parameter	Type	Description
`type`*	string	Must be `"polymarketPositions"`
`user`*	string	20-byte EVM wallet address, e.g., `"0x1111111111111111111111111111111111111111"`

{
  "type": "polymarketPositions",
  "user": "0x1111111111111111111111111111111111111111"
}

Response

200: Positions

{
  "positions": [
    {
      "tokenId": "100",
      "shares": "42.5",
      "availableShares": "40",
      "entryNtl": "21.25"
    },
    {
      "tokenId": "300",
      "shares": "5",
      "availableShares": "5",
      "entryNtl": null
    }
  ]
}

shares is the total held position. availableShares excludes reservations for sell orders and pending merge operations, clamped to zero. Shares remain reserved until the relevant order or operation releases or consumes its hold. Zero-share rows are omitted. Results are sorted by numeric tokenId ascending, not lexicographically. entryNtl is the remaining average-cost entry notional before fees. Divide it by shares to get the average entry price. It is null when the basis is unknowable, including positions restored from older snapshots and positions whose shares came from a split where assigning a per-leg entry price would be arbitrary. A legacy position remains unknown while any of its original shares remain; after it reaches zero, a newly opened position can establish canonical basis normally.

Start Here

Info

Analytics

Exchange

WebSocket

Endpoint

Request Body

Response

​Endpoint

​Request Body

​Response

Endpoint

Request Body

Response