Skip to main content
GET
/
api
/
users
/
{userId}
/
positions
# Get all positions
curl -H "x-api-key: YOUR_API_KEY" \
  "https://trade.predexon.com/api/users/550e8400-e29b-41d4-a716-446655440000/positions"

{
  "positions": [
    {
      "venue": "polymarket",
      "marketIdentifier": "polymarket:71321045679252...",
      "tokenId": "71321045679252...",
      "title": "Will Bitcoin reach $100k by 2024?",
      "outcome": "Yes",
      "size": "100.50",
      "status": "active",
      "result": null,
      "averagePrice": "0.45",
      "currentPrice": "0.62",
      "currentValue": "62.31",
      "pnl": "17.08"
    },
    {
      "venue": "predict",
      "marketIdentifier": "predict:46954:103210916722172747942846166716572235061234589599991001208035034049741504775450",
      "tokenId": "103210916722172747942846166716572235061234589599991001208035034049741504775450",
      "title": "NBA: Nuggets vs Lakers | Mar 14, 2026",
      "outcome": "Nuggets",
      "size": "10.38",
      "status": "active",
      "result": null,
      "averagePrice": "0.65",
      "currentPrice": "0.6800",
      "currentValue": "7.06",
      "pnl": "0.31"
    }
  ]
}
For a complete walkthrough, see the Placing Trades guide.
# Get all positions
curl -H "x-api-key: YOUR_API_KEY" \
  "https://trade.predexon.com/api/users/550e8400-e29b-41d4-a716-446655440000/positions"

{
  "positions": [
    {
      "venue": "polymarket",
      "marketIdentifier": "polymarket:71321045679252...",
      "tokenId": "71321045679252...",
      "title": "Will Bitcoin reach $100k by 2024?",
      "outcome": "Yes",
      "size": "100.50",
      "status": "active",
      "result": null,
      "averagePrice": "0.45",
      "currentPrice": "0.62",
      "currentValue": "62.31",
      "pnl": "17.08"
    },
    {
      "venue": "predict",
      "marketIdentifier": "predict:46954:103210916722172747942846166716572235061234589599991001208035034049741504775450",
      "tokenId": "103210916722172747942846166716572235061234589599991001208035034049741504775450",
      "title": "NBA: Nuggets vs Lakers | Mar 14, 2026",
      "outcome": "Nuggets",
      "size": "10.38",
      "status": "active",
      "result": null,
      "averagePrice": "0.65",
      "currentPrice": "0.6800",
      "currentValue": "7.06",
      "pnl": "0.31"
    }
  ]
}

Response Fields

FieldTypeDescription
venuestring"polymarket" or "predict"
marketIdentifierstring (optional)Composite ID (e.g., "polymarket:713..." or "predict:46954:957...")
tokenIdstring (optional)On-chain outcome token ID
titlestring or nullMarket name
outcomestringSide held (e.g., "Yes", "No", team name)
sizestringShares held
statusstring"active", "resolved", or "redeemable"
resultstring or null"won", "lost", or null if active
averagePricestring or nullAverage entry price per share
currentPricestring or nullCurrent market price
currentValuestring or nullTotal value in USDC.e (Polymarket) or USDT (Predict)
pnlstring or nullUnrealized P&L

Query Parameters

ParameterTypeRequiredDescription
venuestringNoFilter by venue: polymarket or predict.

Position Status Values

StatusDescriptionAction
activeMarket is still tradingCan sell via Place Order (Polymarket / Predict)
resolvedMarket has settledCheck result for outcome
redeemablePosition can be cashed outUse Redeem Position

Authorizations

x-api-key
string
header
required

Path Parameters

userId
string
required

Unique identifier for the user

Query Parameters

venue
enum<string>

Filter by venue

Available options:
polymarket,
predict

Response

List of positions

positions
object[]