Polymarket prediction market data endpoints, plus API documentation and monitoring.

Resources & endpoints

Polymarket Users

User Positions

Returns a user's positions with PNL breakdown per outcome token. Each row is one token's cumulative position: cost basis, realized PNL, net shares held, average entry price, and current market price.

Use closed=false for positions on live markets, or closed=true for resolved markets.

GET

https://api.pinax.network/v1/polymarket/users/positions

Requires bearer token — sign in to inject your team’s key.

Required parameters

Name	Type	Description
userrequired query	string · evm-address	undefined Single value or array of values* (separate multiple values with `,`) *Plan restricted.

Optional parameters

Name	Type	Description
token_id query	string	undefined Single value or array of values* (separate multiple values with `,`) *Plan restricted. e.g. 53342136288932702007624506186417846874594504126387502748453102780630218207922
condition_id query	string	undefined Single value or array of values* (separate multiple values with `,`) *Plan restricted. e.g. 0x9708334534b504e2025a5a6af92f8600808c10be577e5066f920c40625fbec16
market_slug query	string	undefined Single value or array of values* (separate multiple values with `,`) *Plan restricted. e.g. will-bitcoin-reach-150k-in-january-2026
closed query	boolean
sort_by query	Enum · 8	position_valuerealized_pnlunrealized_pnltotal_pnlpnl_pcttransactionsavg_pricecurrent_price
limit query	integer	Number of items* returned in a single request. *Plan restricted.
page query	integer	Page number to fetch. Empty `data` array signifies end of results.

Response

200 OK

{
  "data": [
    {
      "user": "0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a",
      "buy_cost": 6438.35,
      "sell_revenue": 247.09,
      "realized_pnl": -6191.26,
      "unrealized_pnl": 9005.64,
      "total_pnl": 2814.38,
      "pnl_pct": -0.96,
      "net_position": 9096.61,
      "avg_price": 0.68,
      "current_price": 0.99,
      "position_value": 9005.64,
      "active": true,
      "buys": 693,
      "sells": 20,
      "transactions": 713,
      "market": {
        "condition_id": "0x59feadddd58e7821c086ee9f3dc4f544514b94ebd0e8d645a3c4d80ebdd354a2",
        "market_slug": "btc-updown-5m-1771359600",
        "token_id": "25362470215305294361999917933416973453076214567033270695579745712197481070383",
        "outcome_label": "Up",
        "closed": false
      }
    }
  ]
}