Skip to main content

Data Model: YU14-listed-equity-options

Instrument (reference-data view)​

One row per tradeable security. Derived fields come from the OCC identifier; nothing here is stored in the cluster beyond the ticker→securityId mapping and the multiplier.

FieldSourceEquity exampleOption example
tickerseeded identifierAAPLAAPL260918C00240000
securityIdcluster symbol registration321
typederived: OCC parseequityoption
underlyingderived: OCC root; AAPL
expiryderived: OCC yymmdd; 2026-09-18
callPutderived: OCC C/P; C
strikederived: OCC 8 digits / 1000; 240.000
multiplierderived at registration; cluster state1100
currencyreference dataUSDUSD

reference-data/instruments.csv materializes this view for the seeded universe.

Counterparty (reference-data)​

reference-data/counterparties.csv, keyed by accountId; joined to positions at extract time.

FieldMeaning
accountIdthe engine's account identifier
counterpartyIdcounterparty legal-entity identifier (CPTY-…)
nettingSetIdnetting set / CSA grouping (NS-…)
currencysettlement currency, USD

Derived notional​

Wherever positions are surfaced from reference data:

notional = position quantity x last price x contract multiplier

Order reservation and executed exposure inside the risk gate are stored already-multiplied (quantity x validation price x multiplier), so in-cluster credit/order-notional/concentration accounting and the derived extract field agree by construction.

Cluster state delta (vs YU13)​

StateYU13YU14
per-security risk rowenabled, restricted, lastPrice, lastPriceTime+ contractMultiplier
snapshot security record (T_SECURITY)5 columns6 columns (format 3)
snapshot header format23; format β‰  3 fails closed
restore validationinherited+ multiplier < 1 fails closed

Order rows, position rows, book records, symbol records, idempotency records: unchanged.

SBE delta (vs YU12 schema)​

SymbolRegisterMessage ticker field widens char[16] β†’ char[32] (blockLength 24 β†’ 40) so unpadded OCC symbols (~19 chars) register; template id and message semantics are unchanged.