For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/list-positions.md.
List open positions
Returns a read-only list of the authenticated user's open positions. Data is fetched on demand from the venue; nothing is persisted.
bearerAuthAuthorizationBearer <JWT>An access token from POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token; a personal token can be refreshed.
TM-On-Behalf-Of?stringAct as one of your organization's users. The value is the user_id returned when the user was created; the request then reads and writes that user's account. Requires an organization token and a user your organization created: 400 for a personal token, a repeated header or a non-UUID, 403 for a user outside your organization. Not accepted on organization-scoped routes.
uuidPositions retrieved successfully
application/json- response
A user's open positions
positions*array<>Open positions
curl -X GET 'https://api.truemarkets.co/v1/gateway/positions' \ -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11'{ "positions": [ { "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4", "venue": "defi", "symbol": "string", "side": "long", "size": "string", "entry_price": "string", "mark_price": "string", "liquidation_price": "string", "margin_used": "string", "unrealized_pnl": "string", "return_on_equity": "string", "leverage": 0 } ]}