naftiko: 1.0.0-alpha2
info:
  label: FactSet Real-Time Quotes API — Instrument
  description: 'FactSet Real-Time Quotes API — Instrument. 33 operations. Lead operation: Factset List of Instruments Where
    a Specific Dataset Has Assigned a Given Category.. Self-contained Naftiko capability covering one Factset business surface.'
  tags:
  - Factset
  - Instrument
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    FACTSET_API_KEY: FACTSET_API_KEY
capability:
  consumes:
  - type: http
    namespace: real-time-quotes-instrument
    baseUri: https://api.factset.com/wealth/v3
    description: FactSet Real-Time Quotes API — Instrument business capability. Self-contained, no shared references.
    resources:
    - name: category-instrument-list
      path: /category/instrument/list
      operations:
      - name: getcategoryinstrumentlist
        method: GET
        description: Factset List of Instruments Where a Specific Dataset Has Assigned a Given Category.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: idCategory
          in: query
          type: number
          required: true
        - name: idCategoryDataset
          in: query
          type: number
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _paginationOffset
          in: query
          type: number
          description: Non-negative number of entries to skip, or 0 (default).
        - name: _paginationLimit
          in: query
          type: number
          description: Non-negative maximum number of entries to return.
    - name: instrument-backgroundText-list
      path: /instrument/backgroundText/list
      operations:
      - name: getinstrumentbackgroundtextlist
        method: GET
        description: Factset Background Texts of an Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifier
          in: query
          type: string
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-backgroundText-type-list
      path: /instrument/backgroundText/type/list
      operations:
      - name: postinstrumentbackgroundtexttypelist
        method: POST
        description: Factset List of Background Text Types for Instruments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: instrument-benchmark-list
      path: /instrument/benchmark/list
      operations:
      - name: postinstrumentbenchmarklist
        method: POST
        description: Factset List of Benchmarks of a Financial Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: instrument-category-list
      path: /instrument/category/list
      operations:
      - name: postinstrumentcategorylist
        method: POST
        description: Factset List of Categories Assigned to a Specific Instrument the Application Is Entitled to See.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: instrument-complianceProperty-list
      path: /instrument/complianceProperty/list
      operations:
      - name: postinstrumentcompliancepropertylist
        method: POST
        description: Factset List of Compliance Properties for Instruments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: instrument-complianceProperty-listByInstrument
      path: /instrument/complianceProperty/listByInstrument
      operations:
      - name: getinstrumentcompliancepropertylistbyinstrument
        method: GET
        description: Factset Compliance Properties of an Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifier
          in: query
          type: string
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-composite-get
      path: /instrument/composite/get
      operations:
      - name: getinstrumentcompositeget
        method: GET
        description: Factset Composite Instrument and Its Components.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifier
          in: query
          type: string
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-coupon-dayCountConvention-type-list
      path: /instrument/coupon/dayCountConvention/type/list
      operations:
      - name: getinstrumentcoupondaycountconventiontypelist
        method: GET
        description: Factset List of Day Count Convention Types.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-coupon-interestRate-type-list
      path: /instrument/coupon/interestRate/type/list
      operations:
      - name: getinstrumentcouponinterestratetypelist
        method: GET
        description: Factset List of Interest Rate Types.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-coupon-keyData-get
      path: /instrument/coupon/keyData/get
      operations:
      - name: getinstrumentcouponkeydataget
        method: GET
        description: Factset Interest Rate Details for Selected Periods of an Interest-bearing Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifier
          in: query
          type: string
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-coupon-list
      path: /instrument/coupon/list
      operations:
      - name: getinstrumentcouponlist
        method: GET
        description: Factset List of Coupons for an Interest-bearing Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifier
          in: query
          type: string
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-crossReference-getByISIN
      path: /instrument/crossReference/getByISIN
      operations:
      - name: getinstrumentcrossreferencegetbyisin
        method: GET
        description: Factset Translate Isin to Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: isin
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
    - name: instrument-crossReference-getByWKN
      path: /instrument/crossReference/getByWKN
      operations:
      - name: getinstrumentcrossreferencegetbywkn
        method: GET
        description: Factset Translate Wkn to Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: wkn
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
    - name: instrument-crossReference-history-getByISIN
      path: /instrument/crossReference/history/getByISIN
      operations:
      - name: getinstrumentcrossreferencehistorygetbyisin
        method: GET
        description: Factset Isin to Instrument Translation History.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: isin
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _paginationOffset
          in: query
          type: number
          description: Non-negative number of entries to skip, or 0 (default).
        - name: _paginationLimit
          in: query
          type: number
          description: Non-negative maximum number of entries to return.
    - name: instrument-crossReference-history-getByWKN
      path: /instrument/crossReference/history/getByWKN
      operations:
      - name: getinstrumentcrossreferencehistorygetbywkn
        method: GET
        description: Factset Wkn to Instrument Translation History.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: wkn
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _paginationOffset
          in: query
          type: number
          description: Non-negative number of entries to skip, or 0 (default).
        - name: _paginationLimit
          in: query
          type: number
          description: Non-negative maximum number of entries to return.
    - name: instrument-crossReference-listByISIN
      path: /instrument/crossReference/listByISIN
      operations:
      - name: postinstrumentcrossreferencelistbyisin
        method: POST
        description: Factset Translate a List of Isins to Instruments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: instrument-crossReference-listByWKN
      path: /instrument/crossReference/listByWKN
      operations:
      - name: postinstrumentcrossreferencelistbywkn
        method: POST
        description: Factset Translate a List of Wkns to Instruments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: instrument-exchangeRate-get
      path: /instrument/exchangeRate/get
      operations:
      - name: getinstrumentexchangerateget
        method: GET
        description: Factset Retrieve an Exchange Rate Instrument Identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: target
          in: query
          type: number
          required: true
        - name: source
          in: query
          type: number
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-exchangeRate-getByISOCode
      path: /instrument/exchangeRate/getByISOCode
      operations:
      - name: getinstrumentexchangerategetbyisocode
        method: GET
        description: Factset Retrieve an Exchange Rate Instrument Identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: target
          in: query
          type: string
          required: true
        - name: source
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-get
      path: /instrument/get
      operations:
      - name: getinstrumentget
        method: GET
        description: Factset Basic Data for an Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifier
          in: query
          type: string
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-getByNotation
      path: /instrument/getByNotation
      operations:
      - name: getinstrumentgetbynotation
        method: GET
        description: Factset Basic Data for an Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-legalEntity-backgroundText-list
      path: /instrument/legalEntity/backgroundText/list
      operations:
      - name: getinstrumentlegalentitybackgroundtextlist
        method: GET
        description: Factset Role-specific Background Texts of Legal Entities Related to an Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifier
          in: query
          type: string
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-legalEntity-complianceProperty-list
      path: /instrument/legalEntity/complianceProperty/list
      operations:
      - name: getinstrumentlegalentitycompliancepropertylist
        method: GET
        description: Factset Role-specific Compliance Properties of Legal Entities Related to an Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifier
          in: query
          type: string
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-mifid-get
      path: /instrument/mifid/get
      operations:
      - name: getinstrumentmifidget
        method: GET
        description: Factset Mifid Ii Data for a Financial Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifier
          in: query
          type: string
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
    - name: instrument-notation-list
      path: /instrument/notation/list
      operations:
      - name: postinstrumentnotationlist
        method: POST
        description: Factset List of Active, Entitled Notations for a Set of Instruments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: instrument-rating-grade-list
      path: /instrument/rating/grade/list
      operations:
      - name: postinstrumentratinggradelist
        method: POST
        description: Factset List of Rating Grades for a List of Instruments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: instrument-search-basic
      path: /instrument/search/basic
      operations:
      - name: getinstrumentsearchbasic
        method: GET
        description: Factset Basic Search for Instruments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: searchValue
          in: query
          type: string
          required: true
        - name: nsins
          in: query
          type: array
        - name: assetClass
          in: query
          type: string
        - name: onlyActive
          in: query
          type: boolean
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          type: string
        - name: _paginationOffset
          in: query
          type: number
          description: Non-negative number of entries to skip, or 0 (default).
        - name: _paginationLimit
          in: query
          type: number
          description: Non-negative maximum number of entries to return.
    - name: instrument-selectionList-list
      path: /instrument/selectionList/list
      operations:
      - name: getinstrumentselectionlistlist
        method: GET
        description: Factset Set of Custom Instrument-level Selection Lists.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
    - name: instrument-selectionList-listByInstrument
      path: /instrument/selectionList/listByInstrument
      operations:
      - name: getinstrumentselectionlistlistbyinstrument
        method: GET
        description: Factset for Each Given Instrument, Returns the Instrument-level Selection Lists of Which the Instrument
          Is a Member.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: identifiers
          in: query
          type: array
          required: true
        - name: identifierType
          in: query
          type: string
          required: true
        - name: _attributes
          in: query
          type: array
          description: Limit the attributes returned in the response to the specified set.
    - name: instrument-selectionList-members-list
      path: /instrument/selectionList/members/list
      operations:
      - name: postinstrumentselectionlistmemberslist
        method: POST
        description: Factset List of Instruments Belonging to an Instrument-level Selection List.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: notation-crossReference-factSetIdentifier-listByInstrument
      path: /notation/crossReference/factSetIdentifier/listByInstrument
      operations:
      - name: postnotationcrossreferencefactsetidentifierlistbyinstrument
        method: POST
        description: Retrieve a List of Factset Identifiers for a Given Instrument.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: notation-crossReference-listByInstrument
      path: /notation/crossReference/listByInstrument
      operations:
      - name: postnotationcrossreferencelistbyinstrument
        method: POST
        description: Factset List of Entitled Notations.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: bearer
      token: '{{env.FACTSET_API_KEY}}'
  exposes:
  - type: rest
    namespace: real-time-quotes-instrument-rest
    port: 8080
    description: REST adapter for FactSet Real-Time Quotes API — Instrument. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/category/instrument/list
      name: category-instrument-list
      description: REST surface for category-instrument-list.
      operations:
      - method: GET
        name: getcategoryinstrumentlist
        description: Factset List of Instruments Where a Specific Dataset Has Assigned a Given Category.
        call: real-time-quotes-instrument.getcategoryinstrumentlist
        with:
          idCategory: rest.idCategory
          idCategoryDataset: rest.idCategoryDataset
          _attributes: rest._attributes
          _paginationOffset: rest._paginationOffset
          _paginationLimit: rest._paginationLimit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/backgroundtext/list
      name: instrument-backgroundtext-list
      description: REST surface for instrument-backgroundText-list.
      operations:
      - method: GET
        name: getinstrumentbackgroundtextlist
        description: Factset Background Texts of an Instrument.
        call: real-time-quotes-instrument.getinstrumentbackgroundtextlist
        with:
          identifier: rest.identifier
          identifierType: rest.identifierType
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/backgroundtext/type/list
      name: instrument-backgroundtext-type-list
      description: REST surface for instrument-backgroundText-type-list.
      operations:
      - method: POST
        name: postinstrumentbackgroundtexttypelist
        description: Factset List of Background Text Types for Instruments.
        call: real-time-quotes-instrument.postinstrumentbackgroundtexttypelist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/benchmark/list
      name: instrument-benchmark-list
      description: REST surface for instrument-benchmark-list.
      operations:
      - method: POST
        name: postinstrumentbenchmarklist
        description: Factset List of Benchmarks of a Financial Instrument.
        call: real-time-quotes-instrument.postinstrumentbenchmarklist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/category/list
      name: instrument-category-list
      description: REST surface for instrument-category-list.
      operations:
      - method: POST
        name: postinstrumentcategorylist
        description: Factset List of Categories Assigned to a Specific Instrument the Application Is Entitled to See.
        call: real-time-quotes-instrument.postinstrumentcategorylist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/complianceproperty/list
      name: instrument-complianceproperty-list
      description: REST surface for instrument-complianceProperty-list.
      operations:
      - method: POST
        name: postinstrumentcompliancepropertylist
        description: Factset List of Compliance Properties for Instruments.
        call: real-time-quotes-instrument.postinstrumentcompliancepropertylist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/complianceproperty/listbyinstrument
      name: instrument-complianceproperty-listbyinstrument
      description: REST surface for instrument-complianceProperty-listByInstrument.
      operations:
      - method: GET
        name: getinstrumentcompliancepropertylistbyinstrument
        description: Factset Compliance Properties of an Instrument.
        call: real-time-quotes-instrument.getinstrumentcompliancepropertylistbyinstrument
        with:
          identifier: rest.identifier
          identifierType: rest.identifierType
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/composite/get
      name: instrument-composite-get
      description: REST surface for instrument-composite-get.
      operations:
      - method: GET
        name: getinstrumentcompositeget
        description: Factset Composite Instrument and Its Components.
        call: real-time-quotes-instrument.getinstrumentcompositeget
        with:
          identifier: rest.identifier
          identifierType: rest.identifierType
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/coupon/daycountconvention/type/list
      name: instrument-coupon-daycountconvention-type-list
      description: REST surface for instrument-coupon-dayCountConvention-type-list.
      operations:
      - method: GET
        name: getinstrumentcoupondaycountconventiontypelist
        description: Factset List of Day Count Convention Types.
        call: real-time-quotes-instrument.getinstrumentcoupondaycountconventiontypelist
        with:
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/coupon/interestrate/type/list
      name: instrument-coupon-interestrate-type-list
      description: REST surface for instrument-coupon-interestRate-type-list.
      operations:
      - method: GET
        name: getinstrumentcouponinterestratetypelist
        description: Factset List of Interest Rate Types.
        call: real-time-quotes-instrument.getinstrumentcouponinterestratetypelist
        with:
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/coupon/keydata/get
      name: instrument-coupon-keydata-get
      description: REST surface for instrument-coupon-keyData-get.
      operations:
      - method: GET
        name: getinstrumentcouponkeydataget
        description: Factset Interest Rate Details for Selected Periods of an Interest-bearing Instrument.
        call: real-time-quotes-instrument.getinstrumentcouponkeydataget
        with:
          identifier: rest.identifier
          identifierType: rest.identifierType
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/coupon/list
      name: instrument-coupon-list
      description: REST surface for instrument-coupon-list.
      operations:
      - method: GET
        name: getinstrumentcouponlist
        description: Factset List of Coupons for an Interest-bearing Instrument.
        call: real-time-quotes-instrument.getinstrumentcouponlist
        with:
          identifier: rest.identifier
          identifierType: rest.identifierType
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/crossreference/getbyisin
      name: instrument-crossreference-getbyisin
      description: REST surface for instrument-crossReference-getByISIN.
      operations:
      - method: GET
        name: getinstrumentcrossreferencegetbyisin
        description: Factset Translate Isin to Instrument.
        call: real-time-quotes-instrument.getinstrumentcrossreferencegetbyisin
        with:
          isin: rest.isin
          _attributes: rest._attributes
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/crossreference/getbywkn
      name: instrument-crossreference-getbywkn
      description: REST surface for instrument-crossReference-getByWKN.
      operations:
      - method: GET
        name: getinstrumentcrossreferencegetbywkn
        description: Factset Translate Wkn to Instrument.
        call: real-time-quotes-instrument.getinstrumentcrossreferencegetbywkn
        with:
          wkn: rest.wkn
          _attributes: rest._attributes
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/crossreference/history/getbyisin
      name: instrument-crossreference-history-getbyisin
      description: REST surface for instrument-crossReference-history-getByISIN.
      operations:
      - method: GET
        name: getinstrumentcrossreferencehistorygetbyisin
        description: Factset Isin to Instrument Translation History.
        call: real-time-quotes-instrument.getinstrumentcrossreferencehistorygetbyisin
        with:
          isin: rest.isin
          _attributes: rest._attributes
          _paginationOffset: rest._paginationOffset
          _paginationLimit: rest._paginationLimit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/crossreference/history/getbywkn
      name: instrument-crossreference-history-getbywkn
      description: REST surface for instrument-crossReference-history-getByWKN.
      operations:
      - method: GET
        name: getinstrumentcrossreferencehistorygetbywkn
        description: Factset Wkn to Instrument Translation History.
        call: real-time-quotes-instrument.getinstrumentcrossreferencehistorygetbywkn
        with:
          wkn: rest.wkn
          _attributes: rest._attributes
          _paginationOffset: rest._paginationOffset
          _paginationLimit: rest._paginationLimit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/crossreference/listbyisin
      name: instrument-crossreference-listbyisin
      description: REST surface for instrument-crossReference-listByISIN.
      operations:
      - method: POST
        name: postinstrumentcrossreferencelistbyisin
        description: Factset Translate a List of Isins to Instruments.
        call: real-time-quotes-instrument.postinstrumentcrossreferencelistbyisin
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/crossreference/listbywkn
      name: instrument-crossreference-listbywkn
      description: REST surface for instrument-crossReference-listByWKN.
      operations:
      - method: POST
        name: postinstrumentcrossreferencelistbywkn
        description: Factset Translate a List of Wkns to Instruments.
        call: real-time-quotes-instrument.postinstrumentcrossreferencelistbywkn
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/exchangerate/get
      name: instrument-exchangerate-get
      description: REST surface for instrument-exchangeRate-get.
      operations:
      - method: GET
        name: getinstrumentexchangerateget
        description: Factset Retrieve an Exchange Rate Instrument Identifier.
        call: real-time-quotes-instrument.getinstrumentexchangerateget
        with:
          target: rest.target
          source: rest.source
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/exchangerate/getbyisocode
      name: instrument-exchangerate-getbyisocode
      description: REST surface for instrument-exchangeRate-getByISOCode.
      operations:
      - method: GET
        name: getinstrumentexchangerategetbyisocode
        description: Factset Retrieve an Exchange Rate Instrument Identifier.
        call: real-time-quotes-instrument.getinstrumentexchangerategetbyisocode
        with:
          target: rest.target
          source: rest.source
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/get
      name: instrument-get
      description: REST surface for instrument-get.
      operations:
      - method: GET
        name: getinstrumentget
        description: Factset Basic Data for an Instrument.
        call: real-time-quotes-instrument.getinstrumentget
        with:
          identifier: rest.identifier
          identifierType: rest.identifierType
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/getbynotation
      name: instrument-getbynotation
      description: REST surface for instrument-getByNotation.
      operations:
      - method: GET
        name: getinstrumentgetbynotation
        description: Factset Basic Data for an Instrument.
        call: real-time-quotes-instrument.getinstrumentgetbynotation
        with:
          id: rest.id
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/legalentity/backgroundtext/list
      name: instrument-legalentity-backgroundtext-list
      description: REST surface for instrument-legalEntity-backgroundText-list.
      operations:
      - method: GET
        name: getinstrumentlegalentitybackgroundtextlist
        description: Factset Role-specific Background Texts of Legal Entities Related to an Instrument.
        call: real-time-quotes-instrument.getinstrumentlegalentitybackgroundtextlist
        with:
          identifier: rest.identifier
          identifierType: rest.identifierType
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/legalentity/complianceproperty/list
      name: instrument-legalentity-complianceproperty-list
      description: REST surface for instrument-legalEntity-complianceProperty-list.
      operations:
      - method: GET
        name: getinstrumentlegalentitycompliancepropertylist
        description: Factset Role-specific Compliance Properties of Legal Entities Related to an Instrument.
        call: real-time-quotes-instrument.getinstrumentlegalentitycompliancepropertylist
        with:
          identifier: rest.identifier
          identifierType: rest.identifierType
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/mifid/get
      name: instrument-mifid-get
      description: REST surface for instrument-mifid-get.
      operations:
      - method: GET
        name: getinstrumentmifidget
        description: Factset Mifid Ii Data for a Financial Instrument.
        call: real-time-quotes-instrument.getinstrumentmifidget
        with:
          identifier: rest.identifier
          identifierType: rest.identifierType
          _attributes: rest._attributes
          _language: rest._language
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/notation/list
      name: instrument-notation-list
      description: REST surface for instrument-notation-list.
      operations:
      - method: POST
        name: postinstrumentnotationlist
        description: Factset List of Active, Entitled Notations for a Set of Instruments.
        call: real-time-quotes-instrument.postinstrumentnotationlist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/rating/grade/list
      name: instrument-rating-grade-list
      description: REST surface for instrument-rating-grade-list.
      operations:
      - method: POST
        name: postinstrumentratinggradelist
        description: Factset List of Rating Grades for a List of Instruments.
        call: real-time-quotes-instrument.postinstrumentratinggradelist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/search/basic
      name: instrument-search-basic
      description: REST surface for instrument-search-basic.
      operations:
      - method: GET
        name: getinstrumentsearchbasic
        description: Factset Basic Search for Instruments.
        call: real-time-quotes-instrument.getinstrumentsearchbasic
        with:
          searchValue: rest.searchValue
          nsins: rest.nsins
          assetClass: rest.assetClass
          onlyActive: rest.onlyActive
          _attributes: rest._attributes
          _language: rest._language
          _paginationOffset: rest._paginationOffset
          _paginationLimit: rest._paginationLimit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/selectionlist/list
      name: instrument-selectionlist-list
      description: REST surface for instrument-selectionList-list.
      operations:
      - method: GET
        name: getinstrumentselectionlistlist
        description: Factset Set of Custom Instrument-level Selection Lists.
        call: real-time-quotes-instrument.getinstrumentselectionlistlist
        with:
          _attributes: rest._attributes
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/selectionlist/listbyinstrument
      name: instrument-selectionlist-listbyinstrument
      description: REST surface for instrument-selectionList-listByInstrument.
      operations:
      - method: GET
        name: getinstrumentselectionlistlistbyinstrument
        description: Factset for Each Given Instrument, Returns the Instrument-level Selection Lists of Which the Instrument
          Is a Member.
        call: real-time-quotes-instrument.getinstrumentselectionlistlistbyinstrument
        with:
          identifiers: rest.identifiers
          identifierType: rest.identifierType
          _attributes: rest._attributes
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/instrument/selectionlist/members/list
      name: instrument-selectionlist-members-list
      description: REST surface for instrument-selectionList-members-list.
      operations:
      - method: POST
        name: postinstrumentselectionlistmemberslist
        description: Factset List of Instruments Belonging to an Instrument-level Selection List.
        call: real-time-quotes-instrument.postinstrumentselectionlistmemberslist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/notation/crossreference/factsetidentifier/listbyinstrument
      name: notation-crossreference-factsetidentifier-listbyinstrument
      description: REST surface for notation-crossReference-factSetIdentifier-listByInstrument.
      operations:
      - method: POST
        name: postnotationcrossreferencefactsetidentifierlistbyinstrument
        description: Retrieve a List of Factset Identifiers for a Given Instrument.
        call: real-time-quotes-instrument.postnotationcrossreferencefactsetidentifierlistbyinstrument
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/notation/crossreference/listbyinstrument
      name: notation-crossreference-listbyinstrument
      description: REST surface for notation-crossReference-listByInstrument.
      operations:
      - method: POST
        name: postnotationcrossreferencelistbyinstrument
        description: Factset List of Entitled Notations.
        call: real-time-quotes-instrument.postnotationcrossreferencelistbyinstrument
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: real-time-quotes-instrument-mcp
    port: 9090
    transport: http
    description: MCP adapter for FactSet Real-Time Quotes API — Instrument. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: factset-list-instruments-where-specific
      description: Factset List of Instruments Where a Specific Dataset Has Assigned a Given Category.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getcategoryinstrumentlist
      with:
        idCategory: tools.idCategory
        idCategoryDataset: tools.idCategoryDataset
        _attributes: tools._attributes
        _paginationOffset: tools._paginationOffset
        _paginationLimit: tools._paginationLimit
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-background-texts-instrument
      description: Factset Background Texts of an Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentbackgroundtextlist
      with:
        identifier: tools.identifier
        identifierType: tools.identifierType
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-background-text-types
      description: Factset List of Background Text Types for Instruments.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postinstrumentbackgroundtexttypelist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-benchmarks-financial-instrument
      description: Factset List of Benchmarks of a Financial Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postinstrumentbenchmarklist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-categories-assigned-specific
      description: Factset List of Categories Assigned to a Specific Instrument the Application Is Entitled to See.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postinstrumentcategorylist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-compliance-properties-instruments
      description: Factset List of Compliance Properties for Instruments.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postinstrumentcompliancepropertylist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-compliance-properties-instrument
      description: Factset Compliance Properties of an Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcompliancepropertylistbyinstrument
      with:
        identifier: tools.identifier
        identifierType: tools.identifierType
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-composite-instrument-and-its
      description: Factset Composite Instrument and Its Components.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcompositeget
      with:
        identifier: tools.identifier
        identifierType: tools.identifierType
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-day-count-convention
      description: Factset List of Day Count Convention Types.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcoupondaycountconventiontypelist
      with:
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-interest-rate-types
      description: Factset List of Interest Rate Types.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcouponinterestratetypelist
      with:
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-interest-rate-details-selected
      description: Factset Interest Rate Details for Selected Periods of an Interest-bearing Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcouponkeydataget
      with:
        identifier: tools.identifier
        identifierType: tools.identifierType
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-coupons-interest-bearing
      description: Factset List of Coupons for an Interest-bearing Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcouponlist
      with:
        identifier: tools.identifier
        identifierType: tools.identifierType
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-translate-isin-instrument
      description: Factset Translate Isin to Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcrossreferencegetbyisin
      with:
        isin: tools.isin
        _attributes: tools._attributes
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-translate-wkn-instrument
      description: Factset Translate Wkn to Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcrossreferencegetbywkn
      with:
        wkn: tools.wkn
        _attributes: tools._attributes
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-isin-instrument-translation-history
      description: Factset Isin to Instrument Translation History.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcrossreferencehistorygetbyisin
      with:
        isin: tools.isin
        _attributes: tools._attributes
        _paginationOffset: tools._paginationOffset
        _paginationLimit: tools._paginationLimit
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-wkn-instrument-translation-history
      description: Factset Wkn to Instrument Translation History.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentcrossreferencehistorygetbywkn
      with:
        wkn: tools.wkn
        _attributes: tools._attributes
        _paginationOffset: tools._paginationOffset
        _paginationLimit: tools._paginationLimit
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-translate-list-isins-instruments
      description: Factset Translate a List of Isins to Instruments.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postinstrumentcrossreferencelistbyisin
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-translate-list-wkns-instruments
      description: Factset Translate a List of Wkns to Instruments.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postinstrumentcrossreferencelistbywkn
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-retrieve-exchange-rate-instrument
      description: Factset Retrieve an Exchange Rate Instrument Identifier.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentexchangerateget
      with:
        target: tools.target
        source: tools.source
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-retrieve-exchange-rate-instrument-2
      description: Factset Retrieve an Exchange Rate Instrument Identifier.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentexchangerategetbyisocode
      with:
        target: tools.target
        source: tools.source
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-basic-data-instrument
      description: Factset Basic Data for an Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentget
      with:
        identifier: tools.identifier
        identifierType: tools.identifierType
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-basic-data-instrument-2
      description: Factset Basic Data for an Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentgetbynotation
      with:
        id: tools.id
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-role-specific-background-texts
      description: Factset Role-specific Background Texts of Legal Entities Related to an Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentlegalentitybackgroundtextlist
      with:
        identifier: tools.identifier
        identifierType: tools.identifierType
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-role-specific-compliance-properties
      description: Factset Role-specific Compliance Properties of Legal Entities Related to an Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentlegalentitycompliancepropertylist
      with:
        identifier: tools.identifier
        identifierType: tools.identifierType
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-mifid-ii-data-financial
      description: Factset Mifid Ii Data for a Financial Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentmifidget
      with:
        identifier: tools.identifier
        identifierType: tools.identifierType
        _attributes: tools._attributes
        _language: tools._language
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-active-entitled-notations
      description: Factset List of Active, Entitled Notations for a Set of Instruments.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postinstrumentnotationlist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-rating-grades-list
      description: Factset List of Rating Grades for a List of Instruments.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postinstrumentratinggradelist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-basic-search-instruments
      description: Factset Basic Search for Instruments.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentsearchbasic
      with:
        searchValue: tools.searchValue
        nsins: tools.nsins
        assetClass: tools.assetClass
        onlyActive: tools.onlyActive
        _attributes: tools._attributes
        _language: tools._language
        _paginationOffset: tools._paginationOffset
        _paginationLimit: tools._paginationLimit
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-set-custom-instrument-level
      description: Factset Set of Custom Instrument-level Selection Lists.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentselectionlistlist
      with:
        _attributes: tools._attributes
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-each-given-instrument-returns
      description: Factset for Each Given Instrument, Returns the Instrument-level Selection Lists of Which the Instrument
        Is a Member.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: real-time-quotes-instrument.getinstrumentselectionlistlistbyinstrument
      with:
        identifiers: tools.identifiers
        identifierType: tools.identifierType
        _attributes: tools._attributes
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-instruments-belonging-instrument
      description: Factset List of Instruments Belonging to an Instrument-level Selection List.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postinstrumentselectionlistmemberslist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-list-factset-identifiers-given
      description: Retrieve a List of Factset Identifiers for a Given Instrument.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postnotationcrossreferencefactsetidentifierlistbyinstrument
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-list-entitled-notations
      description: Factset List of Entitled Notations.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: real-time-quotes-instrument.postnotationcrossreferencelistbyinstrument
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.