Portfolio
Get user positions
GET
appIdbearerAuthheader
x-app-id<token>Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.
header
AuthorizationBearer <JWT>JWT access token from POST /auth/verify. Required with x-app-id on user routes. On the smart-route quote it is optional and turns a preview into an executable quote.
cursor?stringlimit?integerRange
1 <= value <= 100venueEventId?stringvenueMarketId?stringstatus?stringactive: shares still held. closed: fully sold or settled.
Value in
"active""closed"categoryIds?array<>|Only positions on events in any of these categories (Category.ids, as /venue-events?categoryIds= takes; a league is a category). At most 20.
sort?"realizedPnl"realizedPnl: highest realized P&L first (e.g. biggest wins with status=closed). Default: stable group order. Live positions only.
Value in
"realizedPnl"mode?stringValue in
"live""paper"200
application/json- response
data*array<>This page of results.
nextCursor*stringPass as cursor to fetch the next page; null on the last page.
hasMore*booleantrue when another page exists.
curl -X GET 'https://api.t.sufwankhalid.com/execution/positions'Example Response
{ "data": [ { "targetMarketId": "cmf3q8yzt009xmw0lh2c5d8kn", "eventId": "cmf3q8yk3008pmw0l6b1s0qfe", "redeemStatus": "ineligible", "status": "active", "resolutionDate": "2026-12-09T19:00:00.000Z", "venueMarket": { "venueEventId": "cmf3q8yk3008pmw0l6b1s0qfe", "question": "Will the Fed cut rates at the December 2026 meeting?", "image": null, "status": "open", "venueMarketOutcomes": [ { "label": "Yes", "title": null, "venueBreakdown": [ { "venue": "polymarket", "venueMarketId": "cmf3q8z0a009zmw0l3w8n6jbd", "venueMarketOutcomeId": "cmf3q8z2m00a4mw0lr5t1k7yc", "size": 30 }, { "venue": "limitless", "venueMarketId": "cmf3q8z0x00a0mw0lc1v7q3mf", "venueMarketOutcomeId": "cmf3q8z3p00a6mw0l9e4h2sxa", "size": 18 } ], "totalSize": 48, "avgEntryPrice": 0.5194, "currentPrice": 0.54, "totalValue": 25.92, "unrealizedPnl": 0.99, "unrealizedPnlPercent": 3.97, "realizedPnl": 0, "winner": null, "priceSource": "orderbook", "bookQuality": "healthy" } ] } } ], "nextCursor": null, "hasMore": false}