Skip to main content

GET /api/v1/market/positions/my

Retrieve the authenticated user's open positions across all markets, enriched with event, pool, and market metadata.

Authentication​

Required. Bearer token in Authorization header.

Request​

No query parameters required.

Example​

curl https://intotes.com/api/v1/market/positions/my \
-H "Authorization: Bearer <token>"

Response​

200 OK​

[
{
"id": 501,
"user_id": 7,
"market_id": 42,
"token_type": "YES",
"amount": 1500,
"avg_price": 6200,
"event_id": 10,
"event_name": "Will ETH exceed $4000 by June?",
"pool_id": 5,
"pool_name": "Crypto Predictions",
"market_name": "ETH > $4000",
"side": "YES",
"unrealized_pnl": 320
},
{
"id": 502,
"user_id": 7,
"market_id": 55,
"token_type": "NO",
"amount": 800,
"avg_price": 4500,
"event_id": 12,
"event_name": "Champions League Final Winner",
"pool_id": 8,
"pool_name": "Football",
"market_name": "Real Madrid wins",
"side": "NO",
"unrealized_pnl": -150
}
]

Response Fields​

Returns an array of PositionWithDetails objects.

FieldTypeDescription
idint64Unique position identifier.
user_idint64ID of the position owner.
market_idint64Market the position is in.
token_typestring"YES" or "NO".
amountintNumber of shares held.
avg_priceintAverage entry price in basis points.
event_idint64Parent event ID.
event_namestringName of the parent event.
pool_idint64Parent pool ID.
pool_namestringName of the parent pool.
market_namestringName of the market.
sidestringPosition side: "YES" or "NO".
unrealized_pnlintUnrealized profit/loss in cents based on current market price.

Errors​

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid bearer token.