---
title: "List Instruments"
method: GET
path: "/instruments"
tags: ["Instruments"]
---

# List Instruments

`GET /instruments`

## Query parameters

- `cursor` string
- `limit` integer
- `type` 'etf' | 'fund' | 'stock' — A category specifying the type of a financial instrument: <ul> <li><code>etf</code> <li><code>fund</code> <li><code>stock</code> </ul> <strong>Note:</strong> This list is not final, expect other values to be added in the future.

## Headers

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

## Response `200`

Successful Response

- PageInstrumentResponse
  - `data` InstrumentResponse[], required — The elements of the response.
    - `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.
    - `type` 'etf' | 'fund' | 'stock', required — A category specifying the type of a financial instrument: <ul> <li><code>etf</code> <li><code>fund</code> <li><code>stock</code> </ul> <strong>Note:</strong> This list is not final, expect other values to be added in the future.
    - `fund_profit_model` 'accumulating' | 'distributing' — A category to represent a fund's model for profit use: <ul> <li><code>accumulating</code> <li><code>distributing</code> </ul>
    - `total_expense_ratio_pct` string, number — A number representing the total expense ratio for a fund. The value is pre-scaled, so `"0.07"` represents 0.07%.
    - `regulatory_information` InstrumentRegulatoryInformationResponse, required — An object representing regulatory information regarding the instrument.
      - `kid` string, uri — The KID (Key Investor Document) for the instrument, usually only available for funds.
    - `active_trading_halts` TradingHaltResponse[] — A list of currently active trading halts for this instrument. Trading halts are temporarily applied by lemon.markets, and restrict buy and/or sell operations on the instrument. This field is only present when there are active trading halts. See <code>GET /instruments/{isin}</code> documentation about ISINs that can be used in the Sandbox environment to test Trading Halt scenarios.
      - `valid_from` string, date-time, required — The date and time from which the trading halt has been active.
      - `valid_to` string, date-time — The date and time until which the trading halt is active. If <code>null</code>, the halt doesn't have yet a definite lifting date.
      - `side` 'buy' | 'sell' — A category to represent the side of a customer's order: <ul> <li><code>buy</code>: Buy shares of an instrument and pay with cash. <li><code>sell</code>: Sell shares of an instrument and receive cash. </ul>
  - `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.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/versions/3c8cfd3a96c9/schema)