---
title: "Account Positions (NEW)"
method: GET
path: "/portfolio2/{accountId}/positions"
tags: ["tradingPortfolio"]
---

# Account Positions (NEW)

`GET /portfolio2/{accountId}/positions`

Returns a list of positions for the given account. /portfolio/accounts or /portfolio/subaccounts must be called prior to this endpoint. This endpoint provides near-real time updates and removes caching otherwise found in the /portfolio/{accountId}/positions/{pageId} endpoint.

## Path parameters

- `accountId` string, required

## Query parameters

- `model` string
- `direction` 'a' | 'd' — The chronologic order of orders to sort by. * `a` - Display in ascending order. * `d` - Display in descending order.

## Response `200`

response with position details

- Portfolio2PositionsItems[] — Array of position objects, each defining a position held in the account.
  - `assetClass` string — Asset class of the requested instrument.
  - `avgCost` unknown
  - `avgPrice` number, double — The account's average price for its position.
  - `conid` integer — IB contract ID for the instrument.
  - `currency` string — Currency in which the instrument trades.
  - `description` string — Contract's local symbol
  - `group` string — Industry sub-categorization of the instrument.
  - `isLastToLoq` boolean
  - `marketPrice` number, double — Current market price of the instrument, in the instrument's currency.
  - `marketValue` number, double — Current market value of the account's position in the instrument, in the instrument's currency.
  - `model` string — Name of the model portfolio in which the account is invested that contributes this position.
  - `position` number, double — Size of position in units of instrument.
  - `realizedPnl` number, double — Realized PnL for the instrument in the instrument's currency.
  - `secType` string — The security type of the instrument.
  - `sector` string — Industry sector categorization of the instrument.
  - `timestamp` integer — Time taken to retrieve position data in milliseconds.
  - `unrealizedPnl` number, double — Unrealized PnL for the instrument in the account.

## Other responses

- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — internal server error, returned when incoming request cannot be processed. It can sometimes include subset of bad requests. For example, wrong accountId passed and it can only be detected later in handling request. Error contains reason of the problem.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)