Skip to main content
GET
/
api
/
accounts
/
{accountId}
/
router
/
positions
List Router Positions
curl --request GET \
  --url https://trade.predexon.com/api/accounts/{accountId}/router/positions \
  --header 'x-api-key: <api-key>'
{
  "positions": [
    {
      "unresolved": true,
      "predexonId": "<string>",
      "title": "<string>",
      "outcome": "<string>",
      "size": "<string>",
      "averagePrice": "<string>",
      "currentPrice": "<string>",
      "currentValue": "<string>",
      "pnl": "<string>",
      "venue": "<string>",
      "tokenId": "<string>",
      "venues": [
        {
          "venue": "<string>",
          "size": "<string>",
          "averagePrice": "<string>",
          "currentPrice": "<string>",
          "currentValue": "<string>",
          "pnl": "<string>"
        }
      ]
    }
  ],
  "_meta": {
    "venues": [
      {
        "venue": "<string>"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.predexon.com/llms.txt

Use this file to discover all available pages before exploring further.

Resolved rows (canonical outcome known) carry the aggregate size, averagePrice, currentPrice, currentValue, and pnl summed/weighted across venues, plus a per-venue breakdown. Unresolved rows — positions on a market without a known canonical mapping — appear in the same positions[] array with unresolved: true and carry the plane’s own labels and minimal pricing data only. _meta.venues carries per-venue read status (ok / error) for partial-failure transparency.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
accountId
string
required

Response

200 - application/json

Aggregated positions

Positions held across every routed venue. Rows are either resolved (canonical outcome known — full aggregate + per-venue breakdown) or unresolved (no canonical mapping yet — flagged with unresolved: true, no live-price enrichment).

​
positions
object[]

Mixed array of resolved and unresolved rows. Check the unresolved field to discriminate.

​
_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.