--- title: "List instruments" method: GET path: "/instruments" tags: ["catalog"] --- # List instruments `GET /instruments` Retrieve all instruments. Note that only instruments visible for your tenant will be returned. ## Query parameters - `instrument_type` InstrumentType[] — Return instruments of the given types. - `trading_status` InstrumentTradingStatus[] — Return instruments with the given trading statuses. ## Response `200` OK - union[] - union - Bill - `about` string, nullable — Prose description of the instrument. - `days_to_maturity` integer, required — The number of days until the instrument matures. - `decimal_precision` integer, required — The number of decimal places for this instrument's trading increment. - `enforce_trading_rules` boolean, required - `exchange` string, nullable — MIC code of the exchange (venue) the instrument is listed on. - `id` string, required — Unique resource identifier. - `initial_auction_date` string, date, nullable, required — The initial auction date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument. - `initial_issue_date` string, date, required — The initial issue date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument. - `instrument_type` 'bill', required — The type of instrument. - `isin` string, required — International Securities Identification Number. - `issuer` string, required — The name of the instrument issuer. - `issuer_country` string, nullable, required — The country code (in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of the instrument issuer. - `issuer_credit_rating` string, required — Credit rating from a credit agency e.g AA. - `latest_auction_date` string, date, nullable, required — The latest auction date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument (in case of tap issues). - `latest_issue_date` string, date, nullable, required — The latest issue date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument (in case of tap issues). - `maturity_date` string, date, required — The maturity date of the instrument. - `minimum_initial_cash_investment` string, required - `minimum_trading_quantity` string, required — The minimum trading quantity allowed for the given financial instrument. - `name` string, required — The name of the instrument. - `par_value` string, nullable, required — Nominal denomination per unit against which the price is quoted, as reported by the venue. Varies by market convention: many Euro MTNs quote 1.00, US Treasuries typically 100, and US corporates often 100 or 1000. Stored for reference only. - `price_type` 'percent' | 'money', required - `pro_traders_only` boolean, required — Flag indicating if this instrument is only available to professional (incl. elective) investors under MiFID II. - `required_cash_increment` integer, required - `rollout_stage` 'ga' | 'beta' | 'provisional', required - `supports_automatic_rollover` boolean, required — Flag indicating whether account positions in this instrument can be configured to automatically rollover upon maturity. - `symbol` string, required — A unique, secondary, identifier representing the instrument in financial markets (e.g. ISIN or currency pair). For example, 'US5949181045' for the Apple Inc. stock and 'EUR/USD' for the EUR/USD currency pair. - `ticker` string, nullable — The ticker symbol of the security. - `trading_currency` 'EUR' | 'USD' | 'GBP', required - `trading_increment` string, required — The trading increment refers to the smallest quantity or value of a financial instrument that can be traded. This means orders must be executed in multiples of this increment. - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required - CurrencyPair - `about` string, nullable — Prose description of the instrument. - `base_currency` 'EUR' | 'USD' | 'GBP', required - `decimal_precision` integer, required — The number of decimal places for this instrument's trading increment. - `exchange` string, nullable — MIC code of the exchange (venue) the instrument is listed on. - `id` string, required — Unique resource identifier. - `instrument_type` 'currency_pair', required — The type of instrument. - `name` string, required — The name of the instrument. - `price_type` 'percent' | 'money', required - `pro_traders_only` boolean, required — Flag indicating if this instrument is only available to professional (incl. elective) investors under MiFID II. - `quote_currency` 'EUR' | 'USD' | 'GBP', required - `rollout_stage` 'ga' | 'beta' | 'provisional', required - `symbol` string, required — A unique, secondary, identifier representing the instrument in financial markets (e.g. ISIN or currency pair). For example, 'US5949181045' for the Apple Inc. stock and 'EUR/USD' for the EUR/USD currency pair. - `trading_increment` string, required — The trading increment refers to the smallest quantity or value of a financial instrument that can be traded. This means orders must be executed in multiples of this increment. - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required - Bond - `about` string, nullable — Prose description of the instrument. - `coupon` string, required — The coupon rate of the bond. - `coupon_frequency` 'annual' | 'semi_annual' | 'quarterly' | 'monthly' | 'biennial', required - `coupon_type` 'fixed_coupon' | 'floating_coupon' | 'zero_coupon' | 'stepped_coupon' | 'deferred_coupon' | 'pay_in_kind_coupon' | 'indexed_coupon' | 'credit_linked_coupon', required - `day_count_convention` '30_360' | 'actual_360' | 'actual_365_fixed' | 'actual_actual' - `days_to_maturity` integer, required — The number of days until the instrument matures. - `decimal_precision` integer, required — The number of decimal places for this instrument's trading increment. - `enforce_trading_rules` boolean, required - `exchange` string, nullable — MIC code of the exchange (venue) the instrument is listed on. - `first_coupon_date` string, date, nullable — The date of the first scheduled coupon payment. Present when the bond has an irregular first coupon period; otherwise the schedule is derived from the issue date and coupon frequency. - `id` string, required — Unique resource identifier. - `initial_auction_date` string, date, nullable, required — The initial auction date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument. - `initial_issue_date` string, date, required — The initial issue date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument. - `instrument_type` 'bond', required — The type of instrument. - `isin` string, required — International Securities Identification Number. - `issuer` string, required — The name of the instrument issuer. - `issuer_country` string, nullable, required — The country code (in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of the instrument issuer. - `issuer_credit_rating` string, required — Credit rating from a credit agency e.g AA. - `latest_auction_date` string, date, nullable, required — The latest auction date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument (in case of tap issues). - `latest_issue_date` string, date, nullable, required — The latest issue date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument (in case of tap issues). - `maturity_date` string, date, required — The maturity date of the instrument. - `minimum_initial_cash_investment` string, required - `minimum_trading_quantity` string, required — The minimum trading quantity allowed for the given financial instrument. - `name` string, required — The name of the instrument. - `next_coupon_date` string, date, nullable — The next scheduled coupon payment date as of today, computed from the schedule anchor (`first_coupon_date` if set, otherwise the issue date) and `coupon_frequency`. Null for zero-coupon bonds and for bonds whose final coupon has already been paid. - `par_value` string, nullable, required — Nominal denomination per unit against which the price is quoted, as reported by the venue. Varies by market convention: many Euro MTNs quote 1.00, US Treasuries typically 100, and US corporates often 100 or 1000. Stored for reference only. - `price_type` 'percent' | 'money', required - `pro_traders_only` boolean, required — Flag indicating if this instrument is only available to professional (incl. elective) investors under MiFID II. - `required_cash_increment` integer, required - `rollout_stage` 'ga' | 'beta' | 'provisional', required - `supports_automatic_rollover` boolean, required — Flag indicating whether account positions in this instrument can be configured to automatically rollover upon maturity. - `symbol` string, required — A unique, secondary, identifier representing the instrument in financial markets (e.g. ISIN or currency pair). For example, 'US5949181045' for the Apple Inc. stock and 'EUR/USD' for the EUR/USD currency pair. - `ticker` string, nullable — The ticker symbol of the security. - `trading_currency` 'EUR' | 'USD' | 'GBP', required - `trading_increment` string, required — The trading increment refers to the smallest quantity or value of a financial instrument that can be traded. This means orders must be executed in multiples of this increment. - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required - `upcoming_coupon_amount_per_unit` string, nullable — The cash amount per one unit of held face quantity for the next coupon, derived from the schedule. Null for zero-coupon bonds and for bonds whose final coupon has already been paid. - MoneyMarketFund - `about` string, nullable — Prose description of the instrument. - `benchmark` string, nullable, required — The benchmark (often a market index) used to evaluate the fund's performance. - `dealing_deadline` string, time, required — The dealing deadline time for orders. - `dealing_deadline_time_and_day` string, required — The dealing deadline formatted with time and date. - `decimal_precision` integer, required — The number of decimal places for this instrument's trading increment. - `enforce_trading_rules` boolean, required - `exchange` string, nullable — MIC code of the exchange (venue) the instrument is listed on. - `fund_management_company` string, required — The fund management company. - `fund_ongoing_charges` string, required — The ongoing charges for the fund. - `id` string, required — Unique resource identifier. - `initial_issue_date` string, date, required — The initial issue date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument. - `instrument_type` 'money_market_fund', required — The type of instrument. - `investment_objective` string, nullable, required — The investment objective of the fund. - `is_passed_dealing_deadline` boolean, required — Flag indicating whether the the dealing deadline has passed for today. - `is_qualifying_mmf` boolean, required — Flag indicating whether this is a Qualifying Money Market Fund (QMMF). QMMFs hold mainly short-term, low-risk financial assets, aiming to maintain a stable value. - `isin` string, required — International Securities Identification Number. - `issuer` string, required — The name of the instrument issuer. - `issuer_country` string, nullable, required — The country code (in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of the instrument issuer. - `issuer_credit_rating` string, required — Credit rating from a credit agency e.g AA. - `minimum_initial_cash_investment` string, required - `minimum_trading_quantity` string, required — The minimum trading quantity allowed for the given financial instrument. - `name` string, required — The name of the instrument. - `price_type` 'percent' | 'money', required - `pro_traders_only` boolean, required — Flag indicating if this instrument is only available to professional (incl. elective) investors under MiFID II. - `required_cash_increment` integer, required - `rollout_stage` 'ga' | 'beta' | 'provisional', required - `symbol` string, required — A unique, secondary, identifier representing the instrument in financial markets (e.g. ISIN or currency pair). For example, 'US5949181045' for the Apple Inc. stock and 'EUR/USD' for the EUR/USD currency pair. - `ticker` string, nullable — The ticker symbol of the security. - `trading_currency` 'EUR' | 'USD' | 'GBP', required - `trading_increment` string, required — The trading increment refers to the smallest quantity or value of a financial instrument that can be traded. This means orders must be executed in multiples of this increment. - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required - AMC - `about` string, nullable — Prose description of the instrument. - `dealing_deadline` string, time, required — The dealing deadline time for orders. - `dealing_deadline_time_and_day` string, required — The dealing deadline formatted with time and date. - `decimal_precision` integer, required — The number of decimal places for this instrument's trading increment. - `enforce_trading_rules` boolean, required - `exchange` string, nullable — MIC code of the exchange (venue) the instrument is listed on. - `id` string, required — Unique resource identifier. - `initial_issue_date` string, date, required — The initial issue date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of the instrument. - `instrument_type` 'amc', required — The type of instrument. - `is_passed_dealing_deadline` boolean, required — True if the current time has passed the dealing deadline on a business day. - `isin` string, required — International Securities Identification Number. - `issuer` string, required — The name of the instrument issuer. - `issuer_country` string, nullable, required — The country code (in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of the instrument issuer. - `issuer_credit_rating` string, required — Credit rating from a credit agency e.g AA. - `minimum_initial_cash_investment` string, required - `minimum_trading_quantity` string, required — The minimum trading quantity allowed for the given financial instrument. - `name` string, required — The name of the instrument. - `portfolio_manager` string, nullable, required — The portfolio manager of the AMC. - `price_type` 'percent' | 'money', required - `pro_traders_only` boolean, required — Flag indicating if this instrument is only available to professional (incl. elective) investors under MiFID II. - `provider` string, nullable, required — The provider of the AMC instrument (e.g. UBS). - `required_cash_increment` integer, required - `risk_profile` string, nullable, required — The risk profile of the AMC. - `rollout_stage` 'ga' | 'beta' | 'provisional', required - `share_class` string, nullable, required — The share class of the AMC. - `strategy` string, nullable, required — The investment strategy of the AMC. - `symbol` string, required — A unique, secondary, identifier representing the instrument in financial markets (e.g. ISIN or currency pair). For example, 'US5949181045' for the Apple Inc. stock and 'EUR/USD' for the EUR/USD currency pair. - `ticker` string, nullable — The ticker symbol of the security. - `trading_currency` 'EUR' | 'USD' | 'GBP', required - `trading_increment` string, required — The trading increment refers to the smallest quantity or value of a financial instrument that can be traded. This means orders must be executed in multiples of this increment. - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required - ETF - `about` string, nullable — Prose description of the instrument. - `decimal_precision` integer, required — The number of decimal places for this instrument's trading increment. - `distribution_frequency` 'annual' | 'semi_annual' | 'quarterly' | 'monthly', required - `distribution_policy` 'accumulating' | 'distributing', required - `enforce_trading_rules` boolean, required - `exchange` string, nullable — MIC code of the exchange (venue) the instrument is listed on. - `expense_ratio` string, nullable, required — The total expense ratio (TER) as a decimal fraction of AUM (0.0020 = 0.20%). - `fund_category` string, nullable, required — The Morningstar-style fund category (e.g. Large Blend). - `fund_domicile` string, nullable, required — The fund's domicile country (in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format). - `fund_management` string, nullable, required — The legal fund management company (e.g. Vanguard Group (Ireland) Limited). - `hedge_currency` 'EUR' | 'USD' | 'GBP', required - `id` string, required — Unique resource identifier. - `initial_issue_date` string, date, nullable, required — The fund inception date ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)). - `instrument_type` 'etf', required — The type of instrument. - `isin` string, required — International Securities Identification Number. - `issuer` string, nullable, required — The brand-level fund name (e.g. iShares). The legal entity is in `fund_management`. - `issuer_country` string, nullable, required — The country code (in [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of the instrument issuer. - `minimum_initial_cash_investment` string, required - `minimum_trading_quantity` string, required — The minimum trading quantity allowed for the given financial instrument. - `name` string, required — The name of the instrument. - `net_assets` string, nullable — Total net assets of the fund. - `price_type` 'percent' | 'money', required - `pro_traders_only` boolean, required — Flag indicating if this instrument is only available to professional (incl. elective) investors under MiFID II. - `replication_method` 'physical' | 'sampling' | 'synthetic', required - `required_cash_increment` integer, required - `rollout_stage` 'ga' | 'beta' | 'provisional', required - `sri` 1 | 2 | 3 | 4 | 5 | 6 | 7, required - `symbol` string, required — A unique, secondary, identifier representing the instrument in financial markets (e.g. ISIN or currency pair). For example, 'US5949181045' for the Apple Inc. stock and 'EUR/USD' for the EUR/USD currency pair. - `ticker` string, required — The ticker symbol of the ETF listing. - `tracking_index` string, nullable, required — The index that the ETF tracks. - `trading_currency` 'EUR' | 'USD' | 'GBP', required - `trading_increment` string, required — The trading increment refers to the smallest quantity or value of a financial instrument that can be traded. This means orders must be executed in multiples of this increment. - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required ## Other responses - `400` — Bad Request ## Changes - **2026-07-13** `03da9bc8e86b` — 1 info - api tag `catalog` added [Change history](https://skmtc.dev/joinsophic/apis/sophic-engine-api/changes/instruments/get.md) --- [API](https://skmtc.dev/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.dev/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/revisions/03da9bc8e86b/schema)