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.

Download sample file: SBM_Summary_Delta_Sensitivities_2018-09-25.csv This file defines the Delta sensitivities, including a description of the risk factor. Full details on each risk factor are explained in the relevant section of the Atoti FRTB Interpretation and Implementation guide: This Delta Summary file type is identified using the pattern: **/SBM_Summary*_Delta_Sensitivities*.csv (as specified by sbm.summary.delta.sensitivities.file-pattern). A sample file is SBM_Summary_Delta_Sensitivities_2018-09-25. This file is loaded using the SBM_Delta_Sensi_Summary topic. See the Topic Aliases table for an understanding of the topic aliases associated with each topic.
FieldKeyNullFieldTypeDescriptionExample
AsOfDateYNDate ‘YYYY-MM-DD’Timestamp (at close of business) for the data.
BookYNStringThe book ID.
LegalEntityYNStringThe legal entity ID.
DeltaCcyNNStringCurrency of the Delta sensitivities provided.
DeltaSensitivitiesNNDouble Array or Double, separated by semicolonsSingle value or vector of delta sensitivities.
Vector
Vector
Vector
Vector
Vector
Single value
Single value
RiskClassYNStringDefines the risk class that the delta data represents. For each risk class, the string is the risk class name”GIRR”, “CSR non-Sec”, “CSR Sec non-CTP”, “CSR Sec CTP”, “Equity”, “Commodity”, “FX”
SensitivityDatesNYString Array or String with set format, separated by semicolonsGIRR, CSR, and Commodities only Vector of dates that correspond to the Delta sensitivities. If dates are not provided, Delta Sensitivities are assumed to map to prescribed vertices. The following do not use dates: FX and Equity sensitivites, GIRR cross-currency basis and inflation curves.GIRR and Commodity: “0.25;0.5;1;2;3;5;10;15;20” CSR: “0.5;1;3;5;10”
RiskFactorYYStringRisk factor name. The risk factor name is expected to encompass the definition of the risk factor per the FRTB specification (MAR21.3 to MAR21.14), up to the sensitivity dates; this name is shared by all sensitivity dates. If not provided, it will be generated from the ‘Underlying’ column. For details on each risk factor, see the relevant section in the Atoti FRTB Interpretation and Implementation guide.
Name of underlying curve (e.g. UsdLibor3m). If not provided, then it is copied from Underlying.
Name of issuer credit spread curve plus basis (Bond or CDS). If not provided, then it is calculated as (Underlying + Type).”APPLE BOND”, “GOOGLE CDS”
Name of issuer credit spread curve plus basis (Bond or CDS). If not provided, then it is calculated as (Underlying + Type).
Name of issuer tranche, credit spread curve. If not provided, then it is calculated as (Underlying + Type).
Name of equity plus type (spot or repo). If not provided, then it is calculated as (Underlying + Type).”IBM SPOT”
Unique commodity name should include commodity name and delivery location. If not provided, it is calculated as (Underlying + Location).”Brent Le Havre”, “WTI Oklahoma”
A currency pair (the exchange rate used in the calculation of the sensitivity). If omitted, it is generated from the underlying and FXCounterCurrency.
TypeNYStringType of underlying risk factor or GIRR curve. Needed for some risk classes. For details on each risk factor, see the relevant section in the Atoti FRTB Interpretation and Implementation guide.
Defines type of underlying curve.”Yield”, “Basis”, “Inflation”
Defines basis of CSR.”BOND”, “CDS”
Defines basis of CSR.
Defines basis of CSR Equity.
Equity type.”Spot” or “Repo”
GIRR CcyNYStringGIRR only This is the currency of the curve and equals the bucket.
UnderlyingNNStringRepresents the primary component of the risk factor. For details on each risk factor, see the relevant section in the Atoti FRTB Interpretation and Implementation guide.
Name of curve.
Name of credit issuer.”APPLE”, “GOOGLE”
The name underlying the securitisation.
Name of the asset pool and tranche.
Name of equity issuer.
Name of Commodity.”Brent”, “WTI”
The left-hand side of the risk-factor currency pair.
CSRQualityNYStringCSR only The Issuer or Tranche credit quality Values must match corresponding buckets fileIG, HY, NR
CSRSectorNYStringCSR only The issuer or securitisation sector Values must match corresponding buckets fileFor CSR non-Sec and CSR Sec CTP, example values: ‘Sovereign’, ‘Financials’, ‘Tech’ ‘Covered Bonds’, ‘Other’ For CSR Sec non-CTP, example values: ‘RMBS-Prime’, ‘RMBS-Mid-Prime’, ‘RMBS-Sub-Prime’, ‘CMBS’, ‘ABS-Auto’, ‘Other’
(unused)NYStringField is ignored.
EquityEconomyNYStringEquity only The equity issuer economy. Values must match the equity buckets file.‘Emerging Market’, ‘Advanced Economy’, ‘Other’
EquityMarketCapNYStringEquity only The equity issuer market cap. Values must match the equity buckets file.‘Large’ , ‘Small’, ‘Other’
EquitySectorNYStringEquity only Needed for Vega bucket Value can be anything but must match the buckets fileExample values are: “CSG” “Telecommunications-Industrials” “Basic Materials” “Financials” “Other”
CommodityLocationNYStringCommodity only Commodity delivery location”Le Havre”, “Oklahoma”
(unused)NYStringField is ignored.
(unused)NYStringField is ignored.
(unused)NYStringField is ignored.
FXCounterCurrencyNYStringFX only. The counter currency of the risk-factor currency pair. This should be set to the “reporting currency” or the “base currency” if the base currency approach is being used.
OptionalityYY’Y’ or ‘N’(Optional) Indicates whether the instrument has optionality (See BCBS 457 MAR21.2). - ‘Y’ for instruments with optionality (and hence with Vega and Curvature risk) - ‘N’ for trades without optionality (with no Vega and Curvature risk).
CSRRatingNYStringCSR non-Sec only The rating used to determine if covered bonds are highly rated or not”AAA”, “high”
FxComplexDeltaYYStringFX only Set to “N” to enable automatic translations of the sensitivities for different reporting currencies. Otherwise set to “Y” or leave blank to turn off such translations.
FxOtherCcyYYStringFX only If the sensitivity to a currency pair has been split prior to entering the ActiveViam FRTB solution, this field can be used to add the other half of the pair.
FXDividerEligibilityYYStringFX only Y/N flag indicating whether the divider specified in MAR21.98 can be applied. - Y: The trade does not reference the “reporting currency” (or “base currency” if the base currency approach is being used). - N: The trade references the “reporting currency” (or “base currency” if the base currency approach is being used).
BucketNYStringBucket for underlying.
PoolNYStringCSR Sec non-CTP only Pool for tranche. If empty, copied from Underlying.
AttachmentNYDoubleCSR Sec non-CTP only Tranche attachement point. Values between 0.0 and 1.0. If empty, defaults to 0.0.
DetachmentNYDoubleCSR Sec non-CTP only Tranche detachment point. Values between 0.0 and 1.0. If empty, defaults to 0.0.
GIRR Basis CcyNYStringGIRR only The counter currency for GIRR cross-currency basis curves.EUR, USD
Translation Risk CcyNYStringFX only Indicates the sensitivity represents translation risk; set to the reporting currency.EUR, GBP

Normalization

The contents of this file are normalized and loaded into four stores during the ETL. For each row:
  • A description of the “underlying” is generated and added to the UnderlyingDescription store. This description is shared with Vega and Curvature.
  • A description of the risk-factor is generated and added to the RiskFactorDescription store.
  • The sensitivities are added to the Delta store.

Filling missing data

When the bucket field is omitted, it is filled from the Commodity, CSR, and Equities bucket files (as appropriate). To take advantage of this, the bucket files must be loaded before (or at the same time as) the Delta file. When the bucket field is provided, some of the fields describing the underlying become optional. For CSR and Equities, these fields can be populated from previously loaded bucket description files.
FieldKeyNullFieldTypeRiskClassDescriptionExample
AsOfDateYNDate ‘YYYY-MM-DD’Timestamp (at close of business) for the data.
BookYNStringThe book ID.
LegalEntityYNStringThe legal entity ID.
DeltaCcyNNStringCurrency of the Delta sensitivities provided.
DeltaSensitivitiesNNDouble Array or Double, separated by semicolonsSingle value or vector of delta sensitivities.
GIRRVector
CommodityVector
CSR non-SecVector
CSR Sec CTPVector
CSR Sec non-CTPVector
EquitySingle value
FXSingle value
RiskClassYNStringDefines the risk class that the delta data represents. For each risk class, the string is the risk class name“GIRR”, “CSR non-Sec”, “CSR Sec non-CTP”, “CSR Sec CTP”, “Equity”, “Commodity”, “FX”
SensitivityDatesNYString Array or String with set format, separated by semicolonsGIRR, CSR, and Commodities only Vector of dates that correspond to the Delta sensitivities.If dates are not provided, Delta Sensitivities are assumed to map to prescribed vertices.The following do not use dates: FX and Equity sensitivites, GIRR cross-currency basis and inflation curves.GIRR and Commodity: “0.25;0.5;1;2;3;5;10;15;20” CSR: “0.5;1;3;5;10”
RiskFactorYYStringRisk factor name. The risk factor name is expected to encompass the definition of the risk factor per the FRTB specification ([MAR21.3] to [MAR21.14]), up to the sensitivity dates; this name is shared by all sensitivity dates. If not provided, it will be generated from the ‘Underlying’ column. For details on each risk factor, see the relevant section in the Atoti FRTB Interpretation and Implementation guide.
GIRRName of underlying curve (e.g. UsdLibor3m). If not provided, then it is copied from Underlying.
CSR non-SecName of issuer credit spread curve plus basis (Bond or CDS). If not provided, then it is calculated as (Underlying + Type).“APPLE BOND”, “GOOGLE CDS”
CSR Sec CTPName of issuer credit spread curve plus basis (Bond or CDS). If not provided, then it is calculated as (Underlying + Type).
CSR Sec non-CTPName of issuer tranche, credit spread curve. If not provided, then it is calculated as (Underlying + Type).
EquityName of equity plus type (spot or repo). If not provided, then it is calculated as (Underlying + Type).“IBM SPOT”
CommodityUnique commodity name should include commodity name and delivery location. If not provided, it is calculated as (Underlying + Location).“Brent Le Havre”, “WTI Oklahoma”
FXA currency pair (the exchange rate used in the calculation of the sensitivity). If omitted, it is generated from the underlying and FXCounterCurrency.
TypeNYStringType of underlying risk factor or GIRR curve. Needed for some risk classes.
For details on each risk factor, see the relevant section in the Atoti FRTB Interpretation and Implementation guide.
GIRRDefines type of underlying curve.“Yield”, “Basis”, “Inflation”
CSR non-SecDefines basis of CSR.“BOND”, “CDS”
CSR Sec CTPDefines basis of CSR.
CSR Sec non-CTPDefines basis of CSR Equity.
EquityEquity type.“Spot” or “Repo”
GIRR CcyNYStringGIRR only This is the currency of the curve and equals the bucket.
UnderlyingNNStringRepresents the primary component of the risk factor. For details on each risk factor, see the relevant section in the Atoti FRTB Interpretation and Implementation guide.
GIRRName of curve.
CSR non-SecName of credit issuer.“APPLE”, “GOOGLE”
CSR Sec CTPThe name underlying the securitisation.
CSR Sec non-CTPName of the asset pool and tranche.
EquityName of equity issuer.
CommodityName of Commodity.“Brent”, “WTI”
FXThe left-hand side of the risk-factor currency pair.
CSRQualityNYStringCSR only The Issuer or Tranche credit quality Values must match corresponding buckets fileIG, HY, NR
CSRSectorNYStringCSR only The issuer or securitisation sector Values must match corresponding buckets fileFor CSR non-Sec and CSR Sec CTP, example values: ‘Sovereign’, ‘Financials’, ‘Tech’ ‘Covered Bonds’, ‘Other’For CSR Sec non-CTP, example values: ‘RMBS-Prime’, ‘RMBS-Mid-Prime’, ‘RMBS-Sub-Prime’, ‘CMBS’, ‘ABS-Auto’, ‘Other’
(unused)NYStringField is ignored.
EquityEconomyNYStringEquity only The equity issuer economy. Values must match the equity buckets file.‘Emerging Market’, ‘Advanced Economy’, ‘Other’
EquityMarketCapNYStringEquity only The equity issuer market cap. Values must match the equity buckets file.‘Large’ , ‘Small’, ‘Other’
EquitySectorNYStringEquity only Needed for Vega bucket Value can be anything but must match the buckets fileExample values are: “CSG” “Telecommunications-Industrials” “Basic Materials” “Financials” “Other”
CommodityLocationNYStringCommodity only Commodity delivery location“Le Havre”, “Oklahoma”
(unused)NYStringField is ignored.
(unused)NYStringField is ignored.
(unused)NYStringField is ignored.
FXCounterCurrencyNYStringFX only. The counter currency of the risk-factor currency pair. This should be set to the “reporting currency” or the “base currency” if the base currency approach is being used.
OptionalityYY‘Y’ or ‘N’(Optional) Indicates whether the instrument has optionality (See BCBS 457 [MAR21.2]).‘Y’ for instruments with optionality (and hence with Vega and Curvature risk), ‘N’ for trades without optionality (with no Vega and Curvature risk).
CSRRatingNYStringCSR non-Sec only The rating used to determine if covered bonds are highly rated or not“AAA”, “high”
FxComplexDeltaYYStringFX only Set to “N” to enable automatic translations of the sensitivities for different reporting currencies. Otherwise set to “Y” or leave blank to turn off such translations.
FxOtherCcyYYStringFX only If the sensitivity to a currency pair has been split prior to entering the ActiveViam FRTB solution, this field can be used to add the other half of the pair.
FXDividerEligibilityYYStringFX only Y/N flag indicating whether the divider specified in [MAR21.98] can be applied.Y: The trade does not reference the “reporting currency” (or “base currency” if the base currency approach is being used)., N: The trade references the “reporting currency” (or “base currency” if the base currency approach is being used).
BucketNYStringBucket for underlying.
PoolNYStringCSR Sec non-CTP only Pool for tranche. If empty, copied from Underlying.
AttachmentNYDoubleCSR Sec non-CTP only Tranche attachement point. Values between 0.0 and 1.0. If empty, defaults to 0.0.
DetachmentNYDoubleCSR Sec non-CTP only Tranche detachment point. Values between 0.0 and 1.0. If empty, defaults to 0.0.
GIRR Basis CcyNYStringGIRR only The counter currency for GIRR cross-currency basis curves.EUR, USD
Translation Risk CcyNYStringFX only Indicates the sensitivity represents translation risk; set to the reporting currency.EUR, GBP
The bucket is not sufficient to populate the CSRRating field for CSR non-Sec.