Skip to main content
GET
/
api
/
accounts
/
{accountId}
/
positions
Get Positions
curl --request GET \
  --url https://trade.predexon.com/api/accounts/{accountId}/positions \
  --header 'x-api-key: <api-key>'
{
  "positions": [
    {
      "venue": "<string>",
      "predexonId": "<string>",
      "title": "<string>",
      "outcome": "<string>",
      "size": "<string>",
      "averagePrice": "<string>",
      "currentPrice": "<string>",
      "currentValue": "<string>",
      "pnl": "<string>",
      "market": {
        "tokenId": "<string>",
        "marketId": "<string>",
        "ticker": "<string>",
        "outcome": "<string>",
        "marketSlug": "<string>",
        "assetId": "<string>"
      }
    }
  ],
  "_meta": {
    "venues": [
      {
        "venue": "<string>"
      }
    ]
  }
}
Omit venue to get positions from every enabled venue, or pass one to filter. Each row carries the canonical predexonId (handy for cross-referencing with the Data API), the position status (active / resolved / redeemable), and live mark-to-market fields (currentPrice, currentValue, pnl). Pass aggregated=true to collapse positions on the same canonical outcome (predexon_id) into single rows: size, currentValue, and pnl are summed; averagePrice and currentPrice are size-weighted averages. Positions on a market without a known canonical equivalent are returned with unresolved: true rather than dropped.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
accountId
string
required

Query Parameters

​
venue
enum<string>
Available options:
polymarket,
predict,
opinion,
limitless,
hyperliquid
​
aggregated
boolean

When true, collapses positions on the same canonical outcome (predexon_id) into single rows. size, currentValue, pnl summed; averagePrice, currentPrice size-weighted averages. Unresolved positions surface with unresolved: true.

Response

Position list

​
positions
object[]
​
_meta
object

Per-plane status metadata on aggregated responses. Surfaces partial failures so clients can detect when a venue timed out or errored while others succeeded.