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_Delta_Sensitivities.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 Trade file type is identified using the pattern: **/SB*_Delta_Sensitivities*.csv (as specified by sb.delta.sensitivities.file-pattern). A sample file is SBM_Delta_Sensitivities. This file is loaded using the SBM_Delta_Sensi 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.
TradeIdYNStringIf coming from multiple systems may need to prepend source system to the id for uniqueness”IR_IRSWAP_LIBOR3M”, “EQ_12345677”, etc.
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
Vector
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”, “Crypto 2a”
SensitivityDatesNYString Array or String with set format, separated by semicolonsGIRR, CSR, Commodities and Crypto 2a 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” Crypto 2a: “0;0.25;0.5;1;2;3;5;10;15;20;30”
RiskFactorYYStringRisk factor name. It is expected that the risk factor name encompasses the definition of the risk factor per the FRTB specification (MAR21.3 to MAR21.14, and for Crypto 2a in SCO60.74 and SCO60.75), 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, then 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.
Name of crypto asset, including the exchange. If omitted, it is generated as Bucket + Location.”Bitcoin MEXC”
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.
The crypto asset and the exchange. If ommited, it is generated as Bucket + Location”Bitcoin MEXC”
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”
LocationNYStringUsed for Commodity and Crypto 2a only.
Commodity delivery location”Le Havre”, “Oklahoma”
Crypto exchange”MEXC”
(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.
OptionalityNY’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”
FxComplexDeltaNYStringFX 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.
FxOtherCcyNYStringFX 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.
FXDividerEligibilityNYStringFX 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.
TradeIdYNStringIf coming from multiple systems may need to prepend source system to the id for uniqueness“IR_IRSWAP_LIBOR3M”, “EQ_12345677”, etc.
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
Crypto 2aVector
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”, “Crypto 2a”
SensitivityDatesNYString Array or String with set format, separated by semicolonsGIRR, CSR, Commodities and Crypto 2a 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” Crypto 2a: “0;0.25;0.5;1;2;3;5;10;15;20;30”
RiskFactorYYStringRisk factor name. It is expected that the risk factor name encompasses the definition of the risk factor per the FRTB specification ([MAR21.3] to [MAR21.14], and for Crypto 2a in [SCO60.74] and [SCO60.75]), 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, then 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.
Crypto 2aName of crypto asset, including the exchange. If omitted, it is generated as Bucket + Location.“Bitcoin MEXC”
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.
Crypto 2aThe crypto asset and the exchange. If ommited, it is generated as Bucket + Location“Bitcoin MEXC”
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”
LocationNYStringUsed for Commodity and Crypto 2a only.
CommodityCommodity delivery location“Le Havre”, “Oklahoma”
Crypto 2aCrypto exchange“MEXC”
(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.
OptionalityNY‘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”
FxComplexDeltaNYStringFX 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.
FxOtherCcyNYStringFX 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.
FXDividerEligibilityNYStringFX 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.