Positions
Get Positions
Retrieves all positions for the specified trading account.
get/v1/accounts/{account_id}/positions
Path parameters
account_idinteger required
Account identifier
Query parameters
page_sizeinteger
The number of items to return per page. Only used when page_token is not provided.
page_tokenstring byte
Base64URL-encoded pagination token
Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.
instrument_idsstring[]
Comma-separated instrument identifiers
sort_by'SYMBOL' | 'INSTRUMENT_TYPE' | 'QUANTITY' | 'MARKET_VALUE' | 'POSITION_TYPE' | 'UNREALIZED_PNL' | 'DAILY_UNREALIZED_PNL' | 'DAILY_REALIZED_PNL'
Field to sort by
sort_direction'ASC' | 'DESC'
Sort direction sorted results
Sort direction
Response
List of positions
Example response
{
"error": {
"code": 400,
"message": "Order quantity must be greater than zero"
},
"data": [
{
"account_id": 19816,
"avg_price": "145.00",
"closing_price": "150.50",
"closing_price_date": "2025-10-31",
"cost_basis": "14500.00",
"daily_realized_pnl": "700.00",
"daily_unrealized_pnl": "550.00",
"daily_unrealized_pnl_pct": "3.65",
"instrument_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"instrument_price": "151.00",
"instrument_type": "COMMON_STOCK",
"market_value": "15050.00",
"position_type": "LONG",
"quantity": "100",
"symbol": "AAPL",
"unrealized_pnl": "550.00",
"unrealized_pnl_pct": "3.79"
}
]
}