---
title: "List Account Positions"
method: GET
path: "/accounts/{accountID}/summary/positions"
tags: ["Positions"]
---

# List Account Positions

`GET /accounts/{accountID}/summary/positions`

Retrives a list of Account Positions by accountID

## Path parameters

- `accountID` string, required — The user's unique account identifier.

## Response `200`

Retrieving an Account's Positions by accountID was Successful.

- PositionsRes
  - `accountID` string — The user's unique account identifier.
  - `accountNo` string — The user's unique account number, that is human readable.
  - `tradingType` 'CASH' | 'MARGIN' — The type of trading the account will participate in.
  - `updated` string — Time of last update.
  - `equityValue` number, double — The current total market value of the account's open equity positions.
  - `optionsValue` number, double — The current total market value of the account's open option positions.
  - `debtValue` number, double — The current total market value of the account's open debt positions.
  - `positionsValue` number, double — The current total market value of the account's open positions.
  - `equityPositions` EquityPositionsObj[] — An array of the positions in the account.
    - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
    - `instrumentID` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
    - `ISIN` string — An `International Securities Identification Number` (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. ISINs are commonly used when an Instrument does not have a `symbol`, such as Debt Instruments and Global Mutual Funds.
    - `instrumentType` 'EQUITY' | 'ALTERNATIVE_ASSET' | 'MUTUAL_FUND' | 'DEBT' | 'OPTION' | 'CRYPTO' — The classification of the instrument.
    - `openQty` number — Quantity of shares owned by the account.
    - `costBasis` number — Cost basis of the position.
    - `marketValue` number — Current market value of the position.
    - `side` 'B' — In this case, Side distinguishes the type of position. This will always return 'long'(B).
    - `priorClose` number — The prior closing price of the security.
    - `availableForTradingQty` number — The quantity of the security available for sale.
    - `avgPrice` number — The average price of the position.
    - `mktPrice` number — The current market price of the position.
    - `unrealizedPL` number — Unrealized profit and loss for position.
    - `unrealizedDayPLPercent` number — Unrealized day profit and loss for position in percent.
    - `unrealizedDayPL` number — Unrealized day profit and loss for position.
  - `optionsPositions` OptionsPositionsObj[] — An array of the options positions in the account.
    - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
    - `instrumentID` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
    - `ISIN` string — An `International Securities Identification Number` (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. ISINs are commonly used when an Instrument does not have a `symbol`, such as Debt Instruments and Global Mutual Funds.
    - `instrumentType` 'EQUITY' | 'ALTERNATIVE_ASSET' | 'MUTUAL_FUND' | 'DEBT' | 'OPTION' | 'CRYPTO' — The classification of the instrument.
    - `openQty` number — Quantity of shares owned by the account.
    - `costBasis` number — Cost basis of the position.
    - `marketValue` number — Current market value of the position.
    - `side` 'B' — In this case, Side distinguishes the type of position. This will always return 'long'(B).
    - `priorClose` number — The prior closing price of the security.
    - `availableForTradingQty` number — The quantity of the security available for sale.
    - `avgPrice` number — The average price of the position.
    - `mktPrice` number — The current market price of the position.
    - `unrealizedPL` number — The unrealized profit and loss for the position.
    - `unrealizedDayPLPercent` number — The unrealized day profit and loss for position in percent.
    - `unrealizedDayPL` number — The unrealized day profit and loss for the position.
  - `mutualFundsPositions` MutualFundsPositionsObj[] — An array of the mutual funds positions in the account.
    - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
    - `instrumentID` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
    - `ISIN` string — An `International Securities Identification Number` (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. ISINs are commonly used when an Instrument does not have a `symbol`, such as Debt Instruments and Global Mutual Funds.
    - `instrumentType` 'EQUITY' | 'ALTERNATIVE_ASSET' | 'MUTUAL_FUND' | 'DEBT' | 'OPTION' | 'CRYPTO' — The classification of the instrument.
    - `openQty` number — Quantity of shares owned by the account.
    - `costBasis` number — Cost basis of the position.
    - `marketValue` number — Current market value of the position.
    - `side` 'B' — In this case, Side distinguishes the type of position. This will always return 'long'(B).
    - `priorClose` number — The prior closing price of the security.
    - `availableForTradingQty` number — The quantity of the security available for sale.
    - `avgPrice` number — The average price of the position.
  - `debtPositions` DebtPositionsObj[] — An array of the debt positions in the account.
    - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
    - `instrumentID` string, uuid — A unique ID created by DriveWealth to identify a specific instrument.
    - `ISIN` string — An `International Securities Identification Number` (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. ISINs are commonly used when an Instrument does not have a `symbol`, such as Debt Instruments and Global Mutual Funds.
    - `instrumentType` 'EQUITY' | 'ALTERNATIVE_ASSET' | 'MUTUAL_FUND' | 'DEBT' | 'OPTION' | 'CRYPTO' — The classification of the instrument.
    - `openQty` number — Quantity of shares owned by the account.
    - `costBasis` number — Cost basis of the position.
    - `marketValue` number — Current market value of the position.
    - `side` 'B' — In this case, Side distinguishes the type of position. This will always return 'long'(B).
    - `priorClose` number — The prior closing price of the security.
    - `availableForTradingQty` number — The quantity of the security available for sale.
    - `avgPrice` number — The average price of the position.

---

[API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/revisions/9fced6d0ac41/schema)