Escolar Documentos
Profissional Documentos
Cultura Documentos
HELPX.TRM_RM
Yield Curve Framework
Copyright
© Copyright 2013 SAP AG. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or for any purpose
without the express permission of SAP AG. The information contained herein may be changed
without prior notice.
Some software products marketed by SAP AG and its distributors contain proprietary software
components of other software vendors. National product specifications may vary.
These materials are provided by SAP AG and its affiliated companies (“SAP Group”) for
informational purposes only, without representation or warranty of any kind, and SAP Group
shall not be liable for errors or omissions with respect to the materials. The only warranties for
SAP Group products and services are those that are set forth in the express warranty statements
accompanying such products and services, if any. Nothing herein should be construed as
constituting an additional warranty.
SAP and other SAP products and services mentioned herein as well as their respective logos are
trademarks or registered trademarks of SAP AG in Germany and other countries.
Typographic Conventions
Type Style Description
Example text Words or characters quoted from the screen. These include field names, screen
titles, pushbuttons labels, menu names, menu paths, and menu options.
Cross-references to other documentation.
Example text Emphasized words or phrases in body text, graphic titles, and table titles.
EXAMPLE TEXT Technical names of system objects. These include report names, program
names, transaction codes, table names, and key concepts of a programming
language when they are surrounded by body text, for example, SELECT and
INCLUDE.
Example text Output on the screen. This includes file and directory names and their paths,
messages, names of variables and parameters, source text, and names of
installation, upgrade and database tools.
Example text Exact user entry. These are words or characters that you enter in the system
exactly as they appear in the documentation.
<Example text> Variable user entry. Angle brackets indicate that you replace these words and
characters with appropriate entries to make entries in the system.
EXAMPLE TEXT Keys on the keyboard, for example, F2 or ENTER.
You use the Yield Curve Framework to define reference interest rates and enter their values.
On the basis of the reference interest rates, you can create yield curves to help you determine
mark-to-market net present values with the price calculator. They also enable you to create
basis spreads and credit spreads for inclusion in calculations for the creation of basis spread
curves and credit spread curves, which you can add to the yield curves and then make
calculations on the basis of the combined curves (called "composite curves").
Integration
The functions of the Yield Curve Framework are available with the following business
functions:
Features
Key Terms in the Yield Curve Framework [Page 5]
Calculate Interest Rates from the Yield Curve Generated [Page 18]
The daily method determines how the days for interest calculation are
counted between two dates on the Gregorian calendar.
The basic daily method determines how many days there is in a year for
the purposes of interest calculation.
Yield Curve A yield curve type contains one yield curve structure for each different
Type currency. On the validity date, the yield curve structure generates a yield
curve that serves as the basis for NPV calculation.
You can assign any number of currencies to every yield curve type. The
yield curve structures are based on the reference interest rates assigned.
These reference rates are used to form the grid points for the currencies
of the yield curve type.
Yield Curve A curve that is built from a record of reference interest rates for different
terms. A yield curve is uniquely defined by its combination of the validity
date, the yield curve date, and the currency.
Basis Spread Basis spreads are premiums and discounts on one side of a basis swap
that make the swap into a fair transaction. They can be used in the price
calculator for the calculation of discount factors and forward interest rates.
The spread relates to the first two reference interest rates assigned.
Cross-Currency Spread:
Tenor Spread:
Basis Spread ID Key with which a basis spread is defined. This could relate to either a
cross-currency spread or a tenor spread.
Basis Spread A basis spread curve type contains a basis spread curve structure for
Curve Type each combination of currency and tenor:
On the validity date, the basis spread curve structure generates a basis
spread curve, which is combined with a yield curve during the NPV
calculation.
You can assign any number of currency/tenor pairs to every basis spread
curve type The currency/tenor pair is defined on an abstract level. The
concrete relationship to the quoted market data is defined by assigning the
basis spread IDs to the grid points. The basis spread curve structures are
based on the assigned basis spread IDs. The underlying reference rates
assigned to these basis spread IDs need to fulfill the following
requirements:
Basis Spread A basis spread curve is the result, valid on a specific date, for a basis
Curve spread curve type for a concrete currency-tenor transition, which is
combined with a yield curve during the NPV calculation.
A basis spread curve does not exist on its own; it is only used in the
context of the generation of a composite curve.
Credit Spread A credit spread value always relates to a reference entity, a credit spread
ID, a quotation type, and a rate date.
Reference Entity The reference entity is the reference factor for a credit spread.
Security ID numbers
Ratings
Credit Spread A credit spread curve structure defines the term structure of a credit
Value Structure spread curve.
On the validity date, the credit spread curve structure, together with a
reference entity, generates a credit spread curve, which is combined with
a yield curve during the NPV calculation.
Credit Spread A credit spread curve is the result, valid on a specific date, for a credit
Curve spread curve type together with a reference entity that is combined with a
yield curve during the NPV calculation.
A credit spread curve does not exist on its own; it is only used in the
context of the generation of a composite curve.
Composite A composite curve consists of exactly one yield curve and any number of
Curve spread curves. The properties of the yield curve determine the properties
of the resulting composite curve.
The Yield Curve Framework allows you to define a set of basis spread
curves that are added to the yield curve, both for forward yield curves and
for yield curves that are assigned in the evaluation type/valuation rule.
Further, it is possible to derive a credit spread curve for discounting.
In Customizing, you define interest conditions for reference interest rates. Interest conditions
are used for the interest rate instrument on which the reference interest rate is based to
describe when and how much money is paid. In this way, you influence the calculations for
building yield curves. The interest conditions that can be set for the reference interest have
the following meaning:
Interest Calculation Method: Specifies the day count method and the method for
calculating the number of days in a year.
Term/Time Unit: Specifies the term of the underlying interest rate instrument in the
specified time unit.
Payment Frequency: Specifies the frequency with which interest payments are made.
The payment frequency can be used to distinguish between par coupon and zero
interest rates.
Compounding Frequency: Specifies the duration of the period during which interest is
calculated. The following equation is used to calculate the interest on paid-in capital
within a year:
R m
K1 K 0 (1 100 m
)
m specifies the compounding frequency. For example, m=4 stands for quarterly
compounding.
Calendar: The calendar that is selected here is used as the basis for the settings
made in the fields "Number of Working Days" (in terms of interest determination) and
"Shift Value Date to Working Day". If you have selected interest calculation method
actW/252, the system uses this calendar to determine the public holidays on the
basis of 252 working days per year.
Fixing Period: Specifies the duration in working days between the date of interest
fixing and the start of the first interest period. Only positive values are considered;
negative values are set to zero.
Shift Value Date to Working Day: Specifies the direction in which the payment date is
shifted if it falls on a public holiday. After the shift, the payment date can fall either
before or after the original date coinciding with a public holiday.
Maturity Dates at Month End: Dictates whether maturity dates are moved to the end
of the month when the start of the interest term falls at the end of the month.
Forward Yield Curve Type: Yield curve type used to calculate the forward interest
rates for the selected reference interest rate.
3 Yield Curves
Before you can create yield curves, you first need to define yield curve types. From within the
application, the required yield curve is calculated based on the settings made for the yield
curve type, for the yield curve, and for the reference interest rates as well as on the basis of
the current market data.
More Information
Yield Curve Type [Page 9]
o Calculate Interest Rates from the Yield Curve Generated [Page 18]
A yield curve type is the abstract description of a group of concrete curves. A yield curve type
contains one yield curve structure for different currencies.
You define yield curve types using attributes that influence market data selection and
properties such as payment frequency and compounding frequency plus any number of
currencies. As grid points on the curve, you assign reference interest rates to the currencies
of the yield curve type. For this, you can only assign reference interest rates with a currency
matching the selected currency.
On the validity date, the yield curve structure generates a yield curve that serves as the basis
for NPV calculation.
Structure
Properties of the yield curve type that define how interest rates are calculated (see also:
Calculate Interest Rates from the Yield Curve Generated [Page 18]):
Payment Frequency
Compounding Frequency
Maximum Age
Property that defines the market data that can be used to create a concrete curve.
Extrapolation Method
You achieve a concrete yield curve from the yield curve type by means of combining it with a
currency.
At this level, you assign a calendar and an interest calculation method. You then assign the
reference interest rates that provide the market data as well as specify the time fence.
The yield curve attributes Underlying Term and Underlying Time Unit are used to find, for a
specific basis spread curve type, suitable basis spread curves that can be combined with the
yield curve for forward calculation.
Example
If you create a yield curve from swap records versus three-month EURIBOR, the
underlying term of the yield curve is 3 and the period is Month.
Example
A yield curve type covers a market segment such as the swap market or the bond market.
You use this function to create yield curves. A yield curve is defined by the reference interest
rates assigned to it. The system creates the yield curve using the market data that exist for
the individual reference interest rates. In other words, the system calculates discount factors
on the grid points defined by the reference interest rates and zero rates that are constantly
subject to interest calculation.
Features
Reference Interest
Rates Assigned to the
Yield Curve, Market
Data Corresponding to
the Yield Curve Setting
"Maximum Age"
Continuously Equivalent
Interest- Portrayals
Discount
Bearing Zero
Factors
Rates
The system calculates discount factors using the bootstrapping method. The method ensures
that the discount factors can be calculated from the given market data free of arbitrage. For
this, the system performs the following steps:
Search for interest rates for a specified date for all reference interest rates assigned
to the yield curve. For this, the Direct Read-Back method is used, with specification of
a maximum age:
o Determination of the read date using the condition Date Smaller than or
Equal to Specified Date for the reference interest rates assigned to the yield
curve. Starting with the specified date, the system searches for the latest
date in the past for which market data exists. This means that the system
takes the specified date and then continues to set the read date to the
proceeding date until it finds an interest rate for at least one of the reference
interest rates assigned.
o If the read date established in this way exceed the maximum age (the read
date is earlier than the date achieved by subtracting the maximum age from
the specified date), the system behaves as if no market data were found. In
such instances, the system does not create a yield curve.
o If the read date established is not too far in the past, the system reads from
the market data table the existing interest rates for this date and for all
reference interest rates assigned to the yield curve and uses the interest
rates found on the read date to build the yield curve for the specified date.
This yield curve is then valid for the specified date.
2. Determining Payment Amounts and Payment Dates for the Assigned Reference
Interest Rates
Using the interest conditions of the reference interest rates, the system calculates the
payment amounts and payment dates of the individual reference interest rates for
which market data was found:
This date is achieved by adding the fixing period to the validity date. To
determine the working days and public holidays, the system uses the
calendar specified for the reference interest. If you have not specified a
calendar, the system ignores the number of working days for the purpose of
interest calculation; the start of the first interest period is in this case the
same as the validity date. The start of the first interest period corresponds to
the date on which capital was paid for the underlying interest rate instrument
for the reference interest rate.
On the basis of the entries made for the Term/Time Unit and Payment
Frequency fields for the reference interest, the system calculates the
payment dates, from the start of the first interest period.
o Depending on which setting you have made in Customizing for the Shift
Value Date to Working Day indicator for the reference interest rate, the
system moves the payment dates that were determined in the previous step
to working days, based on the rule specified. The system applies the shifted
payment dates in the following step.
o Calculation of the quotients - resulting from the number of days divided by the
name of days in the year - for each individual interest period of the reference
interest rate, on the basis of the interest calculation method specified in
Customizing for the reference interest rate. The payment date of the previous
interest period is applied as the start date of each interest period (or, if the
current interest period is the first interest period, the start date of that interest
period is applied), and the payment date of the current interest period is
applied as the end date of the interest period.
Multiplication of the interest rate found with the quotients calculated in the
previous step by dividing the number of days by the number of days in the
year. In the case of a zero interest rate with a term that is longer than a year,
the interest share "C" of the repayment is achieved using the following
equation:
C 1 0 0 ((1 R /100)q 1)
Where R: zero interest rate, q: quotient resulting from the number of days
divided by the number of days in the year.
o The system then sets as the date for the capital repayment the payment date
of the last interest period.
The system sorts the found interest rates ascending by term and calculates the
discount factors recursively in exactly the same sequence.
Together with the quoted interest rate, each reference interest rate implicitly provides
a well-defined cash flow of n interest payments Ci (calculated in the step Determining
Payment Amounts and Payment Dates for the Assigned Reference Interest Rates)
including repayment of 100. The quoted interest rates are noted at par level, that is,
the NPV of the cash flow of all future payments is the same as the outstanding debt
of 100. To calculate the NPV, the system multiplies each individual payment (interest
and capital repayment) with a discount factor di. You obtain the NPV equation (where
d0 is usually equal to 1, d0 is not equal to 1 when the start date of the first interest
period is not the same as the validity date):
n
100d 0 d iC i 100d n
i 1
The system now benefits from the fact that the yield curve has already been created
up until event Tn-1 and that, consequently, the discount factors d0 through dn-1 of the
payment date T0 through Tn-1 are already known. The discount factors are deemed to
be known if they have previously been calculated or can be obtained using
interpolation (yield curve framework) [Page 15]. To calculate dn, the above equation is
activated towards dn, as the following equation shows:
n 1
100 d 0 d iC i
d n 100
i 1
C n
In this way, you obtain discount factors for all terms determined by the reference
interest rates. This approach is known as bootstrapping.
5. Calculating Discount Factors for Zero Interest Rates with a Term Exceeding a Year
In the case of zero interest years with a term exceeding a year, the system calculates
the discount factors differently to the above method. Instead, it uses the equation
depicted below:
q
dn d 0 (1 R / 100 )
For zero interest rates with a term exceeding a year, this approach assumes a
compounding frequency of one year.
If the payment date T0 for discount factor d0 already falls after all payment dates (grid
points) that were previously created in the yield curve, the system assumes that the
continuous compounding zero interest rates are the same between the last available
grid point and T0 and between T0 and the first interest payment date. As a grid point,
the validity date on which the discount factor is always equal to 1 implicitly also
applies to the yield curve.
If, however, a grid point with a longer term exists, the system interpolates d0.
The reference interest rate with the shortest term in the yield curve has a
term of one month, the payment frequency is monthly, and the start date of
the interest period is two working days after interest fixing (after the validity
date of the interest rate).
In this case, the system assumes that the continuous compounding zero
interest rates between the validity date of the yield curve and the validity date
of the interest rate, on the one hand, and the start date of the interest period
and the end date of the interest period on the other hand are the same. Using
this assumption, the system can calculate d0.
It is not always the case that all discount factors d0 through dn-1 are already known to
the system. If, for example, reference interest rates for one-, two-, three-, four-, five-,
seven-, and ten-year terms are assigned to a yield curve, there are missing grid
points (the swap gaps) for six, eight, and nine years so that the system can use the
above-cited equation. For example, for determining d7, discount factor d6 is missing.
The system cannot yet perform an extrapolation [Page 16] to determine d6 because
this is only possible for a yield curve that has been created completely. For this
reason, the system must use a different method to fill these gaps. The system uses
linear interpolation. To calculate the interest rate for six years, the system interpolates
the par rates of the reference interest rates with the terms of five and seven years,
using linear interpolation and to the exact day, as shown in the following equation:
(T7 T6 ) R5 (T6 T5 ) R7
R6
T7 T5
In this example, it is assumed that there is an interest payment once a year for all
interest rates.
For the terms Ti of the relevant reference interest rates, the quotient of the actual
number of days divided by 365 is used. This interpolation of par interest rates occurs
exclusively during the creation of the yield curve for the purpose of filling the swap
gaps. When the yield curve has been created completely, however, the system
interpolates using the method described in the section "Interpolation". If the interest
conditions are different in the case of two reference interest rates that follow on from
each other, whereby the interest calculation methods for R5 and R7, for example,
differ, the system calculates, at point in time T5, an interest rate noted at par level in
the interest calculation method for R7, and deploys this interest rate in the above
formula. For more information about calculating interest rates, see Calculate Interest
Rates from the Yield Curve Generated [Page 18]. For the system to be able to apply
the above formula, the interest conditions of the relevant interest rates must be
identical (but the terms may differ).
After filling the gaps, the system calculates the missing discount factors (see
Calculation of Discount Factors). Once all discount factors have been calculated up
until the grid point with the longest term, the yield curve is complete.
The system uses this function to interpolate interest rates for terms that have not been
created in the system.
Features
Using the discount factors d calculated along the grid points during the creation of the yield
curve, the system calculates zero interest rates ZCC with continuous interest calculation
(continuous compounding zero) by activating the following equation towards Z:
ZccT
d e
The term T is always portrayed in the ACT/365 format and measured between the validity
date of the yield curve and payment date.
For the interest rates in this portrayal, the system performs linear interpolation to the exact
day, that is, the interpolated continuous compounding zero rate ZX is achieved using the
following equation:
T2 TX Z1 TX T1 Z 2
ZX
T2 T1
The system calculates the discount factor dX using the following equation:
ZxTx
dX e
Interest
Rates Before
Interpolation
Grid Point 1 Grid Point 2 Grid Point 3 Grid Point 4 Grid Point 5
Interpolation Range
Interest
Rates After
Interpolation
Grid Point 1 Grid Point 2 Grid Point 3 Grid Point 4 Grid Point 5
3.2.2 Extrapolation
The system performs an extrapolation on the completed yield curve if an interest rate or
discount factor is requested for a term that is greater than the longest term of all grid points of
the yield curve.
Features
In the Customizing settings for the yield curve, you can choose between the following
methods:
It is assumed that the continuously interest-bearing zero rate for all terms in the
extrapolation area is the same as the last available continuously interest-bearing zero
rate in the yield curve.
It is assumed that the last available par interest rate in the yield curve, once
converted into the continuous interest-bearing portrayal, is the same as the
continuously interest-bearing forward interest rate in the entire extrapolation area.
This achieves almost constant par interest rates for terms in the extrapolation area.
However, using this option does not mean that the par interest rates in the
extrapolation area are exactly the same as the par interest rate on the last grid point.
The system performs the following calculations:
o Calculation of the par interest rate for the last yield curve grid point based on
the conditions set for the yield curve (for more information, see Calculate
Interest Rates from the Yield Curve Generated [Page 18]).
If you have selected the payment frequency Zero Interest Rate: One
Interest Payment at End of Term in the Customizing settings for the
yield curve, the system nevertheless assumes a payment frequency
of one year for the par interest rate to remain constant.
P
F exp(m log(1 100m
))
T Tn
dT Tn d Tn F
log( d (T Tn ))
Z CC (T Tn ) T
The system assumes that the continuously interest-bearing forward rate on the last
grid point of the yield curve is the same as the continuously interest-bearing forward
interest rate in the entire extrapolation area. The system performs the following
calculations:
Z CC ( Tn ) Z CC ( Tn 1 )
s T n Tn 1
Z CC (T Tn ) f (T n ) ( Z CC (T n ) f (T n )) TTn
Once the yield curve has been created, it is used to calculate the interest rates on the basis of
the interest conditions that are set in the yield curve. The interest rate R is noted at par level if
the condition represented by the following graphic applies for R:
n
100 d 0 d i Rq i 100 d n
i 1
The quotients qi from the difference in days and days in the year as well as the payment
dates i are achieved from the conditions of the interest rate. To calculate R, the system
activates the equation towards R, as portrayed in the following graphic:
R 100 dn0 dn
di qi
i 1
Either the system has already calculated the discount factors di during the creation of the
yield curve, or they are achieved by means of interpolation with the continuous compounding
zero rates.
The prerequisite for this is that the last and not the first interest period is shortened if the term
is not a whole-number multiple of the payment frequency.
If a zero interest rate with a term exceeding a year needs to be calculated, the system uses a
different equation to the method portrayed above. Instead, it uses the equation depicted
below:
R 100 (( d 0 / d n )1 / q 1)
This means that, for zero interest rates with a term exceeding a year, the system assumes a
compounding frequency of one year.
Basis spreads are premiums and discounts on one side of a basis swap that make the swap
into a fair transaction. The spread relates to the first two reference interest rates assigned.
You can define tenor spreads and currency spreads. Basis spreads need to be defined before
you can perform the following activities:
Build Basis Spread Curves from Basis Spreads with Different Terms
Structure
To portray basis spreads, you need to create basis spread IDs in Customizing for Treasury
and Risk Management under Basic Functions Market Data Management Master Data
Basis Spreads Define Basis Spreads .
You assign to a basis spread ID two reference interest rates, the term, and the time unit.
If you want to portray a tenor spread, assign two reference interest rates with the
same currency and different terms. The first reference interest rate is the one to
which the spread is added. In this way, the properties of the first reference
interest rate determine the quotation of the basis spread.
If you want to portray a currency spread, assign two reference interest rates with
the same term and different currencies. The first reference interest rate is the one
to which the spread is added. In this way, the properties of the first reference
interest rate determine the quotation of the basis spread.
In the Extended Properties area, you can override some of the settings of the assigned
reference interest rate by setting the Extended Properties indicator. When you set this
indicator, the following fields are made visible:
Payment Frequency
Compounding Frequency
Fixing Period
Calendar
Example
You want to portray a tenor spread that creates the surcharge on the three-month side of a
term basis swap 3-Month EURIBOR versus 6-Month EURIBOR, with a term of five years.
You manually enter the concrete values of the basis spreads for a specific date in the area
menu of Treasury and Risk Management under Basic Functions Market Data
Management Manual Market Data Entry Basis Spreads Enter Basis Spreads .
Instead of entering the basis spread values manually, you can also upload basis spread
values in the same way as other market data, such as with Datafeed [External], the file
interface, or by using Market Data Transfer from Spreadsheet [External].
See also:
You can include basis spreads in the price calculator for the calculation of discount factors
and forward interest rates. For this, you define basis spread curve types in Customizing for
Treasury and Risk Management under Basic Functions Market Data Management
Master Data Basis Spreads Define Basis Spread Curve Types and use them as the
basis for creating the basis spread curves that, together with the yield curve, form the
composite curve used as the basis for the calculations.
In the definition of the basis spread curve types, no settings are made regarding the interest
rates derived from the curve because basis spread curves are not created as independent
curves; instead, they are only used in conjunction with the creation of a composite curve. For
a concrete curve to be achieved from the curve type, a concrete pair of currency/tenor
combinations (for example, currency 1/tenor 1 <-> currency 2/tenor 2) is required.
The quotation type stored at the level of the basis spread curve type is for information
purposes only.
The maximum age stored is relevant for the market data uploaded for a concrete curve. The
quotation stored at the level of the concrete curve influences what market data is selected.
You use this function to enter basis spread values manually in the market data tables. A basis
spread value always relates to a basis spread ID, a quotation type, and a rate date. You can
enter positive as well as negative basis spread values.
Prerequisites
You need to have created the basis spreads in Customizing for Treasury and Risk
Management under Basic Functions Market Data Management Master Data Basis
Spreads Define Basis Spreads .
Activities
1. Call the function in the SAP Easy Access menu for Treasury and Risk Management
under Basic Functions Market Data Management Manual Market Data Entry
Basis Spreads Enter Basis Spreads (transaction RMBSM) or in Customizing under
Basic Functions Market Data Management Manual Market Data Entry Basis
Spreads Enter Basis Spreads .
2. Choose Display or Choose to call up the display/change mode for the market data
table for the basis spread values.
To restrict the number of basis spread values in the display, you can use the
Basis Spread ID, Quotation Type, and Rate Date fields.
By choosing (Display <-> Change), you can switch between the display and
change modes.
3. In the change mode, you can enter new basis spread values or change existing ones.
2. Enter a basis spread ID in the Basis Spread ID field and a quotation type in
the Quotation Type field.
4. Enter the basis spread values in basis points, where one basis point
corresponds to a hundredth of a percentage point.
6. If you have entered a line incorrectly, select the line and choose (Delete).
Define Credit Spread Customizing: Treasury and Risk Management In this Customizing activity, you create credit
IDs (view Basic Functions Market Data Management Master spread IDs by specifying their characteristics.
V_FTBBYCCSPRD) Data
In the Market Data Quotation area, you can
define how the yield curve framework interprets
the market data. For this, you make entries in the
following fields:
Payment Frequency
Compounding Frequency
Fixing Period
Calendar
Maintain Reference Area menu: Treasury and Risk Management Basic You also need to create the reference entities
Entities (transaction Functions Market Data Management Manual Market that are referred to by your credit spreads. You
RMRE) Data Entry Credit Spread Curves can assign business partners, company codes,
and security ID numbers to reference entities.
Create Reference However, you can also define more general
Entities for Business reference entities for ratings or industries.
Partners (transaction
RMREBP) To create reference entities for your business
partners, you can use the program Create
Reference Entities for Business Partners
(transaction RMREBP).
See also:
Convert Credit Spread Customizing: Treasury and Risk Management In this activity, you define the conversion codes
Quotation Types (view Basic Functions Market Data Management Master for credit spread quotation types.
V_MDUDFCS) Data Datafeed Translation Table Define Datafeed
Conversion Codes Define the external names for the required
quotation types. Consult your datafeed provider
to establish which names (instrument properties)
are recognized by your external partner program.
Define Credit Spreads Customizing: Treasury and Risk Management In this activity, you define how to import credit
(view V_DFCU10) Basic Functions Market Data Management Master spreads using the external partner program of
Data Datafeed Translation Table your datafeed provider.
Notation:
Prerequisites
Activities
manually.
Convert Codes for Customizing: Treasury and Risk Management In this activity, assign the quotation types used by
Quotation Types (view Basic Functions Market Data Management Master your data provider to the quotation types used in
V_MDUCS) Data File Interface Credit Spreads the sytem.
System notation:
1 (Middle)
2 (Bid)
3 (Ask)
MID
BID
ASK
Define Credit Spread Curve Customizing: Treasury and In this Customizing activity, you define credit spread curve
Structures (transaction Risk Management Basic structures and use attributes that influence the selection of market
RMCSC) Functions Market Data data. Further, you assign credit spread IDs to define the term
Management Master Data structure of the curve.
2. Choose "Create".
In the next screen that appears, enter the ID for the new
structure. The system creates the new structure with the
same settings. Enter the new structure ID and choose
"Change" to make the necessary changes to the new
structure.
Further, you can use the following functions for credit spread curve
structures:
2. Choose Goto.
inconsistencies.
Where-used list
Assign Reference Entities to Area menu: Treasury and Risk For many business partners, there is no credit spread
Business Partners Management Market Risk market data available, which means that these business
(transaction Analyzer/Portfolio Analyzer/Accounting partners cannot be created directly as reference entities
RMBPRE_ASSIGN) Analyzer/Analyzer for Commodities in the system. It may nevertheless be necessary for
Evaluation Control Valuation Settings valuation purposes to apply the most suitable credit
spread curve as a substitute credit spread curve for
these business partners. Depending on the semantics
Define Reference Entity Customizing: In this Customizing activity, you define for all clients the
Derivation IDs (view cluster derivation IDs for reference entities. A reference entity
VC_FTBB_YC_REF_ENTITY_ Treasury and Risk Management Basic derivation ID controls how the system derives reference
DERI) Analyzer Settings Valuation entities representing the business partner or your own
company code that is involved in the financial
transactions/positions. Based on the credit spread curve
structures of these reference entities, the system
creates credit spread curves that are added to yield
curves at runtime to form composite curves. The ID is
relevant for yield curve types that are entered in the
evaluation type/valuation rule and are used, for
example, for discounting.
Notes:
Activities
BAdI: Derive Reference Entity Customizing: This Business Add-In (BAdI) is used in Treasury and
for Your Own Companies Risk Management (FIN-FSCM-TRM) to derive reference
(BADI_FTBBYC_REF_ENTIT Treasury and Risk Management Basic entities for your own companies - and consequently
Y_OWN) Analyzer Settings Valuation Spread credit spread curves for your own companies - for
Curve Derivation evaluation purposes such as discounting. The BAdI filter
"Reference Entity Derivation ID for Your Own
Companies" is the only procedure for deriving credit
spread curves for your own companies (see also the
Customizing activity Define Reference Entity Derivation
IDs).
Prerequisites
Activities
1. Security ID
2. Transaction/Position CoCode
BAdI: Derive Reference Customizing: This Business Add-In (BAdI) is used in Treasury and
Entities for Business Partners Risk Management ((FIN-FSCM-TRM) to derive
Prerequisites
Activities
1. Security ID
2. BP Hierarchy
3. Assignment Table
Define and Set Up Evaluation Customizing: In this Customizing activity, the settings for credit
Types (transaction CFMEVAL) spreads have been added to the Evaluation Control tab
Treasury and Risk Management Basic has been added in the evaluation type as well as in the
Analyzer Settings Valuation valuation rule.
BP Relationship Category
Dependencies
structures.
Maximum Age
You can either enter credit spreads manually or transfer them automatically from a market
data provider (using datafeed, the file interface, or an Excel upload).
Credit spread IDs need to be defined before you can perform the following activities:
Upload credit spread market data to the system (or enter it manually)
Define credit spread curve structures from credit spreads with different terms
In combination with the reference entity, a credit spread curve structure defines a
concrete credit spread curve that can be combined with yield curves in the Yield
Curve Framework. See also: Composite Curves [Page 46]
Prerequisites
To portray credit spreads, you need to create credit spread IDs in Customizing for
Treasury and Risk Management under Basic Functions Market Data
Management Master Data Credit Spread Curves Define Credit Spread IDs .
In a credit spread ID, you describe the credit spread. Choose "New Entries" and then,
in the Credit Spread Definition area on the screen that appears, enter the term using
the time units Day, Month, and Year, and enter a name.
o Payment Frequency
o Compounding Frequency
o Fixing Period
o Calendar
You can include credit spreads in the price calculator for the calculation of discount
factors. For this, you define credit spread curve structures in Customizing for
Treasury and Risk Management under Basic Functions Market Data
Management Master Data Credit Spread Curves Define Credit Spread Curve
Structures . On the basis of these credit spread curve structures, credit spread
curves are then created using a reference entity. Together with the yield curve and
any additionally created basis spread curves, the credit spread curves generate a
composite curve that is then applied in the calculations.
In the definition of the credit spread curve structures, no settings are made regarding
the interest rates derived from the curve because credit spread curves are not
created as independent curves; instead, they are only used in conjunction with the
creation of a composite curve.
The maximum age and quotation type specified influence which market data is
selected.
You can assign the same credit spread curve structure to reference entities
for which there are credit spreads with the same terms and quotation
properties (such as payment frequency and days calculation method). This
reduces considerably the number of credit spread curve structures that need
to be created in the system. Furthermore, it reduces the effort required in
Customizing in cases when credit spread curves need to be used for an
additional business partner: Provided that a suitable credit spread curve
structure exists (regarding the terms and quotation properties of the credit
spreads), new settings do not need to be made in Customizing. You simply
need to create a new reference entity and assign the existing credit spread
curve structure to it.
Reference Entities
You create the required reference entities either in the area menu of Treasury and
Risk Management under Basic Functions Market Data Management Manual
Market Data Entry Credit Spread Curves Maintain Reference Entities
(transaction RMRE) or using the program Create Reference Entities for Business
Partners [Page 41] (transaction RMREBP), which is also found at the same location in
the area menu.
You manually enter the concrete values of the credit spreads for a specific date in the
area menu of Treasury and Risk Management under Basic Functions Market
Data Management Manual Market Data Entry Credit Spread Curves Enter
Credit Spreads . See also: Enter Credit Spread Values [Page 45]
Instead of entering the credit spread values manually, you can also upload credit
spread values in the same way as other market data, such as with datafeed
[External], the file interfaces [External], or by using a market data transfer from a
spreadsheet [External].
You use this program to create reference entities simultaneously for multiple business
partners.
Activities
Selection
1. Call the function by choosing Treasury and Risk Management Basic Functions
Market Data Management Manual Market Data Entry Credit Spread Curves
Create Reference Entities for Business Partners (transaction RMREBP).
2. Enter the business partners for which you want to create reference entities.
3. Choose the business partner roles for which you want to create reference entities.
The role Counterparty, Issuer, and House Bank are set by default.
If you do not enter a business partner and you do not change the business
partner role default settings, the system selects all existing business partners
that have these roles assigned to them.
4. Enter the prefix (maximum of 5 digits) for the reference entity ID of the new reference
entities. The default setting is BP_.
5. Overwrite Existing Entries indicator: Specify whether reference entities with the same
ID are overwritten. If you set this indicator, the system overwrites existing reference
entities.
6. Avoid Duplicates indicator: Specify whether duplicate reference entities for a business
partner are allowed. When you set this indicator and, in addition, you have not made
the setting allowing existing reference entities to be overwritten, the system does not
create a second reference entity with the same ID for a business partner, and existing
reference entities remain unchanged.
7. If you want to use the reference entities in the Yield Curve Framework, set the Use in
Credit Spread Curve indicator. Assign the credit spread curve structures to the credit
spread curves "Bid", "Ask", and "Middle".
Result
The system creates a reference entity for each business partner selected.
The ID of the reference entities consists of the prefix and the business partner name.
If you have set the Use in Credit Spread Curve indicator, the credit spread curves for the new
reference entity are also defined.
You can use the function Maintain Reference Entities [Page 42] (transaction RMRE) to rework
the reference entities.
Example
If you execute the report with the default values for the selection parameters, the system
creates new reference entities for all business partners with the roles "Counterparty", "Issuer",
and "House Bank" in your system.
The reference entities are named BP_PARTNER, where PARTNER stands for the name of
the business partner. Existing entries are not overwritten, and duplicates are not allowed.
Security ID numbers
Ratings
You can use this function to create and change reference entities. To create reference entities
automatically for your business partners, you can use the program Create Reference Entities
for Business Partners [Page 41].
For many business partners, there is no credit spread market data available, which
means that these business partners cannot be created directly as reference entities.
It may nevertheless be necessary for valuation purposes to apply the most suitable
credit spread curve as a substitute credit spread curve for these business partners.
For this, you can use the function Assign Reference Entities to Business Partners
[Page 44] (transaction RMREBP_ASSIGN).
Activities
1. Call the function in the area menu for Treasury and Risk Management by choosing
Basic Functions Market Data Management Manual Market Data Entry Credit
Spread Curves Edit Reference Entities (transaction RMRE) .
An overview of all previously defined reference entities appears. You can display or
change existing reference entities or create new reference entities.
2. Choose (Display -> Change) to switch from the display mode to the change mode.
In the change mode, you can make changes to existing reference entities or create a
new reference entity.
2. In the Definition area, under Standard Attributes for Spread Curve Definition,
specify the business partner, company code, or ID number to which the
reference entity relates.
For these standard attributes, the Yield Curve Framework can automatically
derive the appropriate reference entity.
If you want to portray other types of reference entity, you can select
combinations of the attributes in the Additional Attributes area. The following
attributes are available:
Rating Procedure
Rating
Industry System
Industry
Country
Currency
In this way, you can create more general credit spread market data, for
example, in cases when no specific credit spread market data is available for
one of your business partners. You then need to manually assign these
reference entities to a business partner. This is because an automatic
assignment by the system is not possible. See also: Assign Reference
Entities to Business Partners [Page 44]
3. In the Settings for Usage in Yield Curve Framework area, set the Use in
Curve indicator when you want the related credit spread curves to be used in
the composite curves of the Yield Curve Framework.
Further, you need to assign which credit spread curve structures are used for
the credit spread curves "Bid", "Ask", and "Middle".
Example
Reference Entity Business Partner Company Code Security ID Number
BP_AA AA
CC_1000 1000
SID_123456 DE123456
For many business partners, there is no credit spread market data available, which means
that these business partners cannot be created directly as reference entities in the system. It
may nevertheless be necessary for valuation purposes to apply the most suitable credit
spread curve as a substitute credit spread curve for these business partners. Depending on
the semantics involved, there are many different approaches for finding a substitute curve
(search by ratings, industries, countries, similar companies, indexes, and so on).
The system cannot automatically assign these alternative reference entities to the business
partners, which means that you have to use this function to assign the relevant reference
entity to the affected business partners.
Activities
1. Call the function by choosing Treasury and Risk Management Market Risk
Analyzer / Portfolio Analyzer / Accounting Analyzer Evaluation Control Valuation
Settings Assign Reference Entities to Business Partners (transaction
RMBPRE_ASSIGN).
2. Choose (Display -> Change) to switch from the display mode to the change mode.
In the change mode, you can make changes to existing assignments or create new
assignments.
3. To create a new assignment, select the business partner and assign the relevant
reference entity to it.
Example
Business Partner Reference Entity
CC Rating_CC
DD_AG ITRX_EUR_NONFIN
You use this function to enter credit spread values manually in the market data tables.
A credit spread value always relates to a reference entity, a credit spread ID, a quotation type,
and a rate date.
Prerequisites
You need to have created credit spread IDs in Customizing for Treasury and Risk
Management under Basic Functions Market Data Management Master Data
Credit Spread Curves Define Credit Spread IDs .
You need to have created reference entities. You use the following functions to create
reference entities:
Activities
1. In the application menu, call the function by choosing Treasury and Risk
Management Basic Functions Market Data Management Manual Market Data
Entry Credit Spread Curves Enter Credit Spreads (transaction RMCSM).
2. Choose Display or Choose to call up the display/change mode for the market data
table for the credit spread values.
To restrict the number of credit spread values in the display, you can use the
Reference Entity, Credit Spread ID, Quotation Type, and Rate Date fields.
By choosing (Display <-> Change), you can switch between the display and
change modes. In the change mode, you can enter new credit spread values or
change existing ones.
Choose New Entries. Alternatively, select entries and copy the selected lines by
choosing (Copy).
4. Choose the reference entity, the credit spread ID, and the quotation type.
6. Enter the credit spread values in basis points, where one basis point corresponds to a
hundredth of a percentage point.
8. If you have entered a line incorrectly, select the line and choose "Delete". In the
change mode, you can change or delete existing credit spread values. To delete a
value, select the line and choose "Delete".
7 Composite Curves
Each composite curve consists of exactly one yield curve and any number of basis spread
curves. The properties of the yield curve determine the properties of the resulting composite
curve.
The Yield Curve Framework allows you to define a set of basis spread curves that are added
to the yield curve, both for forward yield curves and for yield curves that are assigned in the
evaluation type/valuation rule. Further, it is possible to derive a credit spread curve.
Intermediate Step: Add Up Continuously Interest-Bearing Zero Rates, Grid Points Inherited from Yield Curve
Composite
Curve:
Continuously Discount Factors of
Interest-Bearing the Composite Curve
Zero Rates
Step 2: Calculate Interest Rates Based on Properties of the Yield Curve (If Required)
First, the basis spread curve type is determined. This is either the basis
spread curve type (bid/ask) that was assigned in the relevant evaluation
type/valuation rule or, in the case of forward calculations, the basis spread
curve type that was assigned to the yield curve type of the relevant yield
curve for forward calculations.
For example, for the determination of the basis spread curve(s) for
evaluation purposes, SAP delivers two implementation example
classes for the BAdI BADI_FTBBYC_SPREAD_CURVES_EVAL BAdI:
Derive Basis Spread Curves for Evaluation Purposes. Now you need
to create your own implementations, which you can base on the
implementation example classes:
CL_FTBBYC_EX_BSPRD_DER_EVAL001 Example:
Derivation of Currency Spreads for Discounting
Example
If the tenor of a yield curve differs from the term of the reference
interest rate, the implementation TENO looks for a matching tenor
spread curve. In this way, you can, for example, assign a swap curve
versus 6–Month EURIBOR as a forward curve for all EUR reference
interest rates like the 3–Month EURIBOR. Spread curve derivation
then looks for a matching spread curve to build the three-month
forward curve from the six-month yield curve and from the three-
month/six-month tenor spread curve.
For outgoing payments, the credit spread curve for your own company is used,
whereas, for incoming payments, the credit spread curve of your business partner is
used. Credit spread curves are derived using the reference entities. The system only
considers reference entities for which the Use in Curves indicator has been set.
The system determines the reference entity for your own companies separately from
that for business partners. In both cases, there is a standard derivation logic that you
can replace using your own implementations of the BAdIs BAdI: Derive Reference
Entity for Your Own Companies sowie BAdI: Derive Reference Entity for Business
Partners. For this, the system first determines the derivation IDs that are assigned in
the relevant evaluation type/valuation rule for derivation of the reference entities.
that company code, the system searches for a reference entity for
the company code entered in the evaluation type/valuation rule.
Reference Entity for Your Business Partner (in the Counterparty role)
The standard implementation first checks the settings that you have
made in the evaluation type/valuation rule on the Evaluation Control
tab in the Credit Spread Curve Derivation area.
If the system does not find any reference entities for the business
partners determined in this way, it searches in the assignment table
Geschäftspartner zu Referenzeinheiten zuordnen (transaction
RMBPRE_ASSIGN) for reference entity that is assigned to the
business partner.
Determine Company
Determine BP Relation- Code
ship Cat. in Eval. Type Determine Bus. Partner
(Counterparty Role)
Determine Reference Entity
The system first searches for a reference entity for the securities ID number.
If there is no reference entity for the ID number, the system searches for the
reference entity of the issuer. The business partner is used for asset
positions, and the company code is used for liabilities positions. The
remaining steps of the procedure are the same as those for OTC
transactions.
Reference Entity
No Reference Entity Found
No Relationship Category Found
Found
Relationship Category Found
Determine Company Code of
Determine Related BP Evaluation Type
The credit spread curve results from the credit spread curve structure assigned to the
reference entity determined and from the designation "Bid" versus "Ask".
First, the yield curve, the basis spread curves, and the credit spread curves are built.
As a result, the relevant zero rates are available. See also: Creation of Yield Curves
[Page 10], Basis Spreads and Basis Spread Curves [Page 19], and Credit Spreads
and Credit Spread Curve Structures [Page 39]
Now the composite curve is constructed by adding the zero rates to the grid points of
the ‘leading’ yield curve. The grid points of the yield curve are copied to the
composite curve. If necessary, interpolation or extrapolation is used to calculate the
zero rates of the basis spread curves and the credit spread curves.
o Interpolation
o Extrapolation
Based on the composite curve, interest rates are calculated in the same way
as the procedure for yield curves. See also: Calculate Interest Rates from the
Yield Curve Generated [Page 18]