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

# Retrieve an instrument

> Retrieve an instrument by ID or symbol. Note that the instrument has to be visible for your tenant to be accessible.



## OpenAPI

````yaml https://api.engine.usesophic.com/openapi.json get /instruments/{id_or_symbol}
openapi: 3.1.0
info:
  title: Sophic Engine API
  version: 0.1.0
servers:
  - url: https://api.engine.usesophic.com/
security: []
paths:
  /instruments/{id_or_symbol}:
    get:
      summary: Retrieve an instrument
      description: >-
        Retrieve an instrument by ID or symbol. Note that the instrument has to
        be visible for your tenant to be accessible.
      operationId: get_instrument_instruments__id_or_symbol__get
      parameters:
        - name: id_or_symbol
          in: path
          required: true
          schema:
            type: string
            description: The ID or symbol of the instrument to retrieve.
            title: Id Or Symbol
          description: The ID or symbol of the instrument to retrieve.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/Bill'
                  - $ref: '#/components/schemas/CurrencyPair'
                  - $ref: '#/components/schemas/Bond'
                  - $ref: '#/components/schemas/MoneyMarketFund'
                  - $ref: '#/components/schemas/AMC'
                  - $ref: '#/components/schemas/ETF'
                discriminator:
                  propertyName: instrument_type
                  mapping:
                    bill:
                      $ref: '#/components/schemas/Bill'
                    currency_pair:
                      $ref: '#/components/schemas/CurrencyPair'
                    bond:
                      $ref: '#/components/schemas/Bond'
                    money_market_fund:
                      $ref: '#/components/schemas/MoneyMarketFund'
                    amc:
                      $ref: '#/components/schemas/AMC'
                    etf:
                      $ref: '#/components/schemas/ETF'
                title: Response Get Instrument Instruments  Id Or Symbol  Get
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - HTTPBearer: []
components:
  schemas:
    Bill:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        name:
          type: string
          title: Name
          description: The name of the instrument.
        symbol:
          type: string
          title: Symbol
          description: >-
            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. 
        instrument_type:
          const: bill
          title: Instrument Type
          description: The type of instrument.
        trading_status:
          allOf:
            - $ref: '#/components/schemas/InstrumentTradingStatus'
          description: The trading status of the instrument.
        rollout_stage:
          anyOf:
            - $ref: '#/components/schemas/InstrumentRolloutStage'
            - type: 'null'
          description: >-
            The rollout stage of the instrument. GA instruments are visible to
            every user; BETA instruments are visible only to pilot users.
        trading_increment:
          type: string
          title: Trading Increment
          description: >-
            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.
        decimal_precision:
          type: integer
          title: Decimal Precision
          description: >-
            The number of decimal places for this instrument's trading
            increment.
        pro_traders_only:
          type: boolean
          title: Pro Traders Only
          description: >-
            Flag indicating if this instrument is only available to professional
            (incl. elective) investors under MiFID II.
        price_type:
          allOf:
            - $ref: '#/components/schemas/PriceType'
          description: The type of price for this instrument.
        isin:
          type: string
          title: Isin
          description: International Securities Identification Number.
        ticker:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticker
          description: The ticker symbol of the security.
        issuer:
          type: string
          title: Issuer
          description: The name of the instrument issuer.
        issuer_country:
          anyOf:
            - type: string
            - type: 'null'
          title: Issuer Country
          description: >-
            The country code (in [ISO 3166-1
            alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of
            the instrument issuer.
        minimum_trading_quantity:
          type: string
          title: Minimum Trading Quantity
          description: >-
            The minimum trading quantity allowed for the given financial
            instrument.
        trading_currency:
          allOf:
            - $ref: '#/components/schemas/Currency'
          description: The instrument's trading currency.
        initial_issue_date:
          type: string
          format: date
          title: Initial Issue Date
          description: >-
            The initial issue date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument.
        enforce_trading_rules:
          type: boolean
          title: Enforce Trading Rules
        minimum_initial_cash_investment:
          type: string
          title: Minimum Initial Cash Investment
        required_cash_increment:
          type: integer
          title: Required Cash Increment
        maturity_date:
          type: string
          format: date
          title: Maturity Date
          description: The maturity date of the instrument.
        days_to_maturity:
          type: integer
          title: Days To Maturity
          description: The number of days until the instrument matures.
        supports_automatic_rollover:
          type: boolean
          title: Supports Automatic Rollover
          description: >-
            Flag indicating whether account positions in this instrument can be
            configured to automatically rollover upon maturity.
        issuer_credit_rating:
          type: string
          title: Issuer Credit Rating
          description: Credit rating from a credit agency e.g AA.
        initial_auction_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Initial Auction Date
          description: >-
            The initial auction date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument.
        latest_auction_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Latest Auction Date
          description: >-
            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:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Latest Issue Date
          description: >-
            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).
        par_value:
          anyOf:
            - type: string
            - type: 'null'
          title: Par Value
          description: >-
            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.
      type: object
      required:
        - id
        - name
        - symbol
        - instrument_type
        - trading_status
        - rollout_stage
        - trading_increment
        - decimal_precision
        - pro_traders_only
        - price_type
        - isin
        - issuer_country
        - minimum_trading_quantity
        - trading_currency
        - initial_issue_date
        - enforce_trading_rules
        - minimum_initial_cash_investment
        - required_cash_increment
        - maturity_date
        - days_to_maturity
        - supports_automatic_rollover
        - issuer_credit_rating
        - initial_auction_date
        - latest_auction_date
        - latest_issue_date
        - par_value
      title: Bill
    CurrencyPair:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        name:
          type: string
          title: Name
          description: The name of the instrument.
        symbol:
          type: string
          title: Symbol
          description: >-
            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. 
        instrument_type:
          const: currency_pair
          title: Instrument Type
          description: The type of instrument.
        trading_status:
          allOf:
            - $ref: '#/components/schemas/InstrumentTradingStatus'
          description: The trading status of the instrument.
        rollout_stage:
          anyOf:
            - $ref: '#/components/schemas/InstrumentRolloutStage'
            - type: 'null'
          description: >-
            The rollout stage of the instrument. GA instruments are visible to
            every user; BETA instruments are visible only to pilot users.
        trading_increment:
          type: string
          title: Trading Increment
          description: >-
            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.
        decimal_precision:
          type: integer
          title: Decimal Precision
          description: >-
            The number of decimal places for this instrument's trading
            increment.
        pro_traders_only:
          type: boolean
          title: Pro Traders Only
          description: >-
            Flag indicating if this instrument is only available to professional
            (incl. elective) investors under MiFID II.
        price_type:
          allOf:
            - $ref: '#/components/schemas/PriceType'
          description: The type of price for this instrument.
        base_currency:
          allOf:
            - $ref: '#/components/schemas/Currency'
          description: >-
            The base currency of the currency pair. For example, in EUR/USD, EUR
            is the base currency. When placing FX orders, you are always trading
            the base currency.
        quote_currency:
          allOf:
            - $ref: '#/components/schemas/Currency'
          description: >-
            The quote currency of the currency pair. For example, in EUR/USD,
            USD is the quote currency.
      type: object
      required:
        - id
        - name
        - symbol
        - instrument_type
        - trading_status
        - rollout_stage
        - trading_increment
        - decimal_precision
        - pro_traders_only
        - price_type
        - base_currency
        - quote_currency
      title: CurrencyPair
    Bond:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        name:
          type: string
          title: Name
          description: The name of the instrument.
        symbol:
          type: string
          title: Symbol
          description: >-
            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. 
        instrument_type:
          const: bond
          title: Instrument Type
          description: The type of instrument.
        trading_status:
          allOf:
            - $ref: '#/components/schemas/InstrumentTradingStatus'
          description: The trading status of the instrument.
        rollout_stage:
          anyOf:
            - $ref: '#/components/schemas/InstrumentRolloutStage'
            - type: 'null'
          description: >-
            The rollout stage of the instrument. GA instruments are visible to
            every user; BETA instruments are visible only to pilot users.
        trading_increment:
          type: string
          title: Trading Increment
          description: >-
            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.
        decimal_precision:
          type: integer
          title: Decimal Precision
          description: >-
            The number of decimal places for this instrument's trading
            increment.
        pro_traders_only:
          type: boolean
          title: Pro Traders Only
          description: >-
            Flag indicating if this instrument is only available to professional
            (incl. elective) investors under MiFID II.
        price_type:
          allOf:
            - $ref: '#/components/schemas/PriceType'
          description: The type of price for this instrument.
        isin:
          type: string
          title: Isin
          description: International Securities Identification Number.
        ticker:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticker
          description: The ticker symbol of the security.
        issuer:
          type: string
          title: Issuer
          description: The name of the instrument issuer.
        issuer_country:
          anyOf:
            - type: string
            - type: 'null'
          title: Issuer Country
          description: >-
            The country code (in [ISO 3166-1
            alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of
            the instrument issuer.
        minimum_trading_quantity:
          type: string
          title: Minimum Trading Quantity
          description: >-
            The minimum trading quantity allowed for the given financial
            instrument.
        trading_currency:
          allOf:
            - $ref: '#/components/schemas/Currency'
          description: The instrument's trading currency.
        initial_issue_date:
          type: string
          format: date
          title: Initial Issue Date
          description: >-
            The initial issue date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument.
        enforce_trading_rules:
          type: boolean
          title: Enforce Trading Rules
        minimum_initial_cash_investment:
          type: string
          title: Minimum Initial Cash Investment
        required_cash_increment:
          type: integer
          title: Required Cash Increment
        maturity_date:
          type: string
          format: date
          title: Maturity Date
          description: The maturity date of the instrument.
        days_to_maturity:
          type: integer
          title: Days To Maturity
          description: The number of days until the instrument matures.
        supports_automatic_rollover:
          type: boolean
          title: Supports Automatic Rollover
          description: >-
            Flag indicating whether account positions in this instrument can be
            configured to automatically rollover upon maturity.
        issuer_credit_rating:
          type: string
          title: Issuer Credit Rating
          description: Credit rating from a credit agency e.g AA.
        initial_auction_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Initial Auction Date
          description: >-
            The initial auction date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument.
        latest_auction_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Latest Auction Date
          description: >-
            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:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Latest Issue Date
          description: >-
            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).
        par_value:
          anyOf:
            - type: string
            - type: 'null'
          title: Par Value
          description: >-
            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.
        coupon_type:
          allOf:
            - $ref: '#/components/schemas/BondCouponType'
          description: The type of coupon payment (e.g., fixed, floating, zero-coupon).
        coupon_frequency:
          anyOf:
            - $ref: '#/components/schemas/BondCouponFrequency'
            - type: 'null'
          description: >-
            The frequency of coupon payments (e.g., annual, semi-annual,
            quarterly).
        coupon:
          type: string
          title: Coupon
          description: The coupon rate of the bond.
        first_coupon_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: First Coupon Date
          description: >-
            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.
        next_coupon_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Next Coupon Date
          description: >-
            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.
        day_count_convention:
          anyOf:
            - $ref: '#/components/schemas/DayCountConvention'
            - type: 'null'
          description: >-
            Day count convention used by the venue / pricing provider to compute
            accrued interest. Sophic stores this as metadata only; accrued
            interest is not computed in-house. Null for zero-coupon bonds — they
            don't accrue.
        upcoming_coupon_amount_per_unit:
          anyOf:
            - type: string
            - type: 'null'
          title: Upcoming Coupon Amount Per Unit
          description: >-
            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.
      type: object
      required:
        - id
        - name
        - symbol
        - instrument_type
        - trading_status
        - rollout_stage
        - trading_increment
        - decimal_precision
        - pro_traders_only
        - price_type
        - isin
        - issuer_country
        - minimum_trading_quantity
        - trading_currency
        - initial_issue_date
        - enforce_trading_rules
        - minimum_initial_cash_investment
        - required_cash_increment
        - maturity_date
        - days_to_maturity
        - supports_automatic_rollover
        - issuer_credit_rating
        - initial_auction_date
        - latest_auction_date
        - latest_issue_date
        - par_value
        - coupon_type
        - coupon_frequency
        - coupon
      title: Bond
    MoneyMarketFund:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        name:
          type: string
          title: Name
          description: The name of the instrument.
        symbol:
          type: string
          title: Symbol
          description: >-
            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. 
        instrument_type:
          const: money_market_fund
          title: Instrument Type
          description: The type of instrument.
        trading_status:
          allOf:
            - $ref: '#/components/schemas/InstrumentTradingStatus'
          description: The trading status of the instrument.
        rollout_stage:
          anyOf:
            - $ref: '#/components/schemas/InstrumentRolloutStage'
            - type: 'null'
          description: >-
            The rollout stage of the instrument. GA instruments are visible to
            every user; BETA instruments are visible only to pilot users.
        trading_increment:
          type: string
          title: Trading Increment
          description: >-
            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.
        decimal_precision:
          type: integer
          title: Decimal Precision
          description: >-
            The number of decimal places for this instrument's trading
            increment.
        pro_traders_only:
          type: boolean
          title: Pro Traders Only
          description: >-
            Flag indicating if this instrument is only available to professional
            (incl. elective) investors under MiFID II.
        price_type:
          allOf:
            - $ref: '#/components/schemas/PriceType'
          description: The type of price for this instrument.
        isin:
          type: string
          title: Isin
          description: International Securities Identification Number.
        ticker:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticker
          description: The ticker symbol of the security.
        issuer:
          type: string
          title: Issuer
          description: The name of the instrument issuer.
        issuer_country:
          anyOf:
            - type: string
            - type: 'null'
          title: Issuer Country
          description: >-
            The country code (in [ISO 3166-1
            alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of
            the instrument issuer.
        minimum_trading_quantity:
          type: string
          title: Minimum Trading Quantity
          description: >-
            The minimum trading quantity allowed for the given financial
            instrument.
        trading_currency:
          allOf:
            - $ref: '#/components/schemas/Currency'
          description: The instrument's trading currency.
        initial_issue_date:
          type: string
          format: date
          title: Initial Issue Date
          description: >-
            The initial issue date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument.
        enforce_trading_rules:
          type: boolean
          title: Enforce Trading Rules
        minimum_initial_cash_investment:
          type: string
          title: Minimum Initial Cash Investment
        required_cash_increment:
          type: integer
          title: Required Cash Increment
        issuer_credit_rating:
          type: string
          title: Issuer Credit Rating
          description: Credit rating from a credit agency e.g AA.
        dealing_deadline:
          type: string
          format: time
          title: Dealing Deadline
          description: The dealing deadline time for orders.
        dealing_deadline_time_and_day:
          type: string
          title: Dealing Deadline Time And Day
          description: The dealing deadline formatted with time and date.
        fund_management_company:
          type: string
          title: Fund Management Company
          description: The fund management company.
        investment_objective:
          type: string
          title: Investment Objective
          description: The investment objective of the fund.
        is_passed_dealing_deadline:
          type: boolean
          title: Is Passed Dealing Deadline
          description: >-
            Flag indicating whether the the dealing deadline has passed for
            today.
        benchmark:
          anyOf:
            - type: string
            - type: 'null'
          title: Benchmark
          description: >-
            The benchmark (often a market index) used to evaluate the fund's
            performance.
        fund_ongoing_charges:
          type: string
          title: Fund Ongoing Charges
          description: The ongoing charges for the fund.
        is_qualifying_mmf:
          type: boolean
          title: Is Qualifying Mmf
          description: >-
            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.
      type: object
      required:
        - id
        - name
        - symbol
        - instrument_type
        - trading_status
        - rollout_stage
        - trading_increment
        - decimal_precision
        - pro_traders_only
        - price_type
        - isin
        - issuer_country
        - minimum_trading_quantity
        - trading_currency
        - initial_issue_date
        - enforce_trading_rules
        - minimum_initial_cash_investment
        - required_cash_increment
        - issuer_credit_rating
        - dealing_deadline
        - dealing_deadline_time_and_day
        - fund_management_company
        - investment_objective
        - is_passed_dealing_deadline
        - benchmark
        - fund_ongoing_charges
        - is_qualifying_mmf
      title: MoneyMarketFund
    AMC:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        name:
          type: string
          title: Name
          description: The name of the instrument.
        symbol:
          type: string
          title: Symbol
          description: >-
            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. 
        instrument_type:
          const: amc
          title: Instrument Type
          description: The type of instrument.
        trading_status:
          allOf:
            - $ref: '#/components/schemas/InstrumentTradingStatus'
          description: The trading status of the instrument.
        rollout_stage:
          anyOf:
            - $ref: '#/components/schemas/InstrumentRolloutStage'
            - type: 'null'
          description: >-
            The rollout stage of the instrument. GA instruments are visible to
            every user; BETA instruments are visible only to pilot users.
        trading_increment:
          type: string
          title: Trading Increment
          description: >-
            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.
        decimal_precision:
          type: integer
          title: Decimal Precision
          description: >-
            The number of decimal places for this instrument's trading
            increment.
        pro_traders_only:
          type: boolean
          title: Pro Traders Only
          description: >-
            Flag indicating if this instrument is only available to professional
            (incl. elective) investors under MiFID II.
        price_type:
          allOf:
            - $ref: '#/components/schemas/PriceType'
          description: The type of price for this instrument.
        isin:
          type: string
          title: Isin
          description: International Securities Identification Number.
        ticker:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticker
          description: The ticker symbol of the security.
        issuer:
          type: string
          title: Issuer
          description: The name of the instrument issuer.
        issuer_country:
          anyOf:
            - type: string
            - type: 'null'
          title: Issuer Country
          description: >-
            The country code (in [ISO 3166-1
            alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of
            the instrument issuer.
        minimum_trading_quantity:
          type: string
          title: Minimum Trading Quantity
          description: >-
            The minimum trading quantity allowed for the given financial
            instrument.
        trading_currency:
          allOf:
            - $ref: '#/components/schemas/Currency'
          description: The instrument's trading currency.
        initial_issue_date:
          type: string
          format: date
          title: Initial Issue Date
          description: >-
            The initial issue date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument.
        enforce_trading_rules:
          type: boolean
          title: Enforce Trading Rules
        minimum_initial_cash_investment:
          type: string
          title: Minimum Initial Cash Investment
        required_cash_increment:
          type: integer
          title: Required Cash Increment
        issuer_credit_rating:
          type: string
          title: Issuer Credit Rating
          description: Credit rating from a credit agency e.g AA.
        dealing_deadline:
          type: string
          format: time
          title: Dealing Deadline
          description: The dealing deadline time for orders.
        dealing_deadline_time_and_day:
          type: string
          title: Dealing Deadline Time And Day
          description: The dealing deadline formatted with time and date.
        is_passed_dealing_deadline:
          type: boolean
          title: Is Passed Dealing Deadline
          description: >-
            True if the current time has passed the dealing deadline on a
            business day.
        strategy:
          anyOf:
            - type: string
            - type: 'null'
          title: Strategy
          description: The investment strategy of the AMC.
        risk_profile:
          anyOf:
            - type: string
            - type: 'null'
          title: Risk Profile
          description: The risk profile of the AMC.
        portfolio_manager:
          anyOf:
            - type: string
            - type: 'null'
          title: Portfolio Manager
          description: The portfolio manager of the AMC.
        share_class:
          anyOf:
            - type: string
            - type: 'null'
          title: Share Class
          description: The share class of the AMC.
        provider:
          anyOf:
            - type: string
            - type: 'null'
          title: Provider
          description: The provider of the AMC instrument (e.g. UBS).
      type: object
      required:
        - id
        - name
        - symbol
        - instrument_type
        - trading_status
        - rollout_stage
        - trading_increment
        - decimal_precision
        - pro_traders_only
        - price_type
        - isin
        - issuer_country
        - minimum_trading_quantity
        - trading_currency
        - initial_issue_date
        - enforce_trading_rules
        - minimum_initial_cash_investment
        - required_cash_increment
        - issuer_credit_rating
        - dealing_deadline
        - dealing_deadline_time_and_day
        - is_passed_dealing_deadline
        - strategy
        - risk_profile
        - portfolio_manager
        - share_class
        - provider
      title: AMC
    ETF:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        name:
          type: string
          title: Name
          description: The name of the instrument.
        symbol:
          type: string
          title: Symbol
          description: >-
            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. 
        instrument_type:
          const: etf
          title: Instrument Type
          description: The type of instrument.
        trading_status:
          allOf:
            - $ref: '#/components/schemas/InstrumentTradingStatus'
          description: The trading status of the instrument.
        rollout_stage:
          anyOf:
            - $ref: '#/components/schemas/InstrumentRolloutStage'
            - type: 'null'
          description: >-
            The rollout stage of the instrument. GA instruments are visible to
            every user; BETA instruments are visible only to pilot users.
        trading_increment:
          type: string
          title: Trading Increment
          description: >-
            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.
        decimal_precision:
          type: integer
          title: Decimal Precision
          description: >-
            The number of decimal places for this instrument's trading
            increment.
        pro_traders_only:
          type: boolean
          title: Pro Traders Only
          description: >-
            Flag indicating if this instrument is only available to professional
            (incl. elective) investors under MiFID II.
        price_type:
          allOf:
            - $ref: '#/components/schemas/PriceType'
          description: The type of price for this instrument.
        isin:
          type: string
          title: Isin
          description: International Securities Identification Number.
        ticker:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticker
          description: The ticker symbol of the security.
        issuer:
          type: string
          title: Issuer
          description: The name of the instrument issuer.
        issuer_country:
          anyOf:
            - type: string
            - type: 'null'
          title: Issuer Country
          description: >-
            The country code (in [ISO 3166-1
            alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of
            the instrument issuer.
        minimum_trading_quantity:
          type: string
          title: Minimum Trading Quantity
          description: >-
            The minimum trading quantity allowed for the given financial
            instrument.
        trading_currency:
          allOf:
            - $ref: '#/components/schemas/Currency'
          description: The instrument's trading currency.
        initial_issue_date:
          type: string
          format: date
          title: Initial Issue Date
          description: >-
            The initial issue date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument.
        enforce_trading_rules:
          type: boolean
          title: Enforce Trading Rules
        minimum_initial_cash_investment:
          type: string
          title: Minimum Initial Cash Investment
        required_cash_increment:
          type: integer
          title: Required Cash Increment
        fund_provider:
          type: string
          title: Fund Provider
          description: The provider of the ETF.
        fund_domicile:
          type: string
          title: Fund Domicile
          description: The domicile of the ETF.
        tracking_index:
          type: string
          title: Tracking Index
          description: The index that the ETF tracks.
        expense_ratio:
          type: string
          title: Expense Ratio
          description: The expense ratio of the ETF.
        replication_method:
          type: string
          title: Replication Method
          description: The method of replication of the ETF.
        distribution_policy:
          type: string
          title: Distribution Policy
          description: The distribution policy of the ETF.
        exchange_mic:
          type: string
          title: Exchange Mic
          description: The exchange mic of the ETF.
      type: object
      required:
        - id
        - name
        - symbol
        - instrument_type
        - trading_status
        - rollout_stage
        - trading_increment
        - decimal_precision
        - pro_traders_only
        - price_type
        - isin
        - issuer_country
        - minimum_trading_quantity
        - trading_currency
        - initial_issue_date
        - enforce_trading_rules
        - minimum_initial_cash_investment
        - required_cash_increment
        - fund_provider
        - fund_domicile
        - tracking_index
        - expense_ratio
        - replication_method
        - distribution_policy
        - exchange_mic
      title: ETF
    Error:
      properties:
        detail:
          type: string
          title: Detail
          description: A human-readable description of the error.
        code:
          type: string
          title: Code
          description: A machine-readable error code.
        docs:
          title: Docs
          description: A URL to documentation about this error code.
          x-remove-null-from-type-union: true
          type: string
        context:
          title: Context
          description: An optional object for adding extra context to the error.
          x-remove-null-from-type-union: true
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
          type: object
        params:
          title: Params
          description: An optional list of params that failed validation.
          x-remove-null-from-type-union: true
          items:
            $ref: '#/components/schemas/InvalidParam'
          type: array
      type: object
      required:
        - detail
        - code
      title: Error
    InstrumentTradingStatus:
      type: string
      enum:
        - buy_sell
        - buy_only
        - sell_only
        - not_trading
      title: InstrumentTradingStatus
      properties: {}
    InstrumentRolloutStage:
      type: string
      enum:
        - ga
        - beta
      title: InstrumentRolloutStage
      properties: {}
    PriceType:
      type: string
      enum:
        - percent
        - money
      title: PriceType
      properties: {}
    Currency:
      type: string
      enum:
        - EUR
        - USD
        - GBP
      title: Currency
      properties: {}
    BondCouponType:
      type: string
      enum:
        - fixed_coupon
        - floating_coupon
        - zero_coupon
        - stepped_coupon
        - deferred_coupon
        - pay_in_kind_coupon
        - indexed_coupon
        - credit_linked_coupon
      title: BondCouponType
      properties: {}
    BondCouponFrequency:
      type: string
      enum:
        - annual
        - semi_annual
        - quarterly
        - monthly
        - biennial
      title: BondCouponFrequency
      properties: {}
    DayCountConvention:
      type: string
      enum:
        - '30_360'
        - actual_360
        - actual_365_fixed
        - actual_actual
      title: DayCountConvention
      properties: {}
    InvalidParam:
      properties:
        path:
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
          title: Path
          description: Path to the field name (or index if a list) that errored.
        detail:
          type: string
          title: Detail
          description: Human-readable detail for error.
        code:
          type: string
          title: Code
          description: A machine-readable error code.
      type: object
      required:
        - path
        - detail
        - code
      title: InvalidParam
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````