Instruments

Returns details for a specific instrument identified by its ISIN. <strong>Test ISINs for Trading Halts</strong> You can use the following static ISINs to test different predetermined scenarios regarding Trading Halts. The test ISINs are not enabled on our side and are only available in the Sandbox environment.

<ul> <li><code>XF0000000046</code> - <strong>Buy-side halt</strong>: Returns an instrument with an active trading halt on buy orders only <li><code>XF0000000053</code> - <strong>Sell-side halt</strong>: Returns an instrument with an active trading halt on sell orders only <li><code>XF0000000061</code> - <strong>Both-sides halt</strong>: Returns an instrument with an active trading halt on both buy and sell orders </ul> <strong>Note:</strong> <ul> <li>These test ISINs are only available on this endpoint. They will not appear in the <code>GET /instruments</code> listing endpoint. <li>The Sandbox behavior of <code>POST /accounts/{account_id}/orders</code> takes these predefined Trading Halts into account: it will thus return a 422 Error when attempting to create an order that would be Halted. </ul> <strong>Test ISINs for Trading Data</strong> You can use the following static ISINs to test different <code>trading</code> configurations. They are only available in the Sandbox environment and will not appear in the <code>GET /instruments</code> listing endpoint. <ul> <li><code>XF0000000111</code> - <strong>No trading</strong>: Returns an empty <code>trading</code> list, signalling that orders are currently not supported. <li><code>XF0000000129</code> - <strong>Batch and market</strong>: Returns both a <code>batch</code> and a <code>market</code> entry. <li><code>XF0000000137</code> - <strong>Market, fractional off</strong>: A single <code>market</code> entry with an integer <code>minimum_quantity</code> (<code>"1"</code>). <li><code>XF0000000145</code> - <strong>Market, fractional on</strong>: A single <code>market</code> entry with a fractional <code>minimum_quantity</code> (<code>"0.00001"</code>). <li><code>XF0000000152</code> - <strong>Fund with cutoffs</strong>: A fund with a single <code>batch</code> entry that includes both <code>batch_cutoff</code> and <code>prefunding_cutoff</code>. </ul>
get/instruments/{isin}

Request

Path parameters

isinstring required

An ISIN (International Securities Identification Number) according to ISO 6166. This value uniquely identifies the instrument.

Headers

LMG-Data-Privacy-Access-Principalstring required
LMG-Data-Privacy-Access-Justificationstring required

Response

Successful Response

isinstring required

An ISIN (International Securities Identification Number) according to ISO 6166. This value uniquely identifies the instrument of this position.

titlestring 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_pctstring number

A number representing the total expense ratio for a fund. The value is pre-scaled, so "0.07" represents 0.07%.

complexity'non_complex' | 'complex' required

The instrument's complexity classification under MiFID II:

<ul> <li><code>non_complex</code> <li><code>complex</code> </ul>
knowledge_and_experience_profile'basic' | 'extended'

The minimum Knowledge & Experience (K&E) profile a customer must hold to purchase this instrument:

<ul> <li><code>basic</code> <li><code>extended</code> </ul>
product_category'non_complex_products' | 'structured_investment_products' | 'swap_based_ucits_and_alternative_investment_funds' required

The product category that determines which fields in a customer's knowledge and experience data are relevant when assessing whether they may trade this instrument. The values of this field are exactly the top-level keys used in the customer experience profile (<code>/accounts/{account_id}/experience</code>):

<ul> <li><code>non_complex_products</code> <li><code>structured_investment_products</code> <li><code>swap_based_ucits_and_alternative_investment_funds</code> </ul>
days_to_settleinteger required

The number of business days after the trade date on which a transaction in this instrument settles (T+n).

Example response

{
  "isin": "LU1437015735",
  "title": "Amundi Index MSCI Europe UCITS ETF DR",
  "total_expense_ratio_pct": "0.07",
  "active_trading_halts": [
    {
      "valid_from": "2024-01-15T09:30:00.000000+00:00"
    }
  ],
  "days_to_settle": 2,
  "trading": [
    {
      "minimum_quantity": "0.00001"
    }
  ]
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status