---
title: "Instruments"
slug: "instruments"
updated: 2024-09-23T07:22:17Z
published: 2024-09-23T07:22:17Z
canonical: "support.lusid.com/instruments"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instruments

An instrument mastered in LUSID represents a [financial asset](https://www.investopedia.com/terms/f/financialinstrument.asp) you own or have exposure to. Every transaction booked into LUSID in any portfolio must resolve to an instrument stored in the central repository that is the LUSID instrument master. [See the set of supported instruments](/v1/docs/what-instruments-does-lusid-support).

You can master the following types of asset in LUSID:

- Currencies. We prepopulate your LUSID domain with a basket of currencies, but you can [create a new currency](/v1/docs/how-do-i-create-a-currency) if this becomes necessary.
- Simple instruments such as [equities](/v1/docs/modelling-equities-in-lusid).
- Complex OTC or exchange-traded contracts such as [futures](/v1/docs/modelling-exchange-traded-futures-and-options-in-lusid), [FxForwards](/v1/docs/modelling-fxforwards-in-lusid), [bonds](/v1/docs/modelling-fixed-rate-vanilla-bonds-in-lusid), [CFDs](/v1/docs/modelling-cfds-in-lusid), [options](/v1/docs/modelling-exchange-traded-futures-and-options-in-lusid) and [more](/v1/docs/what-instruments-does-lusid-support).
- An entire portfolio (should you wish to [securitise a fund](/v1/docs/setting-up-and-valuing-a-fund-of-funds-portfolio) for benchmarking or other purposes).

To [master an instrument](/v1/docs/how-do-i-master-an-instrument), you specify an economic definition, particular to the type of asset, optionally in a custom instrument [scope](/v1/docs/understanding-instrument-scopes). You can also [add custom properties](/v1/docs/properties) to record additional information if you wish.

Additionally, you specify a set of [identifiers](/v1/docs/understanding-instrument-identifiers) for an instrument. Each identifier maps the instrument to a particular security identification scheme, whether this is to an open standard such as FIGI or PermID, an industry scheme such as ISIN, CUSIP or SEDOL, or to your own internal security database. When data is loaded into LUSID from different sources—each likely referencing the same financial asset using a different identifier—it can be [automatically resolved](/v1/docs/how-does-lusid-resolve-data-to-instruments) to the same, correct instrument. In this way, LUSID consolidates data from different sources, guaranteeing a consistent economic impact but without transforming the ingested data in any way, so it remains meaningful to the originating system.

> **Note**: LUSID is transitioning to a model where it [automatically emits lifecycle events](/v1/docs/understanding-instrument-lifecycle-events-emitted-by-lusid) for mastered instruments, enabling you to handle those events in a seamless and consistent manner.

Providing you have appropriate permissions, you can interact with instruments using the [LUSID web app](https://www.lusid.com/app/home), via the **Data Management > Instruments** menu:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/7144d998-a193-4867-9942-71a21b944c2c.png)

Alternatively, you can interact with instruments programmatically:

- Using the [LUSID REST API](https://www.lusid.com/docs/api/lusid/intro)
- Using the [LUSID SDK](/v1/docs/understanding-all-the-applications-in-the-finbourne-platform) in various languages
- If you have a [Luminesce](/v1/docs/luminesce-and-lumipy) license, using dedicated [read](/v1/docs/lusidinstrumenttype-reader-providers) and [write](/v1/docs/lusidinstrumenttypewriter-providers) providers.

**Explanation**: *See the big picture*

- [Comparing the LUSID instrument model with ISDA CDM and FpML](/v1/docs/comparing-the-lusid-instrument-model-with-isda-cdm-and-fpml)
- [Understanding instrument identifiers](/v1/docs/understanding-instrument-identifiers)
- [Understanding instrument scopes](/v1/docs/understanding-instrument-scopes)
- [Understanding instrument lifecycle events emitted by LUSID](/v1/docs/understanding-instrument-lifecycle-events-emitted-by-lusid)

**Tutorials**: *Get started by doing something tangible*

- [Populating the LUSID instrument master from different data sources](/v1/docs/populating-the-lusid-instrument-master-from-different-data-sources)
- [Handling bond coupon, principal and maturity instrument lifecycle events](/v1/docs/handling-bond-coupon-principal-and-maturity-instrument-lifecycle-events)
- [Handling FxForward settlement and maturity instrument lifecycle events](/v1/docs/handling-fxforward-settlement-and-maturity-instrument-lifecycle-events)

**Reference**: *Understand concepts and implications*

- [What instruments does LUSID support?](/v1/docs/what-instruments-does-lusid-support)

| Quick links: | [Equities](/v1/docs/modelling-equities-in-lusid) | [Bonds](/v1/docs/modelling-fixed-rate-vanilla-bonds-in-lusid) | [Futures](/v1/docs/modelling-exchange-traded-futures-and-options-in-lusid) | [FxForwards](/v1/docs/modelling-fxforwards-in-lusid) | [ETOs](/v1/docs/modelling-exchange-traded-futures-and-options-in-lusid) | [CFDs](/v1/docs/modelling-cfds-in-lusid) | [Equity options](/v1/docs/modelling-equity-options-in-lusid) | [FX options](/v1/docs/modelling-fx-options-in-lusid) |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
- [How does LUSID handle instrument legs?](/v1/docs/how-does-lusid-handle-instrument-legs)
- How does LUSID calculate [exposure](/v1/docs/how-does-lusid-calculate-exposure), [accrued interest](/v1/docs/how-does-lusid-calculate-accrued-interest), [compound interest](/v1/docs/how-does-lusid-calculate-compound-interest), [amortisation/accretion](/v1/docs/how-does-lusid-calculate-amortisation-and-accretion) and [yield to maturity and duration](/v1/docs/how-does-lusid-calculate-yield-to-maturity-and-duration)?
- [What are unique and non-unique identifiers?](/v1/docs/what-are-unique-and-non-unique-identifiers)
- [How does LUSID resolve data to instruments?](/v1/docs/how-does-lusid-resolve-data-to-instruments)
- [What is a LUSID Instrument ID, or LUID?](/v1/docs/what-is-a-lusid-instrument-id-or-luid)
- [What is the unknown instrument, or LUID_ZZZZZZZZ?](/v1/docs/what-is-the-unknown-instrument-or-luid-zzzzzzzz)
- [Manually resolving data items mapped to LUID_ZZZZZZZZ](/v1/docs/manually-resolving-data-mapped-to-luid-zzzzzzzz)

**How-to guides**: *Get something done*

- [How do I create an instrument?](/v1/docs/how-do-i-master-an-instrument)
- [How do I create a currency?](/v1/docs/how-do-i-create-a-currency)
- [How do I list or find instruments already mastered in LUSID?](/v1/docs/how-do-i-list-or-find-instruments-mastered-in-lusid)
- [How do I delete an instrument?](/v1/docs/how-do-i-delete-an-instrument)
