Sign in

v1

latestOpenAPI 3.1.02026-07-2496304466.3 KB
Instruments

Get Instrument

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>
get/instruments/{isin}

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%.

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"
    }
  ]
}