---
title: "Get Positions"
method: GET
path: "/accounts/{account_id}/positions"
tags: ["Money + Positions"]
---

# Get Positions

`GET /accounts/{account_id}/positions`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/positions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/accounts/:account_id/positions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required

## Query parameters

- `cursor` string
- `limit` integer
- `securities_account` string

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponsePositionsResponse
  - `data` PositionsResponse[], required: The elements of the response.
    - `buy_in` string, number, required: The buy-in for this instrument. This is the average price paid for each share. Buying and selling shares will influence this value.
    - `currency` string, required: An ISO 4217 three-letter currency code. Its value represents the currency for prices of the instrument listed here. The only currently available currency is `"EUR"`.
    - `instrument` Instrument, required: A summary of the instrument references in a position.
      - `isin` string, required: An ISIN (International Securities Identification Number) according to ISO 6166. This value uniquely identifies the instrument of this position.
      - `title` string, required: The title of the instrument.
    - `latest_bid` string, number, required: The latest bid. This is a price indication that can be used to determine the profit/loss on a specific position.
    - `latest_price` union, required: An object representing the latest price for an instrument.
      - QuoteLatestPrice: The latest market quote price for an instrument.
        - `amount` string, required: The latest price for a security. Use the instrument's `currency` to interpret this value.
        - `type` 'nav' | 'quote', required: A category representing the source of a price: <ul> <li><code>nav</code>: The price indicates the most recent net asset value (NAV) per share. <li><code>quote</code>: The price indicates the most recent market quote (bid side) for a share. </ul>
        - `updated_at` string, date-time, required: The timestamp when the quote price was last updated.
      - NavLatestPrice: The latest NAV (Net Asset Value) price for an instrument.
        - `amount` string, required: The latest price for a security. Use the instrument's `currency` to interpret this value.
        - `type` 'nav' | 'quote', required: A category representing the source of a price: <ul> <li><code>nav</code>: The price indicates the most recent net asset value (NAV) per share. <li><code>quote</code>: The price indicates the most recent market quote (bid side) for a share. </ul>
        - `valuation_date` string, date, required: The date for which the NAV (Net Asset Value) price is valid.
    - `quantity` string, number, required: The number of shares owned for a specific instrument.
  - `pagination` Pagination, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)