Fetch Positions

Fetch current user positions across all markets.

GET /api/{exchange}/fetchPositions

Python

Polymarket

import pmxt

# API key optional — enables faster catalog-backed lookups
exchange = pmxt.Polymarket(
    pmxt_api_key="YOUR_PMXT_API_KEY",
)
result = exchange.fetch_positions(address="0xabc...")

200

{
  "success": true,
  "error": {
    "message": "<string>",
    "retryable": true,
    "exchange": "<string>",
    "detail": {}
  },
  "data": [
    {
      "marketId": "<string>",
      "outcomeId": "<string>",
      "size": 123,
      "outcomeLabel": "<string>",
      "entryPrice": 123,
      "currentPrice": 123,
      "currentValue": 123,
      "unrealizedPnL": 123,
      "realizedPnL": 123,
      "txHash": "<string>",
      "chain": "<string>",
      "blockNumber": 123
    }
  ]
}

Path Parameters

exchange · enum<string> · required

The prediction market exchange to target.

Available options: polymarket, kalshi, kalshi-demo, limitless, probable, baozi, myriad, opinion, metaculus, smarkets, polymarket_us, gemini-titan, hyperliquid, suibets, mock, router

Query Parameters

address · string

Response

200 - application/json

Fetch Positions response

success · boolean

Example:

true

error · object

Structured error envelope returned inside BaseResponse.error and ErrorResponse.error. Hosted-mode endpoints populate code, retryable, and optionally exchange / detail; legacy local-mode endpoints may still return only message.

Show child attributes

data · object[]

Show child attributes