Configuration Reference

All Quote Engine configuration is provided via environment variables with the KS_QE_ prefix (plus a few shared KS_ prefixed variables for dependent services). For Docker, set these in the container environment. For Platform Manager, set them in $KS_HOME/conf/quote-engine.properties.

The supplied package contains conf/common.properties with all applicable configuration variables and their default values.

Property	Default	Description
KS_QE_NO_OF_TIERS	1	Number of quote tiers to produce
KS_QE_INSTRUMENT_TOPIC_GROUPS	"" (all)	Instrument topic groups that Quote Engine should quote
KS_QE_PRICE_SOURCES	[]	External price source subscriptions
KS_QE_DEFAULT_PRICE_SOURCE	""	Default price source name for new profiles
KS_QE_POSITION_SOURCES	[]	Position source subscriptions (optional)
KS_QE_DEFAULT_POSITION_SOURCE	""	Default position source name
KS_QE_MARKET_INSTRUMENT_ID_TYPE	ISIN	Identifier type used to populate quote.marketInstrumentId

---

KS_QE_NO_OF_TIERS

The total number of quote tiers Quote Engine should produce for each instrument. Each tier has its own set of QuoteControls and QuoteProfiles.

Default: 1

# Produce 3 tiers of quotes per instrument
KS_QE_NO_OF_TIERS=3

KS_QE_INSTRUMENT_TOPIC_GROUPS

Comma-separated list of instrument topic groups that Quote Engine should quote. An empty value means all groups are quoted.

Default: "" (all groups)

# Quote only USD and GBP bonds
KS_QE_INSTRUMENT_TOPIC_GROUPS=BUSD,BGBP

# Quote all available groups (default)
KS_QE_INSTRUMENT_TOPIC_GROUPS=

Topic groups follow the Static Data Server naming convention: type prefix + currency (e.g. BUSD = USD bonds). See Static Data Server — Topic Structure.

KS_QE_PRICE_SOURCES

JSON array defining the price sources whose prices Quote Engine subscribes to. Each entry corresponds to one price feed — typically one entry for Price Engine and optionally others for alternative feeds.

Default: []

Format:

KS_QE_PRICE_SOURCES=[
  {
    "name":               "_PRICE_ENGINE",
    "topicSource":        "price-engine",
    "topicGroup":         "price-engine",
    "instrumentIdType":   "STATIC_DATA_SERVER",
    "instrumentIdSource": ""
  }
]

Property	Description
name	Human-readable display name used in QuoteProfile dropdowns and logs (e.g. _PRICE_ENGINE).
topicSource	The topicSource of the provider's KsCanonical.Price messages. Typically the application name.
topicGroup	The topicGroup to subscribe to.
instrumentIdType	How the provider identifies instruments. One of: STATIC_DATA_SERVER, ISIN, CUSIP, FIGI, ALIAS.
instrumentIdSource	When instrumentIdType is ALIAS, optionally restricts the alias lookup to a specific source. Leave empty to match any.

note

Each name must be unique across all entries. The name appears in the Price Source dropdown on QuoteProfile records.

KS_QE_DEFAULT_PRICE_SOURCE

The name of the price source to assign to new QuoteProfiles created automatically when a new Instrument Profile arrives from Static Data Server.

Default: "" (empty — profile will have no price source until manually set)

KS_QE_DEFAULT_PRICE_SOURCE=_PRICE_ENGINE

KS_QE_POSITION_SOURCES

JSON array defining position sources Quote Engine can subscribe to. Required only when using TARGET or REDUCE size strategies.

Default: []

Format:

KS_QE_POSITION_SOURCES=[
  {
    "name":               "_POSITION_SERVER",
    "topicSource":        "position-server",
    "topicGroup":         "position-server",
    "instrumentIdType":   "STATIC_DATA_SERVER",
    "instrumentIdSource": ""
  }
]

The fields follow the same schema as KS_QE_PRICE_SOURCES.

KS_QE_DEFAULT_POSITION_SOURCE

The name of the position source to assign to new QuoteProfiles by default.

Default: "" (none)

KS_QE_DEFAULT_POSITION_SOURCE=_POSITION_SERVER

KS_QE_MARKET_INSTRUMENT_ID_TYPE

The identifier type used to populate quote.marketInstrumentId — the external identifier included in published quotes for downstream distribution systems.

Default: ISIN

Supported values: STATIC_DATA_SERVER, ISIN, CUSIP, FIGI, ALIAS

KS_QE_MARKET_INSTRUMENT_ID_TYPE=ISIN