Configuration Reference

All Price Engine configuration is provided via environment variables with the KS_PE_ 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/price-engine.properties.

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

Property	Default	Description
KS_PE_PRICE_SOURCES	[] (none)	External data provider price subscriptions
KS_PE_INSTRUMENT_TOPIC_GROUPS	"" (all)	Instrument topic groups that Price Engine should price
KS_ANALYTICS_ENGINE_TOPIC_SOURCE	analytics-engine	Topic source of the Analytics Engine instance
KS_STATIC_DATA_SERVER_TOPIC_SOURCE	static-data-server	Topic source of the Static Data Server instance
KS_CURVE_ENGINE_TOPIC_SOURCE	curve-engine	Topic source of the Curve Engine instance

---

KS_PE_PRICE_SOURCES

JSON array defining the external data providers whose prices Price Engine subscribes to. Each entry configures one data provider connection.

Default: [] (no price sources — only MANUAL pricing is available)

Format:

KS_PE_PRICE_SOURCES=[
  {
    "name":               "TWEB TRSY",
    "topicSource":        "TWEB",
    "topicGroup":         "LIVE",
    "instrumentIdType":   "ALIAS",
    "instrumentIdSource": ""
  },
  {
    "name":               "CBONDS",
    "topicSource":        "CBONDS",
    "topicGroup":         "LIVE",
    "instrumentIdType":   "ISIN",
    "instrumentIdSource": ""
  }
]

Property	Description
name	Human-readable display name used in Price Engine logs and UI dropdowns (e.g. in the Price Source and Bmk Price Source columns).
topicSource	The topicSource of the data provider's KsCanonical.Price messages. Must match the application name the provider registers with.
topicGroup	The topicGroup to subscribe to. Must not be blank
instrumentIdType	How the provider identifies instruments in its price messages. One of: STATIC_DATA_SERVER, ISIN, CUSIP, FIGI, ALIAS.
instrumentIdSource	When instrumentIdType is ALIAS, this optionally scopes the alias lookup to a specific source. Leave empty to match any alias source.

note

Each name must be unique across all entries in KS_PE_PRICE_SOURCES. The name appears in the Price Source and Bmk Price Source dropdowns in Key UI.

KS_PE_INSTRUMENT_TOPIC_GROUPS

Comma-separated list of instrument topic groups that Price Engine should price. An empty value means all groups are priced.

Default: "" (all groups)

# Price only USD and GBP bonds
KS_PE_INSTRUMENT_TOPIC_GROUPS=BUSD,BGBP

# Price all available groups (default)
KS_PE_INSTRUMENT_TOPIC_GROUPS=

Topic groups follow the Static Data Server naming convention: type prefix + currency (e.g. BUSD = USD bonds, BGBP = GBP bonds, SUSD = USD swaps).

KS_ANALYTICS_ENGINE_TOPIC_SOURCE

The topic source name of the Analytics Engine instance that Price Engine should send valuation requests to.

Default: analytics-engine

KS_ANALYTICS_ENGINE_TOPIC_SOURCE=analytics-engine

KS_STATIC_DATA_SERVER_TOPIC_SOURCE

The topic source name of the Static Data Server instance to subscribe to for instrument data, profiles, business dates, and indices.

Default: static-data-server

KS_STATIC_DATA_SERVER_TOPIC_SOURCE=static-data-server

KS_CURVE_ENGINE_TOPIC_SOURCE

The topic source name of the Curve Engine instance that publishes interest rate curves consumed by Price Engine.

Default: curve-engine

KS_CURVE_ENGINE_TOPIC_SOURCE=curve-engine