Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt

Use this file to discover all available pages before exploring further.

The corporate actions that occur on the underlying risk factors are taken into account by Atoti Market Risk. There are two main types of actions that can also be extended:
  • Cash type: drop of a dividend or detachment of a coupon.
  • Quantity type: split or merge of the instrument.

Input files

Corporate actions are stored in specific files. See Dividend.csv and SplitRatio.csv.

Datastore

The corporate actions are also stored in specific tables. See SplitRatioMarketData and DividendMarketData.

Retrieval

Retrieving corporate action dividend values and split ratio is done using the Atoti Market Data retrieval API. See the dedicated Atoti Market Data Documentation for details. As both stores have a single value per instrument ID, the SingleMarketDataPostProcessor is used with store-specific retrievers:
ConstantNameDetails
DIVIDEND_RETRIEVER_NAMEDIVIDEND_MARKET_DATA_RETRIEVERA retriever on the DividendMarketData store, allowing the retrieval of a dividend value using an as-of date, a market data set, and an instrument ID.
SPLIT_RATIO_RETRIEVER_NAMESPLIT_RATIO_MARKET_DATA_RETRIEVERA retriever on the SplitRatioMarketData store, allowing the retrieval of a split ratio using an as-of date and an instrument ID.

PnL for Cash / Dividends

The dividends must be taken as cash contributing to the PnL for the current day.

Configuration

ElementDetails
Input file column‘CashDividend’
Datastore column‘CashDividend’
Applied formulaDescribed under the properties of type mr.sensi.rules.dividend.pnl-explain.
The formula is applied with the following parameters for the current day: cash=f(sensi, dividend, 0.0)
DividendDescribed as a measure, similarly to the other greeks. Its configuration can be found on the class DividendGreekSensiCubeMeasureConfig.

PnL for Split

The split of a stock will divide its price by the split ratio. This split ratio is applied to the spot price of an instrument when used in a PnL Explain computation. To change this behavior, you can replace the following measures:
MeasureQualifierDetails
Spot MD Next w/ SplitSPOT_MARKET_DATA_NEXT_WITH_SPLITMultiplies the Spot MD Next measure by the Split Ratio Next measure.
Spot MD Next w/ Split On RiskFactor2SPOT_MARKET_DATA_NEXT_WITH_SPLIT_TWOMultiplies the Spot MD Next On RiskFactor2 measure by the Split Ratio 2 Next measure. Uses the RiskFactor2 level as the instrument ID, to account for sensitivities to multiple risk factors.