Financial Instruments Guide for PM
Financial Instruments Guide for PM
You are here: Home > Front Office - PM > Front Office > Financial Instruments Reference Guide
Overview
Front Office – Por olio Management (PM) is a comprehensive asset management package for UNIX-Windows NT networks. The package implements the latest
client/server technology in conjunc on with the Sybase database. The Front Office – PM server side so ware uses advanced analy cal and flow control func onality,
including a financial server, a report generator, and a database server to structure, access, and administer the database.
On the client side, Front Office – PM runs on Windows NT worksta ons. A variety of screens allow you to interact with the Sybase database. The data in the fields
presented on the various screens is recorded directly in the appropriate database tables when you validate it (usually by clicking OK bu on in a data entry screen).
Front Office – PM makes extensive use of lists to display table data. For many opera ons, a selec on screen first displays a list so you can select an exis ng entry to
view or modify. If the object is not in the list or the list is empty, a Create bu on lets you create a new object of the list type. When you create and validate a new
object, you are in fact entering a new record in the database. When you view or modify a list item, you are in fact reading records from the database and returning
modified records to the database if you validate your changes. A host of hidden features helps you manage this data and perform a wide range of financial
calcula ons on it.
Front Office – PM also includes extensive, advanced script and interface languages that allow you to run the program in batch mode and to customise it to meet your
requirements. This way, Front Office – PM can manipulate large volumes of data.
Front Office – PM implements all financial func ons used in today's markets and lets you record all major financial opera ons currently prac sed. Advanced analysis
and risk features help you make the right decisions on me.
Stocks
Fixed Income
Op ons
Cash Accounts
Money Market
Forward Contracts
Future Contracts
Index
Rate
Swaps
Discount Instruments
Commodi es
Fund Share
Curves
Deliverable Instruments
Debts
Op on Bonds
Other Instruments
Forex Swaps
Exo c Op ons
Mortgage-Backed Securi es
Swap ons
Flow Instruments
Structured Products
Defini on of Instruments
The concept of financial instruments encompasses all the assets (stocks, bonds, cash accounts) and contracts (op ons, futures) that can be held in a por olio as well
as any underlying instruments (indexes, rates) that support their pricing mechanisms.
All instruments are stored in the same table. Real or possible cash flows are defined in associated events sub-tables.
Composite instruments are complex instruments that you build from basic component instruments.
Common Data
Accrual Rules
Event Tables
Simple Instruments
The list of instrument natures is as follows: Stock, Fixed Income, Op on, Cash Account, Money Market, Future, Forward, Index, Rate, Swap, Discount Instrument,
Commodity, Fund Share, Yield Curve, Deliverable, Debt, Other, Op on Bond, Conver ble Bond, Forward Rate Agreement, Forex Swap, Exo c Op on, Swap on,
Mortgage-Backed Security, Flow Instrument and No onal Instrument.
Nature Sub-natures
Common Data
The following a ributes are applicable to most instruments:
A ribute Descrip on
Code Most common iden fica on code for instruments. This is the default code for
all instruments (e.g. CH00xxxx for Nestle).
Denomina on Long name of the instrument in the default language of the system.
Mul -Lingual Denomina on sub-table permits mul lingual denomina ons to be a ributed.
Denomina on
Codifica on Synonym sub-table associates other instrument codes with the instrument
(Reuters code, Telekurs, CEDEL, etc).
A ribute Descrip on
User-defined classifica on
Type You can associate the instrument with a user-defined hierarchy of types and
subtypes.
Subtype
Issue data
Reference Indicates the currency of the principal or capital. For contracts, this is the main
Currency quota on currency.
Parent The original stock of which the current instrument is a foreign cer ficate (e.g. an
Instrument ADR). For cash accounts, it is used to define a "parent" cash account that
contains all the informa on rela ng to interest rates. With interest changes, you
only enter data at the parent cash account level.
Vote Quan ty Mainly used for stocks to indicate how many vo ng rights are associated with
one share. Can be used for constraints (e.g. a fund is not allowed to hold more
than 5% of vo ng rights).
Face Value Nominal value of a stock or bond quoted in units. (e.g. 1 unit of OAT bond
represents 2000 FRF).
Issuer The third party that issued the instrument, e.g. Belgian Government.
Issue Number of instruments issued in the market. Could be used for constraints (e.g.
Quan ty not more than 7% of the same non-sovereign issuer).
Contract Size Used to define the quan ty implied by one contract, e.g. 100 for US stock
op ons.
Notepad Used to store any comments (textual) on the instrument. These comments are
shared with any users who have access to the instrument.
Wrap Eligible Indicates if the instrument is eligible for wrap services. Instrument natures such
as Stock, Fixed Income, Fund share, Conver ble Bond and Mortgage-Backed
Security are eligible for wrap services. An instrument being eligible for a wrap
service means that the various fees (administra ve expenses, management
expenses, commissions for trading, investment advice etc.,) on that instrument
can be wrapped into a single fee for all the services provided.
Risk Data
Risk Nature Risk factor to which the instrument is exposed, e.g. equity for stocks,
commodity for gold mining stocks, interest rate for Fixed Income, etc. The Risk
Nature is used in the risk engine (see below).
A ribute Descrip on
Sector A sub-table storing the economic sectors linked to the issuers of the
A ribu on instruments. Various sector sources can be held (NACE, BNS, etc.).
Market Data
Last Trade Indica ve date on which the instrument can be traded (especially in deriva ve
Date contracts).
Quota on Data
Market The main market on which the instrument price is quoted (e.g. NYSE, LIFFE).
Theore cal: the price is computed from a model, a yield curve (for
example, op ons, swaps)
Parent Price: adopts the price of the parent instrument (used mainly
in fund spli ng)
A ribute Descrip on
Price Indicates how the unitary amount (price) is computed from the market quote.
Calcula on The unitary amount is the value of one unit of instrument (e.g. a discount
Rule instrument is quoted at 3.725% and the unitary amount is 0.9866; for stocks,
the quote and the price are the same; for bonds, the quote is 102 and the price
is 1.02).
Note: The Script Valua on rule ini ates a complete fund valua on process to
calculate its value. This means that a complete fund valua on is also performed
in the Journal and Event Genera on func ons for this purpose (if there are
debts in the por olio). The simple Script Valua on rule does not start a fund
valua on but simply evaluates the script as it stands. This makes the Journal and
Event Genera on func ons more efficient.
Tax Data
The taxa on of instruments is handled by script language key words that normally use the fees
and tax conven on tables. However, the following a ributes can also be referenced if instrument
specific issues have to be processed.
Short Term The tax rate applied on short term capital gains.
Capital Gains
Tax Rate
Long Term The tax rate applied on long term capital gains.
Capital Gains
Tax Rate
Long Term The period a er which the long term capital tax is applied.
Period Unit
Unit
Frequency
You can use these a ributes for automa c conversion into Euro.
New Euro The new "Euro" instrument into which the instrument is converted.
Instrument
Euro The method used to convert into the new "Euro" instrument. (e.g. "bo om up
Conversion one cent", "top down minimum lot").
Rule
MiFID data
Complexity This field is used to specify the complexity of an instrument. This field could be
ini alised by a default value based on other a ributes of the instruments such
as nature, risk-nature, currency, market, etc.
A ribute Descrip on
Risk Level This field is used to specify the risk level of an instrument. This field is used in
conjunc on with the investment profile risk level in order to check if the
instrument does not excess the risk level tolerated by the investment profile.
Market This field is used to define the market direc ve category to which the
Direc ve instrument belongs (similar to the Markets in Financial Instruments Direc ve
Category (MiFID) in Europe). This field is used to define various investment restric ons,
which will prevent investment proposals that are not suitable or appropriate for
clients depending of their knowledge and experience of such instrument
category.
User-defined fields
You can always create user-defined fields in the instrument table if further informa on is
required (refer to the WealthSuite Front Office - Por olio Management - System Management
Guide).
You can define default values that set the a ribute values for all the fields. Addi onally, the input
data is validated by parameterised input controls.
Accrual Rules
A number of instruments that bear interest require an Accrual Rule to be defined in their defini on (e.g., Fixed Income instruments, Op ons, Rates, etc.). For
example, yields on some instruments are quoted on the basis of a 360-day year, others on a 365-day basis.
# of
Accrual Rules Func on DATE_DayBetween() days in
year
30E/360 Each month has 30 days, the 31st is treated as the 30th 360
30/360 (Feb) Each month has 30 days, the 31st is treated as the 30th (28.2, 29.2, 360
30, 31 can be the last day of the month)
30/360 (Def) Each month has 30 days. The 31st is assumed to be the 1st of the 360
following month.
30US/360 Each month has 30 days. If the period starts on the 31st change to 360
30th. If the period ends on the 31st and starts on 30th or 31st,
change end to 30th, otherwise leave at 31st.
365/365 February has always 28 days, other months are treated normally 365
Actual/Actual Exact number of days in a year (leap year control). Actual/Actual Actual
uses the same implementa on as the accrual rule ACTACT (see
ACTACT in the next table below).
# of
Accrual Rules Func on DATE_DayBetween() days in
year
Actual/Actual Exact number of days in year (leap year control, difference between Annual
(US) 2 days for the same month and year) Period
30E/365 Each month has 30 days, the 31st is treated as the 30th 365
30/360 Each month has 30 days, the 31st is treated as the 30th 360
30E/Actual Each month has 30 days, the 31st is treated as the 30th Actual
30US/365 Each month has 30 days. If the period starts on the 31st change to 365
30th. If the period ends on the 31st and starts on 30th or 31st,
change end to 30th, otherwise leave at 31st.
30US/Actual Each month has 30 days. If the period starts on the 31st change to Actual
30th. If the period ends on the 31st and starts on the 30th or 31st,
change the end to 30th, otherwise leave at 31st
30/360+1 Each month has 30 days, the 31st is treated as the 30th+1 360
(Italian BTP)
To calculate how many days there are in leap years (where the rule is xxx/Actual):
Since Release 4.10, addi onal accrual rules are available that more closely match market requirements, par cularly with regard to ISDA conven ons.* You may not
actually see much difference between the old and the new method, yet the newly implemented rules support the end-of-month conven on, which was not handled
in the past.
Related
Numerator
Accrual Rule Denominator Computa on Old
Computa on
Method**
Related
Numerator
Accrual Rule Denominator Computa on Old
Computa on
Method**
ACTACT The number of days The number of days per year is the
between the two dates actual numbers of days from the
is computed as the period start date to one year ahead.
actual number of
calendar days in the
period, including 29th
February if it occurs in
the period.
ACTLEAP The number of days The period is split into the periods
between the two dates that are in leap years and those that
is computed as the fall in non-leap years. In the former
actual number of periods, the number of days per year
calendar days in the is 366 while in the la er periods the
period, including 29th number of days is 365. The day count
February if it occurs in frac on is the sum of the day count
the period. The me frac ons of the sub-periods. More
period in ques on is precisely, this means the
defined to go from, and denominator is 366 when the period
including, the period covers the leap year’s extra day (29th
start date to, but February), otherwise the
excluding, the period denominator is 365.
end date.
Related
Numerator
Accrual Rule Denominator Computa on Old
Computa on
Method**
*One difference to take into account between two libraries of accrual rules is that the first one assumes a genera on of income period forward (Anchor) – as in with
a first coupon regular - whereas the second assumes a genera on of income backward from the end date (Anchor Back) – as in with a last coupon date regular. This
implies that if there is an irregular coupon period due to the coupon frequency and to the dates set, then it will be assumed at end with the first library and at
beginning with the second. Consequently, it will have an impact on other coupon periods as well as on accrual calculated. Of course, it also depends on the other
instrument parameters impac ng the accrued and coupon calcula ons.
**Note that the mapping provided in this case cannot be totally ascertained. Computa on differences may arise if you use an end-of-month conven on.
***The ACTAFB method is the one recommended by the ISDA for bond markets and floa ng swap legs.
Event Tables
All flows associated with the instrument are described in related event tables. These are:
Issue or Defines the flows that "create" or "repay" the principal of an instrument. For
Redemp on example, defini on of issue or redemp on schedules of Fixed Income instruments
Event (final redemp on, early redemp on, sinking funds), the amount of outstanding
principal for a debt instrument, or mortgage-backed securi es redemp on plans.
Income Defines when income is paid. This covers the defini on of odd periods, ex-dates,
Payment dual currency payments, and, for stocks, the paid dividend.
Event
Interest Defines the rate of interest or how it is computed (benchmark, mul plica ve
Rate factor, spread, capped and/or floored rates). Lets you specify cash account
Condi on interest rates (you can specify a different interest rate for nega ve balances).
Term Defines the condi ons in which a deriva ve contract can be exercised and
Contract therefore includes not only the exercise of op ons and Futures se lements
Event (including cheapest-to-deliver handling) but also swap ons and the exercise of
Exo c op ons.
The a ributes listed in these tables are described in the following sec ons (as descrip ons of each "nature"). However, the following remarks apply to all events:
Code: Business iden fier of the event. The code can be used to give a coupon or dividend number to the event. In the
Journal and Event Genera on func ons (refer to the WealthSuite Front Office - Por olio Management - Business Func ons
User Guide), the code and a hard-coded sequence are used to check that a posi on does not already exist with the same
characteris cs. If any are found, no flow is generated. Otherwise, the event code and number are copied respec vely into
the event code and event number fields of the posi on.
Validity Date: Date when the event is known. You can therefore view past data "as it was known". The system ignores all
events that have not passed their validity date. You can also use the Validity Date when the condi ons of a Conver ble Bond
change due to a split in the target stock.
Begin Date: Opposite to the Validity Date. It defines the first possible date on which the event can occur.
There is no redemp on opera on generated for the term events with the following condi ons:
The instrument of the term event has one of the following sub-natures: Accumulator, Decumulator, Mini Futures -
Turbo, Basket Op on, Structured Op on, Double Knock-in, Knock-in Knock-out Barriers, Pivot Op on, Digital Pay Out,
Par cipa ng Forward, Target Knock-out Forward, and Pivot TARKO
The term event has one of the following pay-off natures: Accumulator, Decumulator, Digital, Short, and Long.
There is no income opera on generated from the interest rate condi on record that has the interest rate rule set to Digital
or Range Accrual.
Simple Instruments
You can use events to define flows at any me. For some straigh orward, simple instruments, however, you should enter data directly at the instrument level. These
are described in detail in each sec on.
Examples:
The fixed interest rate can be stored in the instrument table but stepped coupons are stored in the interest rate condi on
sub-table.
First genera on op ons can be stored in the instrument table but not exo c op ons.
Final redemp on of Fixed Income instruments can be stored in the instrument table but not early redemp on possibili es.
The cash flows can be moved to before or a er the coupon date based on the Holiday calendar by configuring the Business Day conven on in the Instrument en ty.
For example. if the choice is the Next in Month in the business day conven on then Cash flow dates are moved on a following business day basis and moved to the
previous business day if the next business day falls on the next month. Cash flow amounts are adjusted accordingly.
Composite Instruments
You can define instruments as composite instruments, that is, an instrument that depends either on its pricing or risk measure on
the value or risk characteris cs of other "component" instruments. An example of this is a cum-warrant bond that is viewed as the
sum of an "ex-warrant" bond and a number of warrants. In this case, the cum-warrant bond is quoted but in a Risk View the
composite instruments are shown.
The composite instrument process is used frequently to define indexes, mul -legged swaps, underlying of basket op ons, exchange op ons, or spread op ons.
From a financial engineering point of view, this process can also be used for structured products where the instrument is
composed of an op on on an index and a zero-coupon bond.
Defining the composi on of an instrument is done by crea ng occurrences in the instrument composi on table. In par cular:
Rank is important in Risk Views where the sum of the values of the component instruments is equal to the value of the
composite instrument. The value of the component with the highest rank is computed by difference.
Generic Instruments
For instruments that are issued "on demand", differ only by a few characteris cs (issue date, interest rate, etc.) and are not quoted directly on the market. You can
define a "generic" instrument and enter the relevant data at the opera on level.
Typically, this applies to term deposits where the rate and expira on date are specified at opera on level but it also applies to foreign exchange contracts, Forex
swaps, forward rate agreements, and plain Vanilla swaps.
Note that if you want to disable the merger of posi ons in the same instrument because of these different characteris cs, it is o en necessary to enter generic
instruments using an Open Reference nature (refer to the WealthSuite Front Office - Por olio Management - Opera ons, Posi ons, and Fusions Reference Guide for
more details).
Instrument Templates
Instrument templates contain predefined a ributes that are designed to make crea on of OTC Orders, OTC Contracts and Deposit Orders via Channels easier and
faster.
Templates are created as instrument en es always in MASTER business en ty, with the Negotiable flag set to No and Underlying category set to None.
In addi on with related instrument nature's default values, the following a ributes should be defined for templates:
Usage-
Denomina on Nature Sub-nature
nature
Usage-
Denomina on Nature Sub-nature
nature
Sub-nature
Currency
Risk level
Market
The expected a ributes for the main instrument template are (common for all natures except when specified):
Code
Name
Denom
Reference Currency
Market
Tick Size
Contract Size
Delivery Method
Risk Level
Underlying instrument
For all other instrument a ributes, see sec ons Op ons, Exo c Op ons and Future Contracts.
The expected a ributes for the main instrument template are (common for all natures except when specified):
Code
Name
Denom
Reference Currency
Market
Tick Size
Contract Size
Delivery Method
Risk Level
For all other instrument a ributes, see sec ons Op ons, Exo c Op ons and Future Contracts.
In addi on with related instrument nature's default values, the following a ributes should be defined for templates:
Underlying
instrument
Risk Level
Decumulators Denom
Type
Subtype
Reference
Currency
Underlying
instrument
Risk Level
Subtype
Reference
Currency
Underlying
instrument
Risk Level
In addi on with related instrument nature's default values, the following a ributes should be defined for templates:
Fixed Fiduciary 6 - Fiduciary Deposit Template 5 - Money Market 117 - Fixed Fiduciary
In addi on to the related instrument nature's default values, the following a ributes should be defined for templates:
Fixed Deposit 7- Term Deposit Template 5 - Money Market 119 - Fixed Deposit
Instrument Prices
Market quota ons are stored in the instrument price table. The following a ributes define a price:
currency
date
You can enter several prices per day and per instrument. The above criteria are used to select the price with which to value the
instrument. (For more details on how this is done, refer to the WealthSuite Front Office - Por olio Management - Business
Func ons User Guide).
quote
There is a dis nc on between the "price" and the "quote". The quote is the figure provided by the market. The price is the
unitary value of the instrument. The way of ge ng from the quote to the price is the price calcula on rule.
Examples:
The quote of a Swiss Government bond is 102.25, and the price is 1.0225.
Typically, the price is the number by which you mul ply the quan ty to obtain the value of a posi on (excluding accrued interest). The quote is the market
representa on of this number and is what is inpu ed and seen by the user.
Note: For a Signature Por olio instrument with nature as fund share, sub-nature as an external product, and a Price Calcula on rule as por olio specific price, the
system will not search for prices in instr_price but instead in en ty por olio_instr_price only.
AA_DF_BOND()
AA_DF_FLOW()
AA_DF_FUT()
AA_CC_FUT()
AA_BS_OPT()
AA_CRR_OPT()
AA_CRR_CONVBOND()
For more informa on about the use of these keywords, refer to the WealthSuite Front Office - Por olio Management - Script Language Reference Guide.
I. Define a theore cal Valua on rule (refer to the WealthSuite Front Office - Por olio Management - Business Func ons User Guide) and
set it as the default theore cal Valua on rule by using the system parameter AA_DEF_VAL_RULE. In this case, all instruments with
Valua on rule set to Theore cal in their master data will be evaluated with their theore cal price in all business func ons.
II. Define format elements by using these script words, for example, in the valua on func on. In this case, you can also retrieve the
theore cal price (and other analy c indicators) for “quoted” instruments.
Some chronological data is used in hard-coded processing (e.g., the price calcula on factor is used to adjust price me series for corporate
ac ons). Other data is just for informa on purposes (e.g., price-earnings ra o).
All chronological data can be displayed using the INSTR_CHRONO() keyword. In some cases, you can also indicate that if no data is found for
this chronological data, it should be computed online. As this la er possibility can be me-consuming, it might be useful to compute
chronological data in batch mode (this is strongly recommended when the chronological data depends on me series, for example, Betas or
Vola lity).
For generic instruments (e.g., Money Market), it does not make sense to define data such as DURATION or MODIFIED DURATION in the
Chrono. The calcula on of these figures requires data, which is defined at the opera on level. Therefore, this data is not evaluated.
Instrument chronological data is computed using the Compute Instr Chrono func onality. You specify the instrument(s), nature of the chronological data, date,
and opera on to perform if the data already exists (recompute or not). The instrument chronological value is calculated by the func on Compute Instr Chrono
Several system parameters determine the period in which user chronological data is valid (instrument chronological data only). The following table shows the system
parameters and the instrument chronos they affect:
STOCK_DATA_VAL_PERIOD Alpha
Beta
Number of Shares
Price Earning Ra o
Vola lity
Volume
Correla on Coefficient
Determina on Coefficient R2
Covariance
Modified Dura on
Discount Yield
Dura on
Convexity
Current Yield
Yield-to-Maturity
Prepayment Rate
Scaling Factor
OPTION_DATA_VAL_PERIOD Delta
Gamma
Probability
Rho
Omega
Vega-Lambda
Theta
Determina on Coefficient R2
USER_CHRONO_DATA_VAL_PERIOD Unpaid %
Margin
Minimum Ra ng
The opera ons involving mul ple posi ons that increase the number of posi ons for a given date (e.g., por olio transfer opera on, adjustment opera on, locking
opera on, etc.) for an instrument connected to an instrument chrono are not supported. Some financial opera on risks calculate X mes the value of the mer
(where X is the number of posi ons on the date given).
Correspondence Table
The following table relates market instruments to the various instrument natures (the table is not exhaus ve):
Stepped bonds Fixed Mul ple interest rate condi ons express the various coupon
Income rates
Dual currency Fixed Income event is in a different currency form the instrument, a
bonds Income fixed exchange rate may be specified
Floa ng rate Fixed Interest rate condi on nature is "Floa ng" and references a
notes Income benchmark
Sinking funds Fixed Issue or redemp on event specifying sinking fund schedule
Income
Bonds quoted as Fixed Instrument "Price calcula on rule" set to "actuarial yield"
a yield Income
Op on bond Op on -
Bond
Cum warrant Op on -
bond Bond
Time deposit Money Usually a "generic" instrument where the rate and expira on
Market date must be entered in the opera on.
Treasury bill Discount Instrument "price calcula on rule" is either "discount rate" or
Instrument "discount yield".
Bill of exchange Discount Instrument "price calcula on rule" is either "discount rate" or
Instrument "discount yield"
Currency IR Swap -
swaps
Stocks
A stock is defined as a security that:
Characteris cs
An instrument of Stock nature is characterised by the descrip on of the security. It is associated to "income payment events" that define the dividend payments and
exchange events describing corporate ac ons such as conversions, exchanges, splits, or reverse splits.
Instrument Data
The following sec ons describe which data to enter and where:
Instrument Table
Instrument Table
The following is a list of a ributes that have a specific influence on or significance for this instrument nature:
Price Calcula on rule: indicates how to obtain the price of the stock from its market quote. In the case of stocks, the
default rule should indicate that the price is equal to the quote. However, the following rules could apply:
Par ally paid stocks: note that you enter the face value in the instrument table (Modify Instrument) and the
unpaid percentage in the instrument chronological data sub-table.
Stocks quoted as a percentage of their face value. This rule is applied to Spanish stocks. Note that the face value is specified in the
instrument table.
Valua on rule: indicates how the quote of the instrument is found. The possible values are:
Quote = 0: the instrument is never quoted and is for valua on purposes; the quote is assumed to be 0. In prac se, this case should not
occur for "classic" stocks.
Composite: the instrument is not quoted but the value of the instrument is found by summing the weighted value of its components.
The components may be entered by using the composi on func on where the component instrument, begin and end dates, as well as
quan ty (per unit) are inpu ed. The rank describes in which order the values of the component instruments are computed. (Not
relevant in this case).
Risk Nature: indicates possible risks that can incur by holding this security. For stocks, it is mostly an equity risk.
Payment Frequency: indicates the number of payment frequency units between two dividend payments (see below).
Payment Frequency unit: indicates the unitary period between two dividend periods. Select from:
Month
Quarter
Semester
Year
If a stock pays dividends every two months, the Payment Frequency must be set to "2", and the Payment Frequency Unit = Month. If these fields are not filled, the
dividends will not be projected in the cash flow projec on. If you enter a frequency, the last dividend with the "dividend projec on flag" set to Yes is projected at this
frequency (see sec on Income Payment Event Table).
Projec on: this a ribute is used to indicate that the dividend is to be projected in future cash flows at the frequency specified in the main
instrument table. If the projec on flag is set to No, then the dividend is not projected. If the projec on flag is set to Yes, be sure to also
define the Frequency in the screen of the main instrument table; otherwise, the dividend will not be projected.
Begin Date: the date on which the dividend goes ex. If you do not specify the First Coupon Date (see below), the Begin Date is also the
payment date of the dividend.
First Coupon Date: if specified, indicates when the value date of the payment of the dividend occurs. If not specified, the value date of the
dividend is the begin date. It is prac ced in some markets to define the beneficiaries of the dividend payments before the actual payment
date of the dividend. The holder of the stock before the ex-date is en tled to the dividend, even if the holder sells it before the payment
date. Conversely, if the holder acquired the stock a er the ex-dividend date but before the payment date, the holder is not en tled to the
current dividend.
Currency: the currency of the dividend. This defaults to the instrument currency.
The combina on of an instrument, dividend Projec on flag, Validity Date, and Begin Date is unique. This means that an extraordinary dividend and a normal
repe ve dividend can be paid on the same day but the two repe ve dividends cannot occur on the same day. You can also use the Validity Date to specify that the
presumed dividend was a defined amount (event 1) and that the known dividend (event 2) was entered later, making the presumed dividend invalid from the Validity
Date of event 2.
The data model lets you enter events that occur over a certain period (between event begin and end dates); however, in this release the events are deemed to occur
on the begin date.
A ribute Descrip on
Priority Indicates in which order same day events are processed. Several events can
occur on the same day for the same stock. For example, stock A could be
converted into 5 shares of stock B and 2 shares of stock C. In this case, you
enter two exchange events. The former (priority 1) would a ribute the B shares
without replacing stock A, the la er (priority 2) would replace stock A by stock
C.
Nature Nature of the Exchange event. The current permi ed values that apply to stocks
are:
Conversion / exchange
Split
Reverse split
Replacement Select this check box if you want the ini al stock to be withdrawn from the
Flag posi on. If selected (the flag is set to Yes), the posi on is withdrawn. If you do
not select the check box (the flag is set to No), the original posi on remains.
Reference Indicates for how many units of original stock the event occurs.
Quan ty
Example: For the exchange of 2 units of stock A for 3 units of stock B, the
reference quan ty is 2.
Quan ty of When the exchange involves another instrument (as opposed to just cash), this
New quan ty describes the number of new instruments to be acquired per reference
Instrument quan ty of original instrument. In the previous example, this is 3.
New When the exchange involves another instrument (as opposed to just cash),
Instrument indicates the name of this instrument; in the previous example, this is stock B.
A ribute Descrip on
Quote In the case of an exchange involving cash payments, contains the amount of
cash per reference quan ty of the original instrument. A posi ve quote
indicates that the amount is received by the holder of a long posi on, a
nega ve one indicates an amount to be paid.
Currency Indicates the currency of the quote or the currency of the cash se lement
amount described above. If this a ribute is not indicated, it is assumed to be
the currency of the stock.
Up
Down
Nearest
Odd Lot If rounding occurs, this indicates what is done with the quan ty le over. The
Compensa on choices are:
The combina on of an Instrument, Validity Date, Begin Date, Priority, and Nature must be unique.
A ribute Descrip on
First Dealing Shares will be available for secondary market trading on this date.
Date
A ribute Descrip on
Single Bid
BookBuild
When set to Single Bid, only one bid can be submi ed per order. The bid can be
placed only at the Subscrip on Price.
When set to BookBuild, mul ple bids can be placed however, the price must be
within the price band (Minimum Subscrip on Price, Maximum Subscrip on
Price)
IPO Lot Size The minimum number of shares that can be bid. Shares can only be bid in
mul ples of the IPO Lot Size.
Valua on
Stocks are valued according to their Valua on rule. Typically, stocks are quoted instruments.
STAT() computes the mean, variance, and standard devia on of any me series (e.g., instrument prices). The number and frequency of the
readings are passed as the parameters of the keyword.
REGR() computes the alpha, beta, covariance, correla on coefficient, and determina on coefficient (r2) of 2 mes series (e.g., instrument
prices). The number and frequency of the readings, as well as the index used, are passed as the parameters of the keyword.
For more detailed informa on, refer to the WealthSuite Front Office - Por olio Management Script Language Reference Guide.
Chronological Data
Apart from the above-men oned analy cal indicators that can be computed or imported and stored in the instrument chronological data, the following items can be
useful for stocks:
price-earnings ra o
price conversion factor: used in me series to adjust previous prices for corporate ac ons
Risk Posi on
Typically, the Risk Nature of this kind of instrument is "equity". Perhaps, for mining companies, it could be "commodity". In these cases, the risk posi on in a stock is
the same as the accoun ng posi on. However, if this instrument is the underlying instrument of a deriva ve contract, it could be a "hybrid" risk instrument. In this
case, the components are shown in the Risk View.
Journal
The journal typically shows any non-projected dividends that occur in the period as well as all projected dividends (see sec on Income Payment Event Table), even if
they refer to a period before the journal. You can also find corporate ac ons that result in a modifica on of the posi on. However, for the me being, these new
posi ons do not generate further cash flows. An example of this limita on is as follows: Suppose Stock A is converted to Stock B in a month's me. The journal shows
this conversion but not the expected cash flows resul ng from Stock B.
Special Cases
Preferred shares with a dividend defined as a percentage of the nominal value should be considered as perpetual bonds.
Fixed Income
Fixed income instruments include all capital market instruments that have a specified payment schedule. Most are tradi onal bonds and promise to pay specific
amounts at specific mes. Typically, this means pre-specified dates for the payment of interest and a specific date for the repayment of principal.
Characteris cs
An instrument of Fixed Income nature is characterised by the descrip on of the security, and associated events that describe the issuance, redemp on, payment of
income, interest rate condi ons and any exchange events that could occur in the life of the instrument.
Note that the guarantee table is used to indicate the name of the ins tu on which is the guarantor of the loan. This ins tu on has to be previously defined in the
third party table.
Instrument Data
The following sec ons describe which data to enter and where:
Sub-natures
Redemp on
Sub-natures
Sub-natures of Fixed Income provide more informa on about the instrument. They are used as a support for default values on accrual rules and coupon payment
schedules (e.g., US Treasury bonds are semi-annual actual/actual bonds). They are also used to apply market conven ons to analy cal computa ons.
Examples:
For US treasury and agency bonds, the yield is rounded to eight decimal places.
For corporate and municipal bonds, the yield is rounded to five decimal places.
For corporate bonds, whenever the price is equal to the redemp on price, the yield is equal to the coupon rate.
For Italian bonds (BTPs), withholding taxes are charged on the issue discount.
Par ally Paid Bonds: This rule applies to bonds where the full nominal value has not been issued. Note that the face
value is found in the instrument and the unpaid percentage is found in the instrument chronological data sub-table.
Bonds Quoted in Units: This rule applies to some French bonds where the quan ty is the number of nominal values in
the posi on. An example is a bond with a 250 EUR face value quoted at EUR. This is equivalent to a price of 1.06. Note
that the amount of ‘face value’ must be entered in the instrument defini on.
Actuarial Yield: The price is computed according to a rate and to the formula of the yield to maturity.
Add-on Rate: The price is computed according to the rate (introduced in the price table or taken from a reference rate).
Price = (1+coupon*life)/(1+quote*remaining life)
Quote/100 with AI: The price is equal to the quote expressed in percent including accrued interests.
Quote in Unit with AI: The price includes the accrued interests.
Price Calcula on Factor: The price is computed according to the quote and a factor (taken from the chrono table): Price
= quote * factor.
Quote in Unit: The price is the quote divided by the face value. This method is especially used for Fixed Income and
Conver ble Bonds.
Important: The Instrument’s Quote is always considered as dirty. In other words, accrued interests are included in the quote.
In case of dirty price, price = quote / face value. The accrued interest flag of the instrument must be set to N.
In case of clean price, price = quote/ face value – AI (accrued interests). The accrued interest flag of the instrument
must be set to Y.
Valua on rule: Indicates how the quote of the instrument is found. The possible values are:
Quote=0: The instrument is never quoted and for valua on purposes, the quote is assumed to be 0. In prac se,
this case should not occur for classic bonds.
Quote=1: The instrument is never quoted and for valua on purposes, the quote is assumed to be 1.
Composite: The instrument is not quoted but the value of the instrument is found by summing the weighted value
of its components (not relevant in this case).
Theore cal: This possibility is used once yield curve processing is used.
Reference Instrument: The instrument is quoted according to a reference instrument (e.g., bond, rate, etc.). It is used mainly for
instruments without regular quota on, when the price should be derived from the price of the reference instrument. In this case, no
prices are maintained in the price sub-table. The reference instrument is given in the instrument table, and a margin, if required, in
the instrument chronological data.
Data
If there is only one coupon rate and it is fixed throughout the life of the instrument, you can enter the rate in the instrument table; otherwise,
you must enter it in the interest rate condi on table.
Coupon Strike Level (%) – Used to define the coupon strike level in percentage terms for memory coupons. This
percentage will be mul plied with the ‘Exercise Quote’ (defined in the instrument) to calculate the coupon strike level
as an amount.
Coupon Strike Level – Used to define the coupon strike level as an amount for memory coupons. This amount will be
divided by the ‘Exercise Quote’ (defined in the instrument) to get the coupon strike level as a percentage.
Interest rate condi on sub-table: Other cases, such as stepped coupons.floa ng rate coupons, range accruals, digital and
memory coupons.
Interest Calcula on Rule: Defines if the interest rate condi on describes a fixed or a floa ng condi on or range accrual
or digital or memory condi on.
Range accruals - Interest is paid based on number of days (in a coupon period) the benchmark values are within
a par cular range.
Digital coupons – Interest is paid only if the benchmark on a par cular observa on date (in a coupon period) is
at least equal to or above the defined minimum threshold rate.
Memory Coupons - Interest for a period is paid (in a coupon period) only if the underlying instrument’s price is
at least equal to or above the defined coupon strike level. If a coupon is not paid for a period, the memory
mechanism will remember this and will pay the coupon in the next period if the above men oned condi on is
met, else, these coupon payments accrue ll the period where the condi on is met. If the condi on is not met
even in the last coupon period then these accrued coupon payments will not be paid at all.
First Benchmark Date: Used to define the observa on date for the first coupon period of the instrument. This will be
used in conjunc on with ‘Payment Frequency Unit’ and ‘Payment Frequency’ to calculate the observa on dates for the
subsequent coupon periods. This is used in digital coupons, memory coupons and in certain cases of floa ng coupons.
Benchmark: Rate instrument from which the interest rate is derived (e.g., 3 month Libor).
Minimum Interest Rate: Floor applicable to a floa ng rate and also used to define the lower boundary of range for
range accruals and digital coupons.
Maximum Interest Rate: Cap applicable to a floa ng rate and also used to define the upper boundary of range for range
accruals.
You can combine fixed and floa ng rate condi ons. For example, you could define a single floa ng rate condi on for the life of the instrument, then, as the coupons
are fixed, enter the fixed rate condi ons. Where a fixed rate is found, it takes precedence over the floa ng rate for that period.
For floa ng rate notes, the floa ng rate is defined at the instrument level, and further referenced in the interest rate condi on sub-table (benchmark field), with an
interest rate calcula on rule set to Floa ng. The frequency of the floa ng rate is defined in the floa ng rate instrument (Coupon Frequency and Frequency Unit take
the same values by default). This is also the case for its coupon conven on and accrual rule. Addi ve margin is entered as a whole number (since it is added to a rate
that has a Price Calcula on rule of quote / 100).
Note that reverse rates can be defined with margins of less than 1.
If there are mul plica ve and addi ve margins, Front Office – PM mul plies first, and then adds.
If there are several IRCs for the same instrument, priority is given to the IRC that has the most recent Begin date. If the IRC with the most recent Begin date has an
End date prior to another IRC, then this is the latest IRC that should be taken into account.
Example 1:
IRC_1
IRC_2
Example 2:
IRC_3
IRC_4
Therefore, IRC_4 only applies between 01/02/2008 and 29/02/2008. Before 01/02/2008 and a er 29/02/2008, IRC_3 applies.
Example 3:
FRANCE TELECOM 7¼% issued on 14/03/01, maturity 14/03/08, with an annual coupon payment.
If you set your instrument with this informa on and want to represent a step-up coupon from the second payment date, you must enter the interest condi on as
follows:
1. Interest Condi on
2. Interest Condi on
2. Interest Condi on
There is no computa on of the sensi vity measure because Front Office – PM does not know un l which date the first condi on applies and when the second
begins.
End dates
It is recommended that an End date is not specified in the IRC so that the interest rate will apply un l the Begin date of the next fixed condi on. If you must set an
End date, then it must be equal to the Begin date of the next fixed condi on. In the example above, the first conven on ends on 14 March 2003 and the next
conven on starts on 14 March 2003.
four dates
This data can either be maintained in the main instrument table or in the income payment event sub-table.
Instrument table level
In the main instrument table, the following a ributes are relevant for the coupon payment schedule:
A ribute Descrip on
Dated date Date on which accrued interest starts accruing. If not specified, the begin date of
the instrument is used.
First Indicates when the first coupon is paid. From this date onwards, the coupons are
Coupon deemed regular.
Date
If the first coupon date is not specified:
For accrual rules that existed prior to Release 4.10, the first coupon is
assumed to be a regular coupon.
For accrual rules added in and a er Release 4.10, the first coupon is an
irregular one and the last one is assumed as regular.
First Ex- Date on which the holders that are en tled to the first coupon are determined.
Date Between this date and the first coupon date, accrued interest is nega ve. The
number of days between the first ex date and the first coupon date is repeated
throughout the life of the instrument as the ex-period. If this period changes over
me, it is necessary to create discrete income payment events.
Last Date of the last coupon. If not specified, defaults to the end date of the
Coupon instrument.
Date
Payment Indicates the number of "payment frequency units" between two coupon
Frequency payments (see below).
A ribute Descrip on
Payment Indicates the unitary period between two coupon periods. The possible values are:
Frequency
Unit Month
Quarter
Semester
Year
If coupons are paid every six months, you can enter the following: Payment
Frequency = 1, Payment Frequency Unit = Semester.
End of End of month conven on is not currently applied to Front Office – PM processes.
Month
Conven on When end of month conven on support is added, the End of Month Conven on
field can be used to indicate whether coupons that occur at the end of months are
repeated on the same date or at the end of month. For example, if we have a semi-
annual coupon that pays on the 28th of February 1995, the payment schedule is:
Finally, for instruments that pay the coupon in a different currency from that of the principal:
A ribute Descrip on
Fixed Exchange Rate (exchange event sub- Rate of exchange that is applied to the coupon.
table)
A ribute Descrip on
Projec on The Projec on field determines if this coupon is projected in future cash flows at
the frequency specified in the instrument table. If the flag is set to No, the dividend
is not projected. If the flag is set to Yes, but the frequency in the Instrument is not
defined, the dividend will not be projected either.
Validity Indicates the date from which this dividend is valid. If a cash flow projec on is
Date required from a date preceding this validity date, the dividend will not appear.
Begin This is the date on which the dividend goes ex. If no “first coupon date” is specified,
Date this is also the payment date of the dividend.
First If specified, indicates when the value date of the payment of the dividend occurs. If
Coupon not specified, the value date of the dividend is the begin date. It is prac ced in some
Date markets, to define the beneficiaries of the dividend payments before the actual
payment date of the dividend. The holder of the Fixed Income before the ex-date is
en tled to the dividend, even if the holder sells it before the payment date.
Reciprocally, if the holder acquired the Fixed Income a er the ex-dividend date but
before the payment date, the holder will not be en tled to the current dividend.
First Ex- Date on which the holders that are en tled to the first coupon are determined.
Date Between this date and the first coupon date, accrued interest is nega ve. The
number of days between the first ex date and the first coupon date is repeated
throughout the life of the instrument as the ex-period. If this period changes over
me, it is necessary to create discrete income payment events.
A ribute Descrip on
Currency Indicates the currency of the dividend. It is suggested that this defaults to the
instrument currency.
End Indicates un l which date the event is valid. If not specified, then it will occur un l
Validity the maturity of the bond.
Date
Overview
On top of the previous coupon informa on, the following Instrument data has a direct impact on accrued interest:
Accrued Interest Flag: Select if you want accrued interest to be computed for this instrument.
Interest Rate Conven on: Specifies whether to use the simple MM method or the Compound simple method to compute
the accrued interests.
This last parameter defines which formula is going to be used. The formula for calcula ng accrued interest is as follows:
Where:
N = Nominal = Quan ty
di = issue date for a money market, last coupon date for a Fixed Income, last payment date for a swap
Note that this formula gives accurate accrued interest only for a daily compound period. This method can only be applied by the system with the addi onal accrual
rules explained in sec on Accrual Rules.
However, the next formula handles first compound interest individually based on the period specified at Compound Frequency Unit and capitalises them all together
sequen ally. This method has the advantage that it considers the exact number of days for the period. This method can only be applied by the system with the
accrual rules explained in sec on Accrual Rules.
Where:
Simple method:
In some markets, accrued interest must be rounded. In par cular, for French government bonds, unitary accrued interest is rounded to the third decimal place; for
Australian government bonds, the accrued interest amount is rounded to the nearest $10. The following are used to define the rounding of accrued interest:
Interest rounding unit: Determines the rounding precision level y (e.g., 0.01, 10, etc.).
Accrued interest computa on for range accruals, digital and memory interest calcula on rules
Range Accruals
The coupon period for which the accrued interest is calculated is retrieved and the date on which the valua on is done (‘Ini al date’ a ribute of the ‘Domain -
Valua on’) is within a par cular coupon period.
Accrued interest on the valua on date for the concerned coupon period = (Fixed interest rate/n) * (No. of days inside/No. of days in the period) * Q
Where:
Fixed interest rate = Fixed interest rate per annum defined in the ‘Interest Rate Condi on’ sub-table.
No. of days in the period = the total number of days in the coupon period.
Q = quan ty of posi on
Where:
if value is available
and not in or if no
value is available. A worst case scenario is applied by default for unknown values and for future
occurrences. The minimum and maximum values are defined in the ‘Minimum Interest Rate’ and ‘Maximum Interest Rate’ a ributes of the ‘Interest Rate Condi on’
sub-table.
if
SD = the start date of the coupon period for which accrued interest is being calculated.
T = the date on which the valua on is being calculated. If ‘T’ and ‘SD’ are same, “no. of days inside” should be calculated only once for that date and not twice.
Example
You buy 100,000 bonds on 31/12/2017 with a 10% coupon rate, a Begin date '31/12/2017', payment frequency unit 'Year', Benchmark 'Euribor 12M', Minimum
interest rate '2%', Maximum interest rate '3%' and an Accrual Rule 'Actual/360'. A valua on is performed on 12/02/2019. The number of days the benchmark was
inside the range from 01/01/2019 to 12/02/2019 is 28 days (Seen from the price table of the Benchmark).
Digital Coupons
IF ( is available and >= Minimum Value) and ‘Ini al Date’ > ‘First Benchmark Date’
Else ‘0’.
Where:
= the value of the benchmark on the observa on date of the concerned coupon period. For the concerned coupon period, the observa on date can be calculated
using ‘First benchmark date’ (from 'Interest Rate Condi on' sub-table), payment frequency unit and payment frequency value from ‘Instrument’ table.
Minimum value = ‘Minimum Interest Rate’ defined in the ‘Interest Rate Condi on’ sub-table.
No. of days accrued = Number of days between the ‘Start Date’ of the concerned coupon period and valua on date.
Total no. of days = Total number of days in the concerned coupon period.
Example
You buy 100,000 bonds on 31/12/2017 with a 10% coupon rate, a Begin date '31/12/2017', payment frequency unit 'Year', Benchmark 'Euribor 12M', Minimum
interest rate '2%', First observa on date '28/12/2018' and an Accrual Rule '30/360'. A valua on is performed on 28/12/2018. The benchmark rate on the observa on
date is 4% (Seen from the price table of the Benchmark).
Memory Coupons
Retrieve all the coupon period(s) which occur before the above retrieved coupon period. Then, for each of these coupon periods, calculate Coupont (star ng from
the first coupon period of the concerned instrument and proceeding in that sequence)
Where:
(t-1) = the coupon period number. If ‘Coupont’ is being calculated for second coupon period, (t-1) is ‘1’. If ‘Coupont’ is being calculated for first coupon period, (t-1) is
‘0’ etc.
Interest rate =
Interest Rate = Fixed Interest Rate (‘Interest Rate’ a ribute of the ‘Interest Rate Condi on’ sub-table)
Else ‘0’.
Where:
Share Pricet = Share price of the underlying instrument (for 'Single' category) on the observa on date of a par cular coupon period; the observa on date can be
calculated using ‘First benchmark date’ (from 'Interest Rate Condi on' sub-table), payment frequency unit and payment frequencies value from ‘Instrument’ table.
For average and worst-of category, Instrument composi on table is used and the price of the average basket/ worst-of instrument as on the observa on date is
calculated and used for comparison purposes.
A er calcula ng the values for all the concerned coupon periods, the last coupon period whose ‘Coupont’ value was greater than zero has to be noted. Consider this
coupon period as ‘Dn’.
Accrued interest =
Where:
Interest rate =
Else ‘0’
Where:
Share Pricei = Share price of the underlying instrument (for 'Single' category) on the observa on date of a par cular coupon period; the observa on date can be
calculated using ‘First benchmark date’ (from 'Interest Rate Condi on' sub-table), payment frequency unit and payment frequency value from ‘Instrument’ table. For
average and worst-of category, Instrument composi on table is used and the price of the average basket/ worst-of instrument as on the observa on date is
calculated and used for comparison purposes.
Where:
Interest rate =
Else ‘0’
No. of days accrued = Number of days between the ‘Start Date’ of the concerned coupon period and valua on date.
Example
You buy 100,000 bonds on 31/12/2016 with a 10% coupon rate, a Begin date '31/12/2016', payment frequency unit 'Year', Underlying category 'Single', Underlying
'IBM', Coupon strike level '70%', Exercise quote '10', First observa on date '28/12/2017' and an Accrual Rule '30/360'. A valua on is performed on 28/12/2018. The
price of IBM as of the observa on dates are '6' (as on 28/12/2017) and '8' (as on 28/12/2018).
Accrued interest ll
@ 0 (as it is prior to the observa on date)
27/12/2017
Accrued interest on @ 0 (as price of the underlying is below the coupon strike level on
28/12/2017 the observa on date)
To iden fy the Canadian bond the sub-nature of the instrument should be defined either of
If the Valua on Date is included into the last coupon period [Last Coupon Begin Date – Last Coupon End Date], the Accrued Interest must be computed on a ACT/365
basis as:
For any Valua on Date less than the Last Coupon Begin Date, the Accrued Interest computa on remains unchanged.
Redemp on
Front Office – PM handles various redemp on schedules.
Final Redemp on
For a bullet point redemp on, the informa on can be stored in the main instrument table. In more complicated cases, the issue/redemp on event table must be
used to store the relevant informa on.
Instrument table level
In the main instrument table, the following a ributes are relevant for the redemp on:
A ribute Descrip on
A ribute Descrip on
End Date The date at which the instrument ceases to exist. In theory, there must be no
posi ons in this instrument a er the end date. In prac ce, however, due to
possible administra ve or financial delays, this may not always be the case. The
End Date field is not mandatory but if completed it must be greater than or equal
to the Begin Date.
A ribute Descrip on
Nature Final redemp on indicates the amount paid out at the bond’s maturity.
Validity Indicates the date from which this final redemp on is valid.
Date
Begin Date at which the final redemp on occurs. This may be equal to the end date of the
Date Fixed Income.
Effec ve The date on which the redemp on is confirmed by the issuer (this forces the Journal
Expira on and analy cs to use the final redemp on rather than earlier ones).
Date
End Date Last date at which the event occurs. If the event has no end date, this is deemed to
be the begin date for non repe ve events and the date on which a par al
redemp on has withdrawn all outstanding reimbursements for repe ve events.
Quote
Effec ve date: Date on which the redemp on is confirmed by the issuer (this forces the journal and analy cs to use this
redemp on rather than another)
Sinking Fund
You can either enter sinking fund provisions discretely or when the frequency and redemp on quote and percentage redeemed are constant in one redemp on
event. You must enter the following informa on in the Issue or Redemp on event:
Nature: Amor sa on
Quote
Example 1:
Take an instrument where 40% is redeemed on 15/05/98 and 60% on 15/05/2002. This requires the crea on of two Redemp on events:
Event 1
Nature: Amor sa on
Quote: 100
Event 2
Nature: Amor sa on
Quote: 100
Example 2:
Take an instrument where 10% is redeemed semi-annually from the 15/05/98 to the 15/05/2000 and 50% on 15/05/2001. This requires the crea on of two
Redemp on events:
Event 1
Nature: Amor sa on
Quote: 100
Frequency: 1
Event 2
Nature: Amor sa on
Quote: 100
Notes:
Redemp on of the remaining part must be an "amor sa on" redemp on (not a "final redemp on").
Capital Reduc on
The capital reduc on set up is very similar to that of a sinking fund redemp on. The only difference is the nature. The data here is for informa on purposes only.
Once a capital reduc on has occurred, it is necessary to set the quota on rule of the bond to "unpaid percentage" and enter the percentage in the instrument
chronological data.
Note that you cannot combine amor sa on, capital reduc on, and "Call/Put" redemp on for the same bond.
A ribute Descrip on
Begin Date Date from which the event occurs. In the current version, this is the date at
which the event occurs.
Priority Indicates the order in which same day events are to be processed. Several
events can occur on the same day for the same instrument.
Reference Indicates for how many units of the original instrument the event occurs.
Quan ty
Example: 1 unit of bond A gives 1 unit of bond B.
Quan ty of When the exchange involves another instrument (as opposed to just cash), this
New quan ty describes the number of new instruments to be acquired per reference
Instrument quan ty of original instrument.
New When the exchange involves another instrument (as opposed to just cash),
Instrument indicates the name of this instrument.
Quote If the exchange involves cash payments, contains the amount of cash per
reference quan ty of the original instrument. A posi ve quote indicates that
the amount is received by the holder of a long posi on, a nega ve one indicates
an amount to be paid.
Currency Indicates the currency of the quote or the currency of the cash se lement
amount described above. If this a ribute is not indicated, it is assumed to be
the currency of the bond.
New Quan ty
New Round
Lot
New The unit on which rounding is done (e.g. 0.01, 0.5, etc.).
Instrument
Min Denom.
A ribute Descrip on
Odd Lot If rounding occurs, indicates what is done with the quan ty le over. Select
Compensa on from:
A ribute Descrip on
First Dealing Bonds will be available for secondary market trading on this date.
Date
Single Bid
BookBuild
When set to Single Bid, only one bid can be submi ed per order. The bid can be
placed only at the Subscrip on Price.
When set to BookBuild, mul ple bids can be placed however, the price must be
within the price band (Minimum Subscrip on Price, Maximum Subscrip on
Price)
IPO Lot Size The minimum number of bonds that can be bid. Bonds can only be bid in
mul ples of the IPO Lot Size.
A ribute Descrip on
Opera ons
Fixed income instruments are bought and sold using the "buy" and “sell” opera ons. The buy opera on is also used when
subscribing a newly issues bond.
Redemp on: Fixed income instruments are redeemed with a sell opera on.
Coupon payments: Coupon payments are made using an "income" opera on.
For more details, refer to the WealthSuite Front Office - Por olio Management - Opera ons, Posi ons, and Fusions Reference Guide.
Valua on
Risk Posi on
Journal
Valua on
Fixed income bonds are valued according to their valua on rule. Typically, bonds are quoted instruments.
Notes:
Accrued interest of a Fixed Income posi on that has not yet reached its value date is computed up to the value date. If a
Fixed Income instrument is purchased in two opera ons, the opera ons will not merge un l the la er has reached its value
date.
When the applica on parameter FULL_COUPON_FLAG is set to 1, accrued interest on the coupon payment date is equal
to the full coupon value. This can be useful if coupon payment opera ons are imported the night a er the coupon payment.
That way, the value of the posi on remains smooth.
When working with a Valua on rule set as Theore cal, price is calculated from the yield curve entered at the instrument level. It is either a compound formula or a
spot formula, depending on the type of yield curve you defined. Once corresponding rates (or discount factors) have been found, cash flows are discounted (or
mul plied by the corresponding discount factors) for the required date.
Risk Posi on
Typically, the Risk Nature of this kind of instrument is interest. The risk posi on in a Fixed Income instrument is the same as the accoun ng posi on.
Journal
The journal typically shows all expected coupons, redemp ons, and exchanges that occur in the period.
A par cular case is where the redemp on schedule includes Call or Put redemp ons. In this case, only the most probable redemp on is shown in the journal. This is
found by comparing the yield to each redemp on and selec ng the worst call or the best put. For example, the following redemp on possibili es are found:
The journal func on has been extended to show the interest cash flows (coupons) for the interest calcula on rules defined in the interest rate condi on sub-table.
For all the rules, the coupon periods of the instruments that have a defined interest calcula on rule and whose coupon payment dates fall within the ‘Reference
Date’ (inclusive) and ‘Final Date’ (inclusive) of the journal domain are retrieved.
The expected coupon calcula ons for range accruals, digital and memory interest calcula on rules are:-
Range Accrual
When the current (system) date is within a coupon period, the coupons that accrue post the previous coupon payment ll the current date are shown as cash flows
based on the number of the days the benchmark was inside the defined range ( ll the system date).
Expected Coupons = (Fixed interest rate/n) * (No. of days inside/No. of days in the period) * Q
Where:
Fixed interest rate = Fixed interest rate per annum defined in the ‘Interest Rate Condi on’ sub-table.
No. of days in the period = the total number of days in the coupon period.
Q = quan ty of posi on
No. of days inside = the number of days the benchmark values were inside the defined boundaries in the concerned coupon period.
Where:
if value is available and not in or if no value is available. A worst case scenario is applied by default for unknown values and for future occurrences. The
minimum and maximum values are defined in the ‘Minimum Interest Rate’ and ‘Maximum Interest Rate’ a ribute of the ‘Interest Rate Condi on’ sub-
table.
SD = the start date of the coupon period for which accrued interest is being calculated.
T = the date on which the valua on is being calculated. If ‘T’ and ‘SD’ are same, then “no. of days inside” should be calculated only once for that date and
not twice.
Note: For coupon period(s) which occur a er the ‘Current Date’ (systems current date), the cashflows projected will be zero.
Digital
Where:
= the value of the benchmark on the observa on date of the concerned coupon period. For the concerned coupon period, the observa on date can be
calculated using ‘First benchmark date’ (from 'Interest Rate Condi on' sub-table), payment frequency unit and payment frequencies value from
‘Instrument’ table.
Minimum value = ‘Minimum Interest Rate’ defined in the ‘Interest Rate Condi on’ sub-table.
Fixed interest rate = Fixed interest rate per annum defined in the ‘Interest Rate Condi on’ sub-table.
Q = quan ty of posi on
Memory Coupons
The current and prior coupon period(s) are fetched for the retrieved coupon payment dates and for these periods; the coupon amount (Coupont) star ng with the
first coupon period of the instrument is calculated.
Where:
(t-1) = the coupon period number. If ‘Coupont’ is being calculated for second coupon period, then, (t-1) is ‘1’. If ‘Coupont’ is being calculated for first
coupon period, then, (t-1) is ‘0’ etc.
Interest rate =
Else ‘0’
Where:
Share Price = Share price of the underlying instrument (for 'Single' category) on the observa on date of a par cular coupon period. The observa on date can be
calculated using ‘First benchmark date’ (from 'Interest Rate Condi on' sub-table), payment frequency unit and payment frequencies value from the ‘Instrument’
table.
For the average and worst-of categories, the instrument composi on table is used and the price of the average basket/ worst-of instrument as on the observa on
date is calculated and used for comparison purposes.
Indicator Descrip on
YTM() Computes yield to the most probable redemp on, final maturity, next call, best
call, next put, best put, etc.
These analy cs handle sinking funds and income and capital gains taxes.
Alterna vely, the keyword AA_DF_BOND calculates Dollar dura on, Dollar convexity, and Value of a Basis Point by using discount factors from a yield curve.
The Dollar dura on is the weighted average of the ming of expected cash flows, weighted by the present value of each flow. The Dollar convexity is the rela ve
curvature of the price- yield curve, represen ng a second order measure of price-yield sensi vity, expressed in cash amount. Combined with dura on, convexity can
be used to approximate the percentage change in price given a percentage change in yield. Dollar convexity expresses in amount the percentage change in price.
The value of a basis point is the change in price (market value) of the instrument given a one basis point change in its yield. It is the first deriva ve of price per unit
face value with respect to yield. The formula for the value of a basis point is -dP/dy.
For more informa on, refer to the WealthSuite Front Office - Por olio Management - Script Language Reference Guide.
Examples
Example 1: Step-up / callable bond
Example 3: Accrued interest flag and Price Calcula on rule Quote in Unit
In this case, you create five interest rate condi ons events to define the five different coupon rates. The Validity Date is the date from which the Journal report takes
account of the event. This date is valid un l the End Validity Date.
The first event, the 8% coupon is valid from May 1, 1998 to May 1, 1999: the Begin Date is May 1, 1998 and the Validity Date is May 1, 1998.
The second event, the 8.5% coupon is valid the second year: the Begin Date is May 1, 1999 and the Validity Date is also May 1, 1998 (so that when the Journal is
requested on May 20, 1998, it shows both events).
For the third event, the 9% coupon, the Begin Date is May 1, 2000 and the Validity Date is May 1, 1998.
Note that you do not need to enter an End Date as Front Office – PM treats an event as valid un l it finds another event with a subsequent date.
[Link] Instruments Reference [Link]#_Toc33613432%3FTocPath%3DHom… 47/228
5/31/2021 Financial Instruments Reference Guide
Finally, the early redemp on possibili es are defined in the issue/redemp on sub-table. The first call redemp on is valid on the third coupon payment anniversary,
May 1, 2001. The Begin Date is May 1, 2001, the Validity Date is May 1, 1998 and the Effec ve expira on date is May 1, 2001: the journal shows this possibility if its
yield is worse than the final redemp on yield.
The yield to maturity is 8.91%, the yield to the second call in 2002 is 8.70% and the yield to the first call in 2001 is 8.47%. The journal selects the first call redemp on
in 2001 as the maturity in the analysis.
The scenario has a me gap of 7-10 days, for example, between coupon ex-day en tlement and actual payment day. With these bonds, accrual is embedded in the
bonds' price.
Income Event
Iss/Rdm Event
Instrument main table
To handle “dirty” quotes, it is recommended that you use “Quote/100 with AI” as the Price Calcula on rule. The Accrued Interest Flag must be set to Yes to ensure
that the system to compute accrued interests on Fixed Income prices will obtain correct figures when the posi ons of the bonds are created in the por olio.
Income Event
The coupon schedule can either be kept in the main instrument table or in the income event sub-table.
Instrument prices
In the following examples (using the previous two se ngs), you can see that the Quotes include accrued interests but are removed from the prices. Note also in
these images that the bond’s Quote dropped the date following Ex-Coupon Day (i.e., 18/02/2007).
In the following image, on Payment Date, accrued interests are null as Front Office – PM starts compu ng for the following period.
Redemp on event
Finally, we recommend se ng final redemp on in the issue/redemp on event table to handle various redemp on schedules as it is described in sec on
Redemp on.
In the following image, with Valua on Date before Ex-Coupon Date (18/02/2007), the Income is represented as an Accrued Interest (with effec ve interest payment
date as of 28/02/2007).
In the next image, with Valua on Date (23/02/2007) between Ex-Coupon Date and Payment Date (28/02/2007), you see that the Coupon has been detached, and is
represented as an Income Opera on (70.00 CHF). Its Value Date is equal to effec ve payment date (28/02/2007) and a nega ve Accrued Interest represents the
present value (Valua on Date) of the Income paid at a future date (Payment Date).
Example 3: Accrued interest flag and Price Calcula on rule Quote in Unit
If a Fixed Income or a Conver ble Bond has a Price Calcula on rule set to Quote In Unit, the effect on the business func ons is as follows.
Opera ons
The opera on gross amount: Quan ty * price * face value
The opera on net amount: (Quan ty * price * face value) + accrued interest
The opera on accrued interests: Quan ty * face value * interest rate * #days / basis
The basis depends on the accrual rule (e.g., 365 if the accrual rule is “Actual/365”)
Ref Market Value = quan ty * instrument price * face value * exchange rate (between the Domain currency and the
instrument price currency) + accrued interest
Event Genera on business func on computes Incomes using the following formula:
Strategy Reconcilia on must also take the face value into account. This means that the quan ty is computed using the
following formula:
(actual weight – objec ve weight) * por olio reference market value /(face value* price in reference currency)
The following table shows the different behaviours in opera on with the accrued interest flag is used:
Gross Amount Clean price * face value * quan ty Dirty price * face value *
quan ty
The following table shows the different behaviours in valua on when the accrued interest flag is used:
Ref (Instrument price * face value * quan ty + Instrument price * face value *
Market accrued interest) * exchange rate quan ty * exchange rate
Value
held in unit
quoted in percentage
The yield curve is composed of the following applicable rates: 1-year rate at 4.25%, 2-year at 5.5%, and 3-year at 6%.
Discoun ng is performed according to the Interest Rate Conven on of the yield curve, in this case Compound, i.e. component rates are treated as compound rates
(and if they are defined as compound rates, they are converted to compounded rates).
The present value of the third flow is: 105% / (1+6%)^3 = 88.146%
The sum of these elements represents the net present value of the future flows expected for the bond. The bond's theore cal price is thus 97.43%.
Op ons
The Op on nature defines instruments that convey the right, but not the obliga on, to either buy or sell a specific quan ty of commodity or financial instrument
(e.g., equity, stock index, currency, bond, futures contract, etc.) at a fixed price at either a fixed future date or at any me during a fixed future period. It, therefore,
covers op ons, warrants, and rights.
Instrument Data
The following sec ons describe which data to enter and where:
A ribute Descrip on
Underlying The quan ty of the underlying instrument. The difference between this and the
Quan ty contract size is best illustrated with an example:
One warrant to buy 100 IBM stocks also en tles the holder to purchase
100 stocks. However, if the price of the warrant is USD 20, the value of
a posi on of one warrant is USD 20.
In the former case, the contract size is used to show a quan ty of 1 where the
quan ty should be 100. However, each individual op on gives the right to 1
underlying instrument. In the la er case, the investor really holds only one
warrant; however, the quan ty of underlying ("underlying quan ty") is 100.
Bonds
Futures
Commodi es
Currency (the currency which will be bought (call op on) or sold (put
op on) at the execu on)
A ribute Descrip on
Default The model used to compute analy cs or theore cal prices, e.g. "Black and
Model Scholes" or "Binomial". If not specified, the model defined in the applica on
parameters is used.
Default Flag For currency op ons only: Per currency pair, one op on can be flagged as the
“default op on”, and the vola lity of the underlying will be stored in the chrono
sub-table for these op on. All other currency op ons with the same currency pair
will take the vola lity from the default op on.
Yield Curve When theore cal valua on is used, the risk free interest rate is derived from this
yield curve.
Opera ons
The opening of a long op on posi on is done by a “Buy” opera on.
Sell the op on and purchase the underlying at the strike price (this implies that a realised loss is booked on the op on).
Purchase the underlying at the strike price and remove the op on with an adjustment opera on (no realised loss is booked
but the cost price of the underlying now includes the op on premium).
In markets where op ons are mark-to-market, you can perform a margin call opera on. In this case, the op on posi on must be acquired using a Future Open,
Future FIFO, Future WMP, or Future Contract as the Reference nature (refer to the WealthSuite Front Office - Por olio Management - Opera ons, Posi ons, and
Fusions Reference Guide for more informa on).
Valua on
Journal
Valua on
Op ons are valued according to their Valua on rule. Typically, op ons are quoted instruments.
If the Advanced Analy cs Module (AdAM) licence is available, the script keywords AA_BS_OPT() and AA_CRR_OPT() can be used to calculate the theore cal price of
the op on by means of the Black-Scholes and the Cox, Ross and Rubinstein models. In the theore cal valua on, op ons on commodi es will be treated like op ons
on stocks.
Op on on a security or on an index
In the Risk View, the op on posi on is split into a posi on in the underlying instrument, and an offse ng posi on, which is iden fied by the op on’s instrument
code and has either the nature Cash Account or the nature Discount Instrument, depending on the system parameter RISK_OPT_PROCESS_RULE.
The aim of the Risk View is to split the op on posi on into posi ons with a similar risk exposure. For a long call op on posi on, the posi on in the underlying is also
long because the call op on gives its holder the right to buy the underlying, and its price moves in the same direc on as the price of the underlying. Consequently,
for a long put op on posi on, the posi on in the underlying is short. For short op on posi ons, these rules are inversed.
The system parameter RISK_OPT_VAL_RULE determines the way of spli ng the op on into a cash posi on and a posi on in the underlying instrument.
When working with the op on risk flag set to “Full Exposure” in the Domain, the quan ty of the underlying posi on is equal to the number of op ons * contract
size. This posi on is valuated by the current instrument price. The value of the offse ng posi on is determined such that the sum of the market values of the
underlying and the offse ng posi on is equal to the market value of the op on posi on in the accoun ng view.
When working with the op on risk flag set to “Delta Exposure” in the Domain, the quan ty of the underlying posi on is determined as delta * number of op ons *
contract size, and all other values are adapted accordingly.
For RISK_OPT_VAL_RULE = 2, it is assumed that the op on posi on has been executed. The posi on in the underlying with quan ty = number of op ons *
contract size is valuated with the strike price of the op on. A cash posi on is generated as cash amount, which would have been paid or received at the execu on of
the op on (i.e., for buying or selling the underlying instrument at the strike price).
Op on on currency
When working with RISK_OPT_VAL_RULE = 1 and op on risk flag set to “Full Exposure” in the Domain, the op on contract is replaced by a posi on in the
underlying currency (long for long call, short for long put, etc.), whose quan ty is determined as number of op ons * contract size * underlying quan ty, and which
is valuated with quote = 1. An offse ng posi on in the op on's reference currency is created, with quan ty = number of op ons * contract size * underlying
quan ty * strike price, and valuated such that the overall market values remains unchanged between the accoun ng view and the Risk View. With op on risk flag at
“Delta Exposure”, all values for the underlying leg are mul plied by the op on’s delta, and the values for the offse ng leg are adapted accordingly.
For RISK_OPT_VAL_RULE = 2 the op on is assumed to be executed. The Risk View displays a posi on in the underlying currency with quan ty = number of
op ons * contract size * underlying quan ty and quote = strike price of the op on, and a posi on in the reference currency of the op on with same quan ty but
valuated at a price of 1.
Op on on future
In the Risk View, the decomposi on comes down to the underlying of the future, such that there is no longer a deriva ve posi on shown in the Risk View.
The posi on in the underlying is determined from the number of the op ons, the contract size of the op on, and the contract size of the future contract.
Journal
At the expira on date, the system proposes to close the op on's posi ons. If the Physical Delivery Flag is set to Yes, it also proposes the exercise of the op on if the
condi ons are favourable (in the money op on).
CALL PUT
Where S = the current price of the underlying and X = the exercise price of the op on.
The option exercise rule applica on parameter indicates whether the op on is sold or adjusted.
The models supported are Black and Sholes (Black for Eurodollar futures and Garman-Kohlhagen for currency op ons) and, Binomial and Addesi-Whaley (a closed
form es ma on of American op ons). As a reminder, to compute the analy cs properly you must provide the following data:
Data Descrip on
Risk Free The price of an instrument in the specific currency and with the "default flag" set to
Rate Yes (for more details, see sec on Rate).
Annual This can either be found in the instrument chronological data of the underlying
Price instrument (which can be computed using the ESTVOL() or STAT() keywords). If no
Vola lity stored data is found, the vola lity is computed using a price series. The number
and frequency of readings, as well as the type of instrument prices to be used
("close", "ask") are defined as applica on parameters. Note that intensive on-line
computa on of vola lity is not recommended for performance reasons.
Addi onally, for correct computa on, the holding cost of the underlying must be calculated in some cases. It depends on the nature of the underlying instrument.
Data Descrip on
Bond Three methods are available (see the "Bond holding cost rule" applica on
op ons parameter BOND_HOLD_COST_RULE):
the holding cost is the risk free rate - the yield to maturity
the holding cost is the risk free rate and the underlying price is the price
minus the net present value of the coupon plus accrued interest
the holding cost is 0 and the underlying price is the forward price of the
bond at expira on
Commodity The holding cost is the risk free rate minus the annual storage cost. You must
op ons enter the holding cost in the holding cost a ribute of the underlying instrument
(nature Commodity).
Currency The holding cost is the risk free rate minus the risk free rate of the foreign
op ons currency.
If the Advanced Analy cs Module (AdAM) licence is available, the script keywords AA_BS_OPT() and AA_CRR_OPT() can be used to calculate the sensi vi es
(“Greeks”) such as delta, gamma, vega, and theta.
For more details, refer to the WealthSuite Front Office - Por olio Management - Script Language Reference Guide.
Examples
Stock index op ons
Currency Op ons
A ribute Value
Op on Class "Call"
Op on Style "European"
Underlying Quan ty 1
The underlying instrument must be set up as instrument with nature Index. The current price of the index must be maintained in the instrument price table of the
index. If you want to use theore cal valua on, the vola lity of the underlying index must be given in its chrono sub-table. Note that a 20% vola lity must be entered
as 20 and not 0.20.
Currency Op ons
The underlying of the op on is a currency, which can be bought (call op on) or sold (put op on) at the op on’s strike price.
As an example, we define a European call op on on EUR/USD. The op on is created with reference currency USD, underlying EUR. The strike price is 1.05 (i.e. 1 EUR
= 1.05 USD).
A ribute Value
Op on Class "Call"
Op on Style "European"
A ribute Value
Underlying Quan ty 1
As an example, we define an American put op on on the EUR_BOND_FUTURE (underlying of instrument nature Future) with a strike price of 105:
A ribute Value
Contract Size 1
Op on Class "Put"
Op on Style "American"
Underlying Quan ty 1
Cash Accounts
A cash account is an instrument for which accrued interest can be computed, and which has no maturity date. The interest is computed on the daily balance on a
value date basis.
Instrument Data
The following sec ons describe which data to enter and where:
Instrument Table
Income Event
Instrument Table
A ribute Descrip on
General Data
Parent Indicates the cash account from which the condi ons (or a ributes) are inherited.
Instrument This means you can define a master cash account only once and reference it here.
When interest rate condi ons change, you only need to update the "master
account" data.
Valua on Quote = 1
Rule
four dates
payment frequency
Dated Date Date on which accrued interest starts accruing. If not specified, Front Office – PM
uses the begin date of the instrument.
First Indicates when the first interest payment is made. From this date onwards, the
Coupon interest payments are deemed regular. If not specified, Front Office – PM assumes
Date the first coupon is one period from the dated date.
A ribute Descrip on
Last Date of the last interest payment. If not specified, the a ribute defaults to the end
Coupon date of the instrument.
Date
Payment Indicates the number of "payment frequency units" between two interest
Frequency payments (see below).
Payment Indicates the unitary period between two interest periods. The possible values are:
Frequency
Unit Month
Quarter
Semester
Year
For example, if interest is paid every six months, the se ngs must be done as
follows: payment frequency = 1, payment frequency unit = "semester".
End Of End of month conven on is not currently applied to Front Office – PM processes.
Month
Conven on When end of month conven on support is added, the End Of Month Conven on
field can be used to indicate whether interest payments that occur at the end of
months are repeated on the same date or at the end of month. For example, if we
have a semi-annual interest payment schedule paying on the 28th of February
2005, the payment schedule is:
Default A default cash account is automa cally generated when you create a new currency.
Flag There can only be one default cash account per currency. Front Office – PM uses
this default for all por olios and opera ons. In par cular, it uses the default to
define:
For example, for Forex contracts or currency op ons, the underlying instruments'
nature is Cash Account.
Debit Rate: interest rate charged on nega ve balances (if not specified, the interest rate specified above is used for both posi ve and nega ve balances).
Income Event
If the coupon schedule is too complicated to be maintained in the instrument table, the income events can be defined in this table in the same way as for bonds.
Addi onally, you can debit or credit a cash account in a different por olio by using a "cash por olio".
Opera ons
Account transfers: Performed using a buy or sell opera on if the accounts are in the same por olio. If the accounts are in
different por olios, por olio transfer is used.
Journal
The journal typically shows all income paid or received according to the defined payment schedule. The first payment date takes into account all past opera ons and
then assumes that the current balance does not change. For subsequent periods, it is assumed that the current balance does not change.
Money Market
The Money Market category describes "interest at maturity" instruments. It does not cover instruments with scheduled coupons. It does, however, cover deposits
that have renewal clauses.
You can use Money Market instruments to process "repurchase agreements" (also called “repos”) if you lock the repo instrument.
Characteris cs
Generic instruments
A Money Market instrument can be either "generic" or "non-generic". When working with generic instruments, you only need the currency held in the
instrument; all other data (begin date, end date, interest rate) is provided in the opera on. For non-generic instruments, the issue date, expira on date, rate of
interest, and currency are maintained in the instrument table or in its interest rate condi on sub-table.
You must create instruments that are traded on the secondary market (with accrued interest) as non-generic instruments.
Instruments that are not traded (such as OTCs) and are issued on demand can be created as generic instruments.
Loans
You can enter a loan as a short money market posi on. This can be useful for repos (see below).
Instrument Data
A ribute Descrip on
Valua on The standard Valua on rule for this instrument nature will be “Price = 1”, meaning
Rule that the market value of a money market posi on is the quan ty (no onal) +
accrued interest.
Alterna vely, you can set the value to Theore cal to get a pricing by discoun ng
from a yield curve.
Accrued Typically, you set this flag to Yes unless you require theore cal pricing because the
Interest theore cal price is the discounted value of the nominal and the final coupon
Flag payment.
Interest Specifies whether to use the simple MM method or the simple Compound method
Rate to compute the accrued interests.
Conven on
Yield Curve Yield curve to be used for the discoun ng when the Valua on rule is set to
Theore cal.
For more complex interest rate structures (floa ng or variable rates and stepped rates), the interest rate condi on sub-table must be used.
A ribute Descrip on
End Date Last date on which the rate applies (if not specified, the rate applies un l the
begin date of another fixed condi on).
Benchmark Rate instrument from which the interest rate is derived (e.g., 3-month Libor).
Opera on
The following sec ons describe how to enter transac ons in this instrument:
Paying interest
Roll over
Repos
Paying interest
To pay interest, use an income opera on. You must set the Fusion rule "AI Reset" to ensure that the accrued interest counter is reset to 0. If the reference nature of
the money market posi on is Open, you must specify Open when you pay the income and reference the opening opera on. This ensures that the income is
associated with the correct contract.
Roll over
With generic instruments, you can increase or decrease the quan ty without receiving or paying accrued interest. To do that, use the Fusion rule “amendment” in
the buy or sell opera on. In an amendment buy opera on, the amount of accrued interest computed from the opening of the deposit to the value date of the
amendment is stored in the new posi on (in the "accrued amount"). When a valua on is required, the accrued interest is computed from the value date of the new
posi on and added to this stored amount.
Repos
A repurchase agreement (also called repos) is processed as the sale of a money market instrument or a discount instrument with the simultaneous locking of the
repo posi on.
The locking of the repo posi on can be entered with the buy opera on of the money market or discount instrument by using the “locking” a ributes.
A ribute Descrip on
Addi onally, the following opera on fields are used for informa on purposes. Front Office – PM can use their default values to compute the quan ty of money
market or discount instrument to purchase or sell:
A ribute Descrip on
Lock Dirty Price The price including accrued interest at which the instrument is repo.
Lock Clean Price The price excluding accrued interest at which the instrument is repo.
When you repo an instrument, you create a posi on with the specified locking nature (e.g. Repo Locking). The posi on is used in the market valua on but is stored
as a separate posi on. In markets where it is unusual to see repo posi ons (that is, where they are considered as real sales), you can filter them out of the valua on.
(For more informa on about filters, refer to the WealthSuite Front Office - Por olio Management - Format and UDS Reference Guide).
Valua on
Valua on
As men oned above, the computa on of accrued interest takes into account the fact that the quan ty in the posi on has poten ally changed over me without any
payment of income.
For theore cal valua on, the appropriate interpolated rate from the yield curve specified at the instrument level is used. The interpolated rate is compared to the
rate at which the deposit was made (in the opening opera on or at the instrument level) and the difference is discounted as of the date of valua on.
The market value represents the nominal amount, plus or minus the discounted difference applied to the nominal.
To set up a French Average Rate opera on, create a generic or non-generic Money Market instrument with the sub-nature Average Rate. This sub-nature does the
following:
Computes accrued interest, taking into account the +1 day accruals based on the previous day's rate.
Lets you define a rate as an index. This index can then be used to retrieve daily rates to calculate accruals.
Lets you specify an addi ve margin in the opera on for generic instruments based on the index described above.
Characteris cs
Generic instruments
When you create a generic Money Market instrument, you must enter the Value and Expira on Dates at the Opera on level. Since the interest rate changes over
the life of the contract, you do not need to specify it in the opera on screen. Nevertheless, when you enter a rate in the opera on screen, it is treated as an
addi ve margin that overrides the instrument’s addi ve margin.
There are two ways to define the daily changing interest rate:
As a series of daily fixed Interest Rate Condi ons: the rate specified is used regardless of addi ve margins.
As a floa ng rate instrument at Money Market Instrument level: the floa ng rate instrument is a rate whose daily
quotes (rates) are retrieved. The margin specified in the opera on (as a rate) or directly in the Money Market
instrument is added to the retrieved rates and is used to compute accruals.
The first solu on lets you create one generic money market for different contracts with the same maturi es since the rates are the same for all the contracts.
The second solu on lets you define one generic instrument for all contracts and maturi es since the spreads (i.e., the rates), relate to every single contract.
Non-generic
When you create a non-generic Money Market instrument, you must define the Begin and End dates in the instrument.
There are two ways to define the daily changing interest rate:
As a series of daily fixed Interest Rate Condi ons: the rate specified is used regardless of addi ve margins.
As a floa ng rate instrument at Money Market Instrument level: the margin specified in the Money Market instrument
is added to the daily quotes (rates) of the floa ng rate instrument and is used to compute accruals.
As the instrument is non-generic, you must create an instrument for each contract in both these solu ons.
Instrument table
A ribute Descrip on
General Data
Generic Flag If the flag is set to Yes, some data (Value Date, Expira on Date and Addi ve
Margin) is retrieved from the opera on created. If the flag is set to No, you
must define all the data in the instrument table.
Valua on Rule Since these instruments are typically equal to par, set the Valua on rule to
Quote=1.
Floa ng Rate The rate instrument whose retrieved quotes are used as daily changing rates to
Instrument compute accruals.
A ribute Descrip on
Begin Date For non-generic instruments, this is the date on which interest starts to accrue.
End Date For non-generic instruments, this is the date of expira on of the instrument.
Sub-nature Average Rate should be the sub-nature. This way, Front Office – PM will handle
all the French Average Rate par culari es (see Defini on above).
Addi ve The margin specified is added to the daily retrieved rates (the quotes of the
Margin floa ng rate instrument). With generic instruments, this is overwri en with the
rate specified in the opera on.
Interest rate data: The interest rate applied is determined according to the following se ngs in
the order given (note that all the processing depends on the Average Rate sub-nature)
Floa ng Rate If you specify a Floa ng Rate instrument, Front Office – PM uses its retrieved
Instrument daily quotes with the Addi ve Margin added, if there is one.
Interest Rate Fixed interest rate condi ons that change daily should be entered here.
Condi on
table
End Date Last date on which the rate applies (if not specified, the rate applies un l the
Begin Date of another fixed condi on).
Interest Must be defined as a fixed interest rate condi on. Floa ng Rate Instruments
Calcula on are only handled at instrument level.
Rule
Generic instrument
Rate (in the Margin added to the floa ng rate instrument values, overwri ng the margin
opera on) specified in the Money Market instrument.
Non-generic instrument
A ribute Descrip on
Valua on
The easiest, cheapest and most efficient way to handle French Average Rate Money Markets is to define a Generic Money Market with the overnight reference rate
as the floa ng rate instrument and Average Rate as the sub-nature.
Accrued interest in the opening opera on would be 0 but a valua on on the same date returns one day's accrued interest es mated from the previous day's O/N
rate. On the other hand, the only difference in valua on on the penul mate and last day is not the number of days of accrual but the rate used.
On the penul mate day, the overall accrued amount includes one day calculated from the previous day's O/N rate. On the last day, the overall amount (which is
nearly the same) is computed using the real, available O/N rates for the period.
Forward Contracts
A forward contract is an agreement between two par es to exchange one currency for another at a fixed future date. The rate at which the exchange is to be made,
the delivery date and the amounts involved are fixed at the me of the agreement.
In contrast, a spot transac on is entered as the purchase or sale of a quan ty of a cash account against another in a different currency.
Characteris cs
You can define a forward as a generic or as a non-generic instrument.
In a non-generic instrument, the start date and the delivery date (value date) of the contract are defined in the instrument defini on. This means that this
instrument can be only used once (i.e., for a specific contract on a single por olio).
When working with generic instruments, the start date and the value date are set at the opera on level. This means that you do not need to create an instrument
for each contract but rather one instrument per currency pair.
Instrument Data
A ribute Descrip on
Underlying A Cash Account instrument with a reference currency set to the currency bought
Instrument (for a long contract).
To decide which is the reference currency and which is the underlying currency,
look at how the exchange rate is quoted. It should be quoted as 1 unit of
underlying expressed in the reference currency.
Example:
A contract to buy USD against CHF is a CHF instrument with USD as the underlying.
The exchange rate is quoted in the number of CHF for 1 USD.
Generic Indicates whether the dates involved in the contract are registered at the
Flag instrument level or the opera on level.
Begin Date The date at which the contract was entered (for non-generic instruments only).
End Date The value date of the contract (for non-generic instruments only).
Yield Curve Yield curve for the reference currency. Only used when theore cal valua on with
the discoun ng method is used. If no yield curve is set, the default yield curve of
the reference currency will be used. It is not possible to set a yield curve for the
underlying currency in the forward instrument. For this currency, the default yield
curve will always be used.
Opera ons
Margin calls
Data Descrip on
A sell opera on means that the underlying currency is sold and the reference
currency is bought.
Quote The contractual fixed rate of the contract. The price is computed using the price
calcula on rule.
Data Descrip on
Data Descrip on
You can define these as default values at the opera on level. The Journal and Event
Genera on func ons will use these values.
Margin calls
In markets where forwards are market to market, margin call opera ons can be performed (for more informa on, refer to the WealthSuite Front Office - Por olio
Management - Opera ons, Posi ons, and Fusions Reference Guide).
Valua on
Journal
Event Genera on
Valua on
The display of the valua on of forward contracts depends on the system parameter FWD_ACC_FLAG (Forward Accoun ng Flag).The permi ed values are:
FWD_ACC_FLAG Effect
0 The forward posi on is displayed on two legs; the contract leg and an
offse ng cash posi on ("cash leg").
The quote used to value a forward contract depends on the Valua on rule of the instrument. You can have either:
FORWARD_VAL_RULE Effect
Rule 1 Ini al difference between the cost price and the spot cost price is added
on a pro-rata temporis basis to the current quote of the underlying
instrument. For more informa on, see sec on below.
Rule 2 Theore cal price is calculated by using the discoun ng factors from
yield curves. This method requires the Advanced Analy cs licence. For
more informa on, see sec on below.
Rule 1: Theore cal by a pro-rata distribu on of the ini al forward premium or discount over the life me of the contract
This method is applied for instruments with Valua on rule set to Theore cal when the system parameter FORWARD_VAL_RULE is set to 1.
Quote = Current spot rate + [(cost price - spot cost price) * d/D]
Where:
Current spot rate = Spot currency rate that is valid on the valua on date.
Spot cost price = Spot currency rate that was valid at the date of the opening opera on.
Where:
= Discount factor for currency A for the me between the valua on date and
the value date (maturity date) of the forward.
Example:
We buy USD 1 million versus USD at a forward rate of 1.0397 (i.e., selling EUR 1,039,700) with opera on date = 15/01/2000 and value date = 03/04/2000.
The valua on for the forward as of 31/01/2000 should be calculated and the spot currency rate at this date is 0.9772.
This example is based on the calcula on of interpolated rates and not the calcula on on interpolated discount factors.
1 Calculate On 31/01/2000, the EUR yield curve is composed of a one-month simple MM rate at
the 3.1530% and a three-month simple MM rate at 3.3820%. These rates are used to calculate
discount the interest rate for the me period between the valua on date (31/01/2000) and the value
factor for date of the forward (03/04/2000).
EUR
The interpolated rate is calculated by using compound rates. For this, the simple MM rates
are converted into compound rates.
From these two rates, the interpolated rate for EUR is calculated:
= 0.99429219
2 Calculate On 31/01/2000, the USD yield curve is composed of a one-month simple MM rate at
the 5.7580% and a three-month simple MM rate at 5.9630%.
discount
factor for One month compound rate calcula on:
USD
DF = 1/ (1 + 5.758 / 100*(29/02/2000 - 31/01/2000) / 360) = 0.995383026
From these two rates, the interpolated rate for USD is calculated:
= 0.98982885
= 0.972813392
4 Calculate The calcula on of the market value of the forward posi on is easier to understand when the
the market forward is displayed in two legs (i.e., FORWARD_ACC_FLAG = 0 or working in Risk View).
value
The valua on (in EUR) of the forward leg (i.e., USD-leg) is calculated as
= quan ty * *
The value of the forward rate is shown as Price in the Valua on screen.
The valua on (in EUR) of the cash leg (i.e., EUR-leg) is calculated as
Where:
The global market value of the forward posi on (as valuated in one leg) is the sum of the
market values of both legs:
= - 66 504.83 EUR
This formula shows that the market value of the forward posi on is equal to the unrealised
profit and loss of the posi on due to the difference between the forward rate (as observed
on the market) and the contracted rate (which was nego ated in the opening opera on of
the contract). However, this unrealised profit and loss would only be realised at the maturity
(value date) of the contract. Thus, it has to be discounted by the discount factor in the EUR
DFEUR from the value date to the valua on date.
The term is also known as net present value (NPV) of the forward contract and is calculated
as:
= ( * ) - (
* contracted rate)
The system parameter RISK_FWD_RULE determines the natures of the two posi ons. It does not, however, impact the calcula on of the quan es, market values,
etc. The overall sum of the values in the valua on currency is iden cal between the accoun ng view and the Risk View.
For the posi on in the forward contract, the quan ty is the quan ty in the underlying currency of the contract. This is
converted to the forward's reference currency by the current forward rate, and then converted to the valua on currency by
the current exchange rate.
The posi on in the cash account corresponds to the "cash leg" as if working with FWD_ACC_FLAG = 0. This posi on is in
the reference currency of the contract.
When working with the theore cal valua on and FORWARD_VAL_RULE = 2, both posi ons are discounted with the
discount factors in the respec ve currency.
When working with the system parameter RISK_CASH_LEG_RULE_MASK = 1, the system will generate the cash account
posi on in an ar ficial instrument. In this instrument, the a ribute risk_orig_instr_id references the forward instrument,
and the a ribute parent_instr_id references the original cash account. By means of these a ributes, all a ributes of the
original instrument become available for lists and classifica ons. This allows, for example, the display of the cash leg
together with the forward leg under "Forwards" in Check Strategy and Performance business func ons.
Journal
The contract is closed in the Journal func on. The accounts used are those set by the default value and therefore, allow "Delivery" or "Se lement" closing.
Event Genera on
The Event Genera on func on is able to – manually or via batch processing - generate Opera on and Accoun ng dates prior to the Expira on Date with a number of
Business Days defined at the Se lement Day Cycle level in the instrument table.
To allow the genera on of Opera on and Accoun ng dates prior to n Business Days from the Expira on Date, you must set the Se lement Day Cycle in the forward
descrip on
The Se lement Day Cycle field must be an integer and should be <<Blank>>, set, and modified. By default, the field is set to <<Blank>>.
A default value should also be implemented in the Accoun ng and Opera on dates:
If the Se lement Day Cycle field is set - with a value different than 0 or <<Blank>> - and the default value scripted, then the Opera on and Accoun ng dates will be
shi ed to the prior Business Day available for both the reference currency and the underlying currency.
For example, if Se lement Day Cycle field is set to -3, the dates of the sell opera on that closes the forward is calculated as:
In this example, only the Accoun ng date is scripted to take into account the Se lement Day Cycle; the same rule should be applied to the Opera on date.
Future Contracts
A future is a contract between two par es to buy or sell a specified quan ty of a financial instrument at a determined date in the future, where the price is already
fixed when the deal is concluded.
Characteris cs
The data related to a contract’s quote and se lement characteris cs is stored in the instrument or term contract sub-tables. However, the contractual price and the
se lement dates are stored in the opening opera on.
Instrument Data
The following a ributes specifically relate to Futures contracts:
A ribute Descrip on
Quote / 100
Contract Indicates the number of underlying instruments covered with one contract. No ce
Size that this is used mainly when inpu ng and displaying the quan ty of futures, as
the quan ty saved in the database is always equal to the quan ty of the posi on
mul plied by the contract size.
Underlying Stock, Bond (Fixed income), Deliverable, Index, Cash account, and Commodity.
instrument
Physical A checked box indicates that you want to deliver the underlying; if the check box is
delivery cleared, the contract is se led with cash compensa on.
For more complex cases such as delivery condi ons for bond futures, the term (contract) event sub-table is used. The relevant a ributes are:
A ribute Descrip on
Conversion The factor by which the futures se lement price is mul plied to calculate the
Factor invoice amount.
Opera ons
The following sec ons describe how to enter transac ons in this instrument:
Adjustment
Margin calls
A ribute Descrip on
Value Date of the opera on is the se lement date of the contract (Dates panel).
A ribute Descrip on
Future FIFO: Contracts with the same sign do not merge; offse ng
contracts merge according to the "first in first out" method.
Account 2 If fees and taxes exist in an opera on, you must detach them from the Account 1
field and use the Account 2 or Account 3 field. If a cash por olio is used in the
opera on, use the Account 3 field for fees and taxes instead of the Account 2 field.
The detachment of fees and taxes from the Account 1 field for the Return and
Performance func ons calcula ons is mandatory.
When closing an opera on, if there is a value in the Account 2 field, the fusion
process transfers the P&L cash flow from "Account 1" to "Account 2". (For more
informa on, refer to sec on “Cash Management” in the WealthSuite Front Office -
Por olio Management - Opera ons, Posi ons, and Fusions Reference Guide).
Account 3 With or without a cash por olio, the Account 3 field can be used to detach fees and
taxes from "Account 1". It is, therefore, recommended that you always use the
Account 3 field to detach fees and taxes from "Account 1".
Adjustment
When Futures contracts are used to hedge, you can impact the hedged posi on of the cost of the hedge using an adjustment opera on (refer to the WealthSuite
Front Office - Por olio Management - Opera ons, Posi ons, and Fusions Reference Guide for more informa on).
Margin calls
Margin calls are processed using Adjustment Opera ons. There are two ways to enter the opera on:
Indicate the new cost price and the margin amount (in amount 2). Two different behaviours are possible depending on the
system parameter FUT_PL_ACCT2_MARGIN_CALL:
If the opera on date is less than FUT_PL_ACCT2_MARGIN_CALL, the old behaviour is applied (i.e., any difference is
added to P&L).
If the opera on date is greater (or equal) than FUT_PL_ACCT2_MARGIN_CALL, then margin amount of amount 2 feeds
P&L.
If a difference exists between the given amount and the calculated P&L by the fusion process, this difference is added to the future resul ng posi on
(instrument and cash legs) to con nue to keep a balanced posi on. The next closing opera ons include this difference in the P&L (cash flows on account 2
and balance P&L posi ons).
For more informa on, refer to the WealthSuite Front Office - Por olio Management - Opera ons, Posi ons, and Fusions Reference Guide.
For this reason, you cannot invest, withdraw, or transfer Futures contracts.
Valua on
Journal
Valua on
The valua on of Futures contracts depends on the FUT_ACC_FLAG system parameter.
If the flag is set to "0", the posi on is valued as price mes quan ty and an offse ng cash posi on is valued.
If the flag is set to "1", the value of the posi on is the difference between the current price and the contractual price.
When using Cash Account 2 (*) on closing posi on, with value date greater than accoun ng and opera on dates:
If the flags FUT_ACC_FLAG and FUSION_CASH_VALUE_DATE_FLAG are set to "1" (fusion process use value date for cash posi ons) and the system parameter
FUSION_DATE_RULE is set to "1" or "2" (fusion process use opera on date or accoun ng date for non-cash posi ons), then:
when we make a valua on on the accoun ng date, the valua on func on show us the following cash posi ons:
when we make a valua on on the value date, the valua on func on show us the following cash posi on:
(*) Using Cash Account 2 on the closing posi on, for Future instruments, leads to an automa c transfer of P&L from cash account 1 to cash account 2.
Example:
where:
t is me un l expira on in years
t is me to delivery.
AA selects the cheapest-to-deliver either according to market prices or the theore cal prices of the bonds that composes the basket. In each case, AA computes the
net present value, dura on, convexity, and basis point value of the cheapest-to-deliver selected. Computa ons are based on the keyword AA_DF_FUT in which the
last parameter can be set to True for market prices or False for theore cal prices.
For rules 1 -4, the future contract is either valuated at its full value (i.e., price mes quan ty) or replaced by a posi on in the underlying. In both cases, an offse ng
cash posi on is shown. Two specific cases must be noted: Eurodollar futures and bond futures.
Eurodollar futures: These futures show a risk posi on in the underlying instrument, which is a "Rate". The rate instrument is
then considered as a Money Market instrument.
For rule 5, the future posi on is decomposed into a posi on in the underlying, a cash leg (equivalent to the cash leg as if working with FUT_ACC_FLAG = 0 in the
accoun ng view), and a me value leg, which represents the difference between the market value of the future posi on (as if working with FUT_ACC_FLAG = 0) and
the posi on in the underlying.
FC_RXZ6 contract contains an Underlying Bond (i.e., Cheapest-To-Deliver - CTD) GERMANY GOVT 3.25% Maturity Date 04-
July-2015.
Conversion Factor of CTD Bond is 0.819739 and the Close Price of CTD Bond as of 01-Dec-2006 equals as EUR 97.324.
In a por olio, there is a long Bond Futures Contract (FC_RXZ6) on 01-Dec-2006 with the following characteris cs:
Quote (Cost Price used in Buy Opera on) of EUR 118.25 (Front Office – PM converts quote-to-price EUR 1.1825).
Gross Amount (of the long Bond Futures posi on) = Quan ty * Contract Size * Price = EUR 1,182,500.00
Risk View valua on in Front Office – PM decomposes the Futures contracts into:
The Futures posi on’s gross amount (the one that is displayed when the FUT_ACC_FLAG is set to 0).
Computa on for underlying instruments
Quan ty of the Underlying Bond = (Quan ty of Futures contract * Contract Size) / (Conversion Factor of CTD Bond specified in the instrument’s chrono table).
In our example:
Quan ty of the Underlying Bond = (10 * 100,000) / 0.819739 = 1,219,900.4805 = 1,219,900.48 (round up to 2 decimals).
Accrued Interest on the Underlying Bond = (Quan ty of Futures contract * Contract Size * Interest Rate * Numerator Basis) / (100 * Denominator Basis) = EUR
16,189.10.
Market Value of the Underlying Bond = (Quan ty of Underlying Bond * Market Price of the Underlying Bond) + Accrued Interest of Underlying Bond = (1,219,900.48
* 0.97324) + 16,189.10 = EUR 1,203,445.04.
Computa on for Offset Cash on underlying instruments
Quan ty of the Offset Cash = (Cost Price of Futures contract * Conversion Factor + Unitary Accrued Interest of Underlying Bond un l Maturity Date) * (Quan ty of
the Bond Futures Contract * Contract Size).
Quan ty of the Offset Cash = (1.1825 * 0.819739 + 0.01417361250) * (10 * 100,000) = 983,514.98.
As this cash posi on does not correspond to a risk component of the Future’s posi on, the Risk Nature (risk_nat_e) is
equal to 0.
As the Future Accoun ng flag is set to 1, this cash posi on is not considered as accounted; so the accoun ng flag (acct_f)
is equal to 0.
The Underlying Bond has a market price of 103% and a unitary interest of 0.0352778. In the Risk View valua on, the long future posi on is replaced by a long
posi on in the underlying bond (quan ty = 50,000 EUR nominal, market value = 50,000 * 103% + 50,000 * 0.0352778 = 53,263.89 EUR.
The " me value leg" will be generated to take on the difference between the market value of the future posi on and the market value of the risk posi on in the
Underlying Bond.
Journal
Futures contracts are closed out in accordance with the FUT_JRNL_RULE system parameter. This parameter indicates if futures expira ons are displayed and, if so,
whether this occurs the following day (in effect simula ng a margin call) or on se lement. The system presents a buy opera on at the date of expira on.
Examples
Currency futures
Bond futures
Currency futures
Let us take a December 1998 future contract on the JPY. The contract represents 12.5 million yen, the quota on is in USD per JPY, and the expira on date is 15-12-
2008.
A ribute Value
Code JYZ8
Name
Denomina on
Reference USD
Currency
Market IMM
A ribute Value
Ac ve Yes
Category Future
Odd Lot 1
Quan ty
Underlying JPY
Physical Yes
A ribute Value
Code SPH9
Name
Ac ve Yes
Category Futures
A ribute Value
Physical No
Bond futures
Consider a Bond futures contract FC_RXZ6 with expiry date 11-Dec-2006.
The FC_RXZ6 contract contains an Underlying Bond (i.e. Cheapest-To-Deliver) GERMANY GOVT 3.25% Maturity Date 04-Jul-2015.
The Conversion Factor of CTD Bond is 0.819739 and the Close Price of Cheapest-to-Deliver Bond as of 01-Dec-2006 is EUR 97.324.
A ribute Value
Name EuroBund11Dec06
Denomina on
Category Future
Physical Yes
Index
An Index is any average or representa ve indicator that is used to summarise the level of an ac vity or the value of a market.
An Index is therefore considered as a quoted instrument or a composite instrument that is computed from the prices of the component instruments.
Instrument Data
The most important a ributes of the Index are the following:
A ribute Descrip on
Composite: The index is composite and the price is computed using the
component instruments
Risk Nature Set to ‘Hybrid’ if the components are to be displayed in a Risk View.
Index Return Describes whether the index is a capital index or a total return index, and if so,
Type whether it includes net or gross dividends (for documenta on purposes only).
Composite Indicates how the value of a composite index is computed (e.g., Sum, Highest,
Calcula on Lowest, Arithme c Mean, etc.).
Rule
Index Divisor Amount by which an index computed by average is divided (for documenta on
purposes only).
Index Base Defines the value of the index at Index Base Date (for documenta on purposes
Value only).
Index Base Used when the index is a ra o between the current value of the components and
Date the value at a specific date (for documenta on purposes only).
Index Time Indicates whether the index is computed at a specific date or whether it is an
Rule average over me (for documenta on purposes only).
Index Forex For mul -currency indexes indicates if amounts in foreign currencies are
Flag converted (Yes) or simply added (No) (for documenta on purposes only).
Underlying Instruments
Benchmarks
Underlying Instruments
In this case, the Index is used as an underlying instrument for deriva ve contracts. Note that in the case of basket op ons, you can create an Index as a composite
instrument that defines the basket and is used as the underlying. For example, you can enter an op on to buy two UBS and enter five CS stocks as an op on on an
Index, where the Index is composed of the instruments men oned above.
Benchmarks
Indices are frequently used for the comparison of the performance of a por olio or a part of it. You can use an Index directly as benchmark in the Performance
Analysis func on, or define it as benchmark object for a market segment in a strategy. For more informa on, refer to the WealthSuite Front Office - Por olio
Management - Performance Analysis Reference Guide.
Rate
A rate is an interest rate, or any other indicator such as infla on rates or vola lity points.
Instrument Data
The main instrument data are the following:
A ribute Descrip on
Default Flag Defines the risk free rate of the currency. Only one default rate may be defined per
currency.
Yield Curve Specifies that if the rate is the benchmark of a floa ng rate instrument, then the
curve on which future cash flows must be computed. Used in Floa ng Rate Notes
(FRN) or swap floa ng leg computa ons.
Bill Discount: Discount rate based index (as in South African Discounted
Bank Bill FRA's, or Italian CCT's)
Bill Yield: means that the rate is the yield of a bank bill (as in Australian
90 day bank bill futures)
Par Yield: the index is the rate of an underlying instrument (par yield of
bond or swap) as used in constant maturity swaps.
Interest Specifies the conven on used for the spot rates, which are stored in the price
Rate table, and implicitly, how they are interpolated into the yield curve.
Conven on
Simple MM: Standard for short term rates; the discount factor is
expressed as: 1/(1+r*t)
Compound: Standard for long term rates; here the discount factor is
expressed as: (1+r/qb)^(-t*qb)
Con nuous: Used for a con nuous compounded yield; the discount
factor is expressed as: e^(-r*t)
Where “r” is the rate, “t” is the frac on of the year and “qb” is the quo ng base
(i.e., number of payments made during the year).
Rate Used with rate frequency unit to indicate the period for which the rate applies
Frequency (e.g., 1 month, 3 months, 5 years).
A ribute Descrip on
Payment Used with the Payment Frequency Unit to define the theore cal payment
Frequency frequency of the rate. When you enter the zero coupon yield rates, it is important
to specify that rates over one year are compounded annually. When the sub-type
is set to Par Yield, the Payment Frequency is used to indicate the frequency of
payoffs if the rate applies to a security with payoffs. Typically, this is used for rates
that underlie the floa ng rate indexes (e.g. CMT and CMS swaps) where the
underlying is a par yield rate of a 5-year Treasury.
Log Used for spread op ons to indicate whether the rate differen al can be modelled
Distribu on as a lognormal distribu on or a normal distribu on.
Flag
No means a normal distributed spread.
Fixing Rule The expression of the frequency (usually “Business Day”) for the fixing rule. The
Unit combina on of these two arguments (Fixing Rule Number and Unit) generates a
fixing rule, which determines the date on which a rate is deemed valid. In other
words, it is the number of days before the coupon date; at this date, the rate that
fixes the next coupon is retrieved.
Fixing The calendar related to the rate to which the fixing rule is applied.
Calendar
Example: FRN based on a 3-month EURIBOR rate, star ng on March 15th 2002,
fixed on day 2 (payment conven on: modified following).
Risk-free rate for op on pricing and analy cs. You must define a default rate for each currency.
Floa ng rate instruments or swap floa ng legs: The rate defines the benchmark rate.
Yield curves and Vola lity curves: Defines the individual points of the curve.
Example
The USD 6-month Libor must be defined as follows:
A ribute Value
Code Lib6m
Name
Nature Rate
Category Other
Rate Frequency 1
Sub-Nature MM rate
Swaps
Swaps are private agreements to exchange cash flows in the future according to pre-arranged condi ons.
In a plain Vanilla interest rate swap, party B agrees to pay party A cash flows equal to interest at a predetermined fixed rate on a no onal principal for a number of
years. At the same me, party A agrees to pay party B cash flows equal to interest at a floa ng rate on the same no onal principal for the same period of me. The
currencies of the two sets of interest cash flows are the same.
A currency interest rate swap involves exchanging principal and fixed-rate payments on a loan in one currency for principal and fixed-rate interest payments on an
approximately equivalent loan in another currency.
However, there is no limit to the number of different type of swaps that can be invented. These include swaps with specific non Libor floa ng reference rates (e.g.,
TAM or CMT swaps), swaps that entail the exchange of payments from two different floa ng reference rates (basis swaps), swaps with more than two legs, and
swaps where one leg depends on an equity index or a commodity price.
In view of the diversity of possible swap structures, you can define swaps in Front Office – PM in a few ways. The most complete way is to define the swap as a
composite instrument and associate component legs (in most cases, bonds) with it. However, as this way can be cumbersome for "standard" swaps, you can enter
the component legs as one instrument.
Constant principal
You can insert swaps with broken periods directly into the swap itself, using the interest condi on sub-table (see sec on Swaps for more informa on).
By adding a fixing rule to the rate defini on, you can easily use generic swaps based on *IBOR rates fixed, for example, on day 2.
Instrument Data
The following sec ons describe which data to enter and where:
Standard Swaps
Non-standard Swaps
Standard Swaps
The instrument must be defined as follows:
A ribute Descrip on
General informa on
Generic If the swap is generic, the paid fixed leg rate and the Begin Date of the swap are
Flag specified at opera on level (Quote and Value date fields). If the swap is non-
generic, the paid fixed rate and the Begin Date are specified in the instrument
(Paid Interest Rate and Begin Date fields).
Valua on For value Composite or Theore cal (the effect is the same), Front Office – PM will
Rule compute the net present value (NPV) and current replacement swap rate.
The value Quoted must be used if the prices are coming from an external source.
Risk Nature Set to “Hybrid” if the instrument is divided into separate legs for risk analysis.
A ribute Descrip on
This enters all data in the swap instrument itself (i.e., not as a composite
instrument).
Begin Date Star ng date of the swap, if the instrument is not a generic instrument.
Principal Indicates whether the principal is no onal or is actually exchanged, and if so, when
Exchange the exchange(s) occurs (ini al and / or final dates).
Rule
Interest Specifies whether to use the simple MM method or the simple Compound method
Rate to compute the accrued interests on Fix legs only (see sec on Fixed Income). No
Conven on accrued interest is computed on floa ng legs.
Received leg
Floa ng If the received leg is a floa ng leg, this is the benchmark for which the floa ng
Rate payments are computed. This instrument is a "rate". The curve on which this rate
Instrument is found is the associated yield curve specified at the rate level. Typically, this
benchmark yield curve is the same as the curve used to discount the payments.
However, in some swaps (e.g., CMTs or TEC 10 swaps), the curves are different.
Yield Curve Yield curve used to discount the received leg cash flows.
Payment Number of "Payment Frequency Units" between two cash flows (see below).
Frequency
A ribute Descrip on
End of End of month conven on is not currently applied to Front Office – PM processes.
Month
Conven on When end of month conven on support is added, the End of Month Conven on
field can be used to indicate whether cash flows that occur at the end of the
month are repeated on the same date or at the end of month. For example, if we
have a semi-annual coupon that pays on the 28th of February 1995, the payment
schedule would be:
Calendar The calendar used to determine the received leg cash flow schedule. If not
specified, the calendar of the reference currency of the swap is used.
Paid leg
Paid If the paid leg is a floa ng leg, the Paid Floa ng Rate Instrument field is the
Floa ng benchmark for which the floa ng payments are computed. This instrument is a
Rate "rate". The curve on which this rate is found is the associated yield curve specified
Instrument at the rate level. Typically, this benchmark yield curve is the same as the curve
used to discount the payments. However, in some swaps (e.g., CMTs or TEC 10
swaps), the curves are different.
Swap Paid The yield curve used to discount the paid leg cash flows.
Leg Yield
Curve
Paid Leg Day count method used for the paid leg.
Accrual
Basis
Paid Number of "payment frequency units" between two cash flows (see below).
Payment
Frequency
A ribute Descrip on
Paid Leg Indicates whether cash flows that regularly occur at the end of the month are
End of repeated on the same date or at the end of the month. For example if we take a
Month semi-annual coupon paying on the 28th of February 1995, the payment schedule
Conv. is:
Paid Calendar used to determine the paid leg cash flow schedule (if not specified, the
Calendar calendar of the reference currency of the swap is used). Can be different for a
currency swap Calendar.
A ribute Descrip on
General informa on
Generic Must be set to non-generic. The Begin Date is mandatory, whereas the paid rate is
Flag not (unlike standard swaps).
Valua on For value Composite or Theore cal (the effect is the same), Front Office – PM will
Rule compute the net present value (NPV) and current replacement swap rate.
The value Quoted must be used if the prices are coming from an external source.
Risk Nature Set to “Hybrid” if the swap is divided into separate legs for risk analysis.
Sub-Nature Indicates the one that suits your instrument defini on. For a basic swap, select
from:
Tenor Number of units in the life of the swap (e.g., 5 years). Select from:
Frequency
Unit Month
Quarter
Semester
Year
Note that for swaps defined in the Interest Condi on sub-table, you can ignore the
system message warning you that a tenor frequency is mandatory.
A ribute Descrip on
Principal Indicates whether the principal is no onal or is actually exchanged. In fact, this
Exchange a ribute indicates if the principal is exchanged at the ini al and / or final dates
Rule (Instrument: principal rule). In our case, the rule is usually No Exchange.
Business The method used to shi a flow when it falls on a weekend or a holiday.
Day
Conven on
Leg Data
For broken period swaps, the leg data is defined in both the instrument and the Interest
Condi on sub-table.
Received leg
Yield Curve Yield curve used to discount the received leg cash flows.
Payment Number of Payment Frequency Units between two cash flows (see below).
Frequency
Quarter
Semester
Year
If flows are exchanged every six months, enter the following: Payment Frequency =
1, Payment Frequency Unit = Semester. Note that even though you do not need to
enter a floa ng instrument or a fixed rate, the frequency is required.
End of End of month conven on is not currently applied to Front Office – PM processes.
Month
Conven on When end of month conven on support is added, the End of Month Conven on
field can be used to indicate whether cash flows that occur at the end of the
month are repeated on the same date or at the end of the month. For example, if
you have a semi-annual coupon that pays on the 28th of February 1995, the
payment schedule would be:
Calendar Calendar used to define the received leg cash flow schedule. If not specified, the
calendar of the reference currency of the swap is used.
A ribute Descrip on
Paid leg
Swap Paid Yield curve used to discount the paid leg cash flows.
Leg Yield
Curve
Paid Leg Day count method used for the paid leg.
Accrual
Basis
Paid Number of Payment Frequency Units between two cash flows (see below).
Payment
Frequency
Paid Leg Indicates whether cash flows that regularly occur at the end of the month are
End of repeated on the same date or at the end of the month. For example if we take a
Month semi-annual coupon paid on the 28th of February 1995, the payment schedule is:
Conv.
last: 28/02/95 - 31/08/95 - 28/02/96
Paid Calendar used to determine the paid leg cash flow schedule (if not specified, the
Calendar calendar of the reference currency of the swap is used). Can be different for
currency swap Calendar.
In a broken period swap, the first and/or the last period have a (usually) shorter period than others do. You need to enter this special period as a fixed condi on in
the interest rate condi on table.
A ribute Descrip on
Begin Date Date from which the interest rate condi on applies.
Interest Specifies if the interest rate condi on is fixed or floa ng; use this rule for broken
Calcula on periods as well even though the leg, itself, is floa ng.
Rule
Interest Fixed rate of the condi on. Can also be used to define the interpolated rate at
Rate which the broken period is se led.
A ribute Descrip on
Nature Paid Interest or Received Interest. Use the Nature field to dis nguish the two legs
of the swap. A typical broken period swap would need at least one Paid (or
Received) Interest AND two Received (or Paid Interest) condi ons. See below for
more details of the restric ons applied to the use of this Interest Rate Condi on
nature.
End Date The end date of the Interest Condi on. It is very important to set it correctly;
otherwise, condi ons may overlap and produce erroneous results.
Benchmark For Floa ng Interest Calcula on Rule, this is the floa ng rate.
Interest condi on sub-tables should only be used to define atypical swaps, especially broken period swaps. Consequently, you can only create a restricted number of
Interest Rate Condi on combina ons. The valid combina ons of Interest Rate Condi ons are as follows:
Suitable for broken period swaps, with the broken period at the beginning or the end of
Case the swap (i.e. before or a er the floa ng condi on). The buyer of the swap receives the
1: broken, floa ng leg and pays the fixed leg. See sec on Broken Period Swaps for an
example.
Case Same as Case 1, except that the buyer of the swap pays the broken, floa ng leg and
2: receives the fixed leg.
Case Suitable for broken period swaps, with the broken period at the beginning and at the end
3: of the swap. The buyer of the swap receives the broken, floa ng leg and pays the fixed
leg.
Case Same as Case 2, except that, in this case, the buyer of the swap pays the broken, floa ng
4: leg and receives the fixed leg.
Case Suitable for broken period basis swaps, in which each leg is broken either at the
5: beginning or at the end of the swap.
Case Suitable for broken period basis swaps, in which each leg is broken both at the beginning
6: and at the end of the swap.
One of these condi ons must be met; otherwise, the processing fails (for both the Valua on and Journal func ons). Currently, step-up swaps cannot be
implemented using Interest Condi ons.
Non-standard Swaps
The instrument must be defined as follows:
A ribute Descrip on
General informa on
Principal Indicates whether the principal is no onal or is exchanged. In fact, this a ribute
Exchange indicates if the principal is exchanged at the ini al and/or final dates (Instrument:
Rule principal rule).
A ribute Descrip on
Risk Set to “Hybrid” if the swap is divided into separate legs for risk analysis.
Nature
Valua on For value Composite or Theore cal (the effect is the same), Front Office – PM will
Rule compute the net present value (NPV) and current replacement swap rate.
The value Quoted must be used if the prices are coming from an external source.
cannot be selected as this would mean that all informa on is entered into the swap
instrument itself (i.e., not as a composite instrument).
Leg Data
Once the swap instrument is set up, you can then enter as many legs as necessary in whatever
currency you want. Typically, the legs for which analy cs are currently provided are bonds. You
can enter all the characteris cs of the bond. These include floa ng rate, stepped coupons, super
and inverse floaters, bonds with amor sa on, early call, or put features, etc.
Theore cal: Front Office – PM computes the theore cal price using the
appropriate yield curve.
Data Descrip on
Quan ty The quan ty of "leg" per unit of nominal. This can be a nega ve amount or can
reflect the fact that the leg is expressed in a different currency.
Rank Bear in mind that, in the Risk View, the instrument with the highest rank is given a
price that makes the sum of the value of risk posi ons equal to the value of the
"accoun ng" posi on if the la er is "quoted". However, if the swap is theore cally
priced, the rank should have no impact.
It is also possible to use this composi on data to create broken period swaps. You just need to define an irregular payment floa ng rate note and a Fixed Income with
the first coupon date shorter than the payment frequency. Then assign a nega ve quan ty to the paid leg and a posi ve quan ty to the received leg.
Note that the dates in the instrument composi on table relate to the overall composi on of the swap. For a forward star ng swap, use the Begin and End Dates of
the swap leg to define this situa on and NOT the dates in the instrument composi on table. This also applies to a swap where one of the legs changes during its life
to the extent that it can be considered as a different leg for a determined period.
Data Descrip on
Received leg
Floa ng Rate If the received leg is a floa ng leg, this is the benchmark for which the floa ng
Instrument payments are computed. This instrument is a "rate". The curve on which this
rate is found is the associated yield curve specified at the rate level. In the case
of a received EONIA rate, this instrument is the EONIA rate.
Yield Curve Yield curve used to discount the received leg cash flows.
Accrual Rule Day count method used for the received leg.
Payment Number of "Payment Frequency Units" between two cash flows (see below)
Frequency
End of Month End of month conven on is not currently applied to Front Office – PM
Conven on processes.
When end of month conven on support is added, the End of Month Conven on
field can be used to indicate whether cash flows that regularly occur at the end
of the month are repeated on the same date or at the end of the month. For
example if we take a semi-annual coupon paid on the 28th of February 1995,
the payment schedule is:
Calendar Calendar used to determine the received leg cash flow schedule. If not specified,
the calendar of the reference currency of the swap is used.
Paid leg
Data Descrip on
Paid Floa ng If the paid leg is a floa ng leg, the Paid Floa ng Rate Instrument field is the
Rate benchmark for which the floa ng payments are computed. This instrument is a
Instrument "rate". The curve on which this rate is found is the associated yield curve
specified at the rate level. Typically, this benchmark yield curve is the same as
the curve used to discount the payments. However, in some swaps (e.g., CMTs
or TEC 10 swaps), the curves are different.
Swap Paid Yield curve used to discount the paid leg cash flows.
Leg Yield
Curve
Paid Leg Day count method used for the paid leg.
Accrual Basis
Paid Payment Number of "Payment Frequency Units" between two cash flows (see below).
Frequency
Paid Leg End Indicates whether cash flows that regularly occur at the end of the month are
of Month repeated on the same date or at the end of the month. For example if we take a
Conv. semi-annual coupon paid on the 28th of February 1995, the payment schedule
is:
Paid Interest Fixed rate to be paid if the instrument is not a generic instrument.
Rate
Paid Calendar Calendar used to determine the paid leg cash flow schedule (if not specified, the
calendar of the reference currency of the swap is used). Can be different for a
currency swap Calendar.
Data Descrip on
Semester
Year
The table below shows the different se ngs to enter to define the different methods to compute the post-determined flow rates of an EONIA rate leg:
(Paid) (Paid)
(Paid)
Com- Com- Payment Payment Floa ng
Com-pounding
pounding pounding Freq. Freq. Unit Rate
Conven on
Freq. Freq. Unit
Rate Type
Compounding Conven on, Compounding Frequency, and Compounding Frequency Unit also appear for the Fixed Income nature (see sec on Fixed Income). This
means that you can define Floa ng Rate Notes based on an EONIA rate that use the same methods (Arithme c/Compound/T4M/TAM/TAG) to compute the post-
determined coupon rate.
Opera ons
The following sec ons describe how to enter transac ons in this instrument:
Swap Opening
Swap Closing
Payments
Swap Opening
The opening opera on of a swap is entered as a buy opera on.
An example of the purchase of a generic plain Vanilla 5-year swap in EUR is given below.
A ribute Value
Nature Buy
Price 0
A ribute Value
Quan ty 1,000,000
Gross 0
Amount
Account EUR
Accoun ng 14/07/2007
date
Opera on 14/07/2007
date
Spot Quote NULL (for currency swaps, this indicates the exchange rate applied on the ini al
and final principal payments.)
Swap Closing
The closing opera on of a swap is entered as a sell opera on. The opening opera on must be referenced to close the posi on.
As an example, the close opera on of the contract opened above must be entered in the following way:
Data Value
Nature Sell
Price 0
Quan ty 1,000,000
Gross Amount 0
Net Amounts 0
Account EUR
Data Value
Payments
If there are intervening payments, enter them as Income opera ons.
Valua on
Valua on
The value of the swap is given as the Net present value of each leg.
A fixed leg is discounted using the yield curve specified either at the instrument level, or if not found, the "default" yield
curve for the currency.
For a floa ng leg, the floa ng rate cash flows are generated from the yield curve defined at the floa ng rate instrument
level. These cash flows are then discounted using the yield curve specified either at the instrument level, or if not found, the
"default" yield curve for the currency.
The market "Quote" is the price of a replacement swap at current market condi ons.
To facilitate the understanding of the valua on calcula on of a swap posi on, the instr_flow table can retrieve some useful informa on. To obtain this informa on,
the Journal of Liquidi es func on must be launched at the valua on date, and for each future cash flow it can display:
Rates:
disc_factor_received_float_n, discount factor of the floa ng flow of swap instrument received leg (used to discount
received cash flow).
disc_factor_paid_float_n, discount factor of the floa ng flow of swap instrument paid leg (used to discount paid cash
flow).
disc_factor_received_instr_n, discount factor of the received leg of swap instrument (used in valua on func on).
disc_factor_paid_instr_n, discount factor of the paid leg of swap instrument (used in valua on func on).
Discount factors
Addi onally, Front Office – PM computes/displays the Discount Factors in the Journal func on providing greater support for liquidity management. Discount Factors
are derived from the Yield-Curve of the Reference Currency. Presently, Front Office – PM will display the discount factors for Single-Currency IRS (i.e., both legs of the
swap contain the same currency EUR, for instance).
Received Leg and the Paid Leg are computed/displayed as a separate columns thereby enabling efficient management/planning of future cash flows.
Discount Instruments
The discount instrument category includes instruments that are quoted with a rate and for which interest is included in the price (e.g., Treasury Bills, Cer ficate of
Deposit). Typically, the length of this type of instrument is less than one year.
Instrument Data
The specific a ributes for this instrument nature are:
Data Descrip on
Price Discount Rate: typically found in the USA (e.g., Treasury Bills, Banker’s acceptances,
Calcula on Commercial papers), in the UK (e.g., Treasury Bills and Banker’s acceptances), and
Rule Ireland (e.g., Treasury Bills). The general formula is: Price = 1 – (Discount rate x
(days/year))
Yield The curve whose rates are the basis for calcula ng the theore cal price and for
Curve performing analy c measurements
Opera ons
The following sec ons describe how to enter transac ons in this instrument:
Repurchase Agreements
Repurchase Agreements
A repurchase agreement (or repo) is processed as the sale of a money market instrument or a discount instrument with the simultaneous locking of the repo
posi on.
The locking of the repo posi on can be entered with the buy opera on of the money market or discount instrument by using the “locking” a ributes.
A ribute Descrip on
A ribute Descrip on
Addi onally, the following in the table are used for informa on purposes. Front Office – PM can use their default values to compute the quan ty of money market or
discount instrument to purchase or sell:
A ribute Descrip on
Lock Dirty Price The price including accrued interest at which the instrument is repo.
Lock Clean Price The price excluding accrued interest at which the instrument is repo.
When you repo an instrument, you create a posi on with the specified locking nature (e.g., Repo Locking). The posi on is used in the market valua on but is stored
as a separate posi on. In markets where it is unusual to see repo posi ons (that is, where they are considered as real sales), you can filter them out of the valua on.
(For more informa on about filters, refer to the WealthSuite Front Office - Por olio Management - Format and UDS Reference Guide).
Valua on
Risk Posi on
Journal
Valua on
Valua on is based on the price computed from the rate entered in the price sub-table. If the logic of the por olio is ‘Weighted Mean Price’, Front Office – PM
computes the Cost Price from the weighted average of the Price and not the Quote (rates).
When theore cal valua on is used, the appropriate interpolated rate from the yield curve specified at the instrument level is stored in quotes in Front Office – PM.
The price is recomputed from the discount rate or yield formula.
Note that as the Price Calcula on rule depends on the date at which the price is required; if there is no "price" at exactly the right date, it is recomputed from the
last "quote".
Risk Posi on
The risk posi on is the same as the accoun ng posi on.
Journal
The redemp on of the instrument appears at the maturity date.
Example
Consider a Cer ficate of Deposit (CD) issued by Bank Vontobel for a nominal amount of CHF 10 million for a period of 3 months. The rate is 2.75%. The buyer of the
CD is lending the bank CHF 10 million and at an interest rate of 2.75%.
At the opera on level, the opera on amount is calculated on the basis of the Discount yield price calcula on rule. The quote is 2.75% and the opera on amount is
equal to:
Commodi es
Commodi es typically include gold, pla num, and silver but they can also include any underlying commodity of a deriva ve instrument.
Instrument Data
The specific data for this instrument nature is the following:
A ribute Descrip on
Holding Percentage cost of carry per unit. This is used to compute the theore cal prices of
Cost commodity deriva ves.
Fund Share
A Fund share is characterised by the defini on of its dividend payments and its composi on. If the composi on is known, it is registered in a por olio fund, which is
linked to the Fund share through the por olio's fund weigh ng sub-table (see special cases). If only certain informa on is known, the dividend payments and
composi on are stored in the composi on sub-table. These composi ons can then be used to show the rela ve exposure to individual instruments held within the
fund.
Instrument Data
Fund shares are processed in a similar way to stocks.
Instrument Table
Sub-natures
Instrument Table
The following a ributes are specific for this instrument nature:
A ribute Descrip on
Risk Risk incurred from holding this security. The values are:
Nature
Equity
Interest
Commodity
Currency
Hybrid, which means that the risk comes from mul ple sources but is
itemised via the components of the instrument created using the
Instrument Composi on sub-table.
Payment Number of Payment Frequency Units between two dividend payments (see below).
Frequency
Payment Unitary period between two dividend periods. The possible values are:
Frequency
Unit Month
Quarter
Semester
Year
If, say, a Fund share pays a dividend every two months, you enter the following:
Payment Frequency = 2
If you do not complete these fields, dividends will not be projected in any cash flow projec on. If a frequency is entered, the last dividend with a "dividend
projec on flag" (see sec on Income Payment Events) set to Yes will be projected at this frequency.
A ribute Descrip on
Projec on Determines if this dividend is projected in future cash flows at the frequency
specified in the Instrument table. If the flag is set to No, the dividend is not
projected. If the flag is set to Yes, but the frequency in the Instrument is not
defined, the dividend will not be projected either.
Validity Indicates the date from which this dividend is valid. If a cash flow projec on is
Date required from a date preceding this validity date, the dividend will not appear.
Begin This is the date on which the dividend goes ex. If no “first coupon date” is specified,
Date this is also the payment date of the dividend.
First If specified, indicates when the value date of the payment of the dividend occurs. If
Coupon not specified, the value date of the dividend is the Begin Date. It is prac ced in
Date some markets, to define the beneficiaries of the dividend payments before the
actual payment date of the dividend. The holder of the Fund share before the ex-
date is en tled to the dividend, even if the holder sells it before the payment date.
Reciprocally, if the holder has acquired the Fund share a er the ex-dividend date
but before the payment date, the holder will not be en tled to the current
dividend.
Currency Indicates the currency of the dividend. It is suggested that this defaults to the
instrument currency.
The combina on of an Instrument, dividend projec on flag (Projec on check box), Validity Date, and Begin Date is unique. This means that an extraordinary
dividend and a normal repe ve dividend can be paid on the same day but thet two repe ve dividends cannot occur on the same day. You can also use the Validity
Date to specify that the presumed dividend is a defined amount (event 1) and that the known dividend (event 2) was entered later, rendering the presumed dividend
invalid from the Validity Date of event 2.
A ribute Descrip on
A ributes
Front Office – PM offers the possibility to store interest rates, value these interest rates as accrued interest, and generate them as Income Opera ons for Money-
Market and Fixed Income Fund Shares sub-types.
Two new a ributes are available for Fund Share Instrument and must be used to manage accrued interest:
Values: Yes/No. Se ng this flag to Yes allows for the calcula on of accrued interest for Fund Shares.
Sub-nature
The Validity Date is the date from which the condi on is valid; it usually is the instrument’s Begin Date or the first day of accrual calcula on.
The Interest Rate Value is expressed as a percentage and supports seven decimals.
Instrument Table
The following a ributes for the instrument table are specific for a Private Equity Fund:
A ribute Descrip on
Sub Nature The following sub-natures of Fund Share instruments determine the different
tranches of a Private Equity (PE) fund:
PE-Ini al Commitment
PE-Drawdown
PE-Capital Call
PE-Actual PE Security
These four components of a PE fund are linked to each other by way of a common
reference and the parent instrument.
Quoted: The quote can be found in the instrument price table for the PE
fund share instrument of sub-nature PE-Actual PE Security.
Parent This a ribute will hold the value of the instrument of sub-nature PE-
Instrument Ini al Commitment and will be used to link the four components of a PE
fund
A ribute Descrip on
Nature Total Issue indicates the amount paid out for the allotment of PE units.
A ribute Descrip on
Quote Defaulted to 0.
Price Defaulted to 0.
A ribute Descrip on
Nature Capital to Pay indicates the amount paid out for the capital call made by the PE
fund.
Quote Defaulted to 0.
Price Defaulted to 0.
Propor on Defaulted to 100% on the Capital Called amount but the user can define any
propor on between 0-100.
A ribute Descrip on
Nature Capital Return indicates the amount returned before the allotment of PE
units.
A ribute Descrip on
Quote Defaulted to 0.
Price Defaulted to 0.
Propor on Defaulted to 100% but the user can define any propor on between 0-100.
Base amount for Defaulted to Ini al Commitment but the user can define the propor on on
propor on the last capital call amount as well.
A ribute Descrip on
Quote Defaulted to 0.
Price Defaulted to 0.
Propor on Defaulted to 100% but the user can define any propor on between 0-100.
Base amount for Defaulted to Ini al Commitment but the user can define the propor on on
propor on the last capital call amount as well.
A ribute Descrip on
A ribute Descrip on
Quote Defaulted to 0.
Price Defaulted to 0.
Propor on Defaulted to 100% on the ini al commitment but the user can define any
propor on between 0-100.
Propor on Defaulted to 100% but the user can define any propor on between 0-100.
Base amount for Defaulted to Ini al Commitment but the user can define the propor on on
propor on the last capital call amount as well.
Propor on Defaulted to 100% but the user can define any propor on between 0-100.
Base amount for Defaulted to Ini al Commitment but the user can define the propor on on
propor on the last capital call amount as well.
A ribute Descrip on
Quote Defaulted to 0 but the user has to set the price at which the actual PE security
needs to be matured.
Price Defaulted to 0 but the user has to set the price at which the actual PE security
needs to be matured.
Propor on Defaulted to 100% on the ini al commitment. All open posi ons pertaining to all
components of PE fund will be affected as well as the corresponding opera ons
generated by the Event Genera on func on.
A ribute Descrip on
A ribute Descrip on
Sub Nature The following sub-nature of Fund Share instruments determine the signature
por olio:
External Product
Price Por olio Specific Price: For signature por olio, the price is searched in
Calcula on por olio_instr_price instead of en ty instr_price.
Rule
Fund Composi on
The following sec ons describe the composi on of funds:
There are three methods for compu ng the quan ty of each individual posi on when looking at the exposure due to holding the Fund share. The scaling coefficient
applied to a posi on quan ty depends on the Fund Spli ng Calcula on Rule applica on parameter FUND_SPLIT_CALC_RULE. The possible values are:
0: the quan ty of a fund por olio posi on is mul plied by a ra o of the value of one Fund share to the value of the fund
por olio (= fund share price / por olio market value).
1: the quan ty of a fund por olio posi on is mul plied by a ra o of the value of one Fund share to the sum of the daily
outstanding for each fund class mes its value (= fund share price / SUM(fund share i outstanding * fund share i price)).
2: the quan ty of a fund por olio posi on is mul plied by a ra o of the value of one Fund share to the Net Asset Value
(NAV) of the fund por olio (= fund share price / NAV).
Below is a detailed descrip on of these fund spli ng methods and their corresponding formula:
Method 1: the quan ty of a fund por olio posi on is mul plied by a ra o of the value of one Fund share to the value of the
fund por olio:
Where
MV = Market Value of the mutual fund por olio in the Fund share instrument currency
Method 2: the quan ty of a fund por olio posi on is mul plied by a ra o of the value of one Fund share to the sum of the
daily outstanding for each fund class mes its value:
Where
mj = daily outstanding for every share class (entered in the Number of Shares instrument chrono of the Fund share instrument)
Where
nj = price of Fund share class j (this is the price of the Fund share instrument that is split)
QX = number of instrument X in the mutual fund por olio equal to or greater than the posi on in the por olio to which the Fund share instrument is linked.
Note: Net Asset Value (NAV) of the mutual fund por olio (the por olio to which the Fund share instrument is linked) is the Fund share instrument currency,
which in Front Office – PM is equal to or greater than the last Net Asset Value por olio chrono at or before the Domain Ini al Date.
You can also choose the method used throughout the Domain. The following are the different permi ed values of the fund_split_rule_e field in the Domain:
Spli ng (pre-Release 4.10 standard behaviour): If the Fund share instrument is linked to the Mutual Fund por olio through
the fund_weight table, the spli ng method used depends on the FUND_SPLIT_CALC_RULE system parameter:
Otherwise, if the Fund Share instrument is not linked to a por olio through the fund_weight table, Front Office – PM looks at the composi on table of the Fund
share. If this composi on table is populated, the spli ng is performed according to the instruments found in this composi on table.
Forced Composi on: If the Fund share has a composi on defined, the split is performed according to this composi on,
otherwise Front Office – PM looks for a linked por olio to perform the split depending on the FUND_SPLIT_CALC_RULE
system parameter:
Spli ng method 1: This is the old method that was performed when the FUND_SPLIT_CALC_RULE system parameter
was set to 0 (see the descrip on of method 1 above). The FUND_SPLIT_CALC_RULE system parameter has no impact on
the fund spli ng if this op on is chosen in the Domain.
Spli ng method 2: This is the old method that was performed when the FUND_SPLIT_CALC_RULE system parameter
was set to 1 (see the descrip on of method 2 above). The FUND_SPLIT_CALC_RULE system parameter has no impact on
the fund spli ng if this op on is chosen in the Domain.
Spli ng method 3: This is the new method that is used to perform the spli ng (see the descrip on of method 3 above).
The FUND_SPLIT_CALC_RULE system parameter has no impact on the fund spli ng if this op on is chosen in the
Domain. If this method is not applicable (because some of the informa on described above is missing, for example, the NAV
por olio chrono), no fund spli ng is performed. The first step of method 3 is to look for the link to the mutual por olio
since in this case the composi on of a Fund share is not necessary. If there is no link to the mutual por olio, Front Office –
PM does not check for the existence of a Fund share composi on at all. This means that the Fund share is displayed in the
fund spli ng as it is in the accoun ng view.
For each method, if some of the required informa on is not provided, no fund spli ng is performed. Moreover, the Fund share is displayed as a standard posi on in
fund spli ng if there is neither a link between the Fund share instrument and the mutual fund por olio or a composi on. This means that the Fund share posi on is
shown as in the accoun ng view.
Notes:
You must specify the number of shares in the chronological data of the instrument and not in the Fund weigh ng logical
a ribute of the por olio.
You must specify the NAV in the chronological data of the por olio if FUND_SPLIT_CALC_RULE = 2.
Data Security
To manage the data security on fund spli ng, a specific Data Profile for fund spli ng is defined at the user level.
A Fund Profile can be useful if the Fund Por olios are only managed by few users but all users can launch a valua on with a fund spli ng op on:
Data Profile composi on includes the Data Security Profiles of Fund Por olios
Data Profile composi on does not include the Data Security Profiles of Fund Por olios
In the valua on func on, the security control of Fund Spli ng on Fund Por olios is applied on the user’s Fund Profile a er a rejected security control on the user’s
Data Profile.
etc.
In this case, the quan es are maintained in the instrument composi on sub-table and the Composite Calcula on Rule (index_calc_rule_e) of the Fund Share
instrument must be set to "Sum".
25 % DAX
35 % SMI
40 % MSCI Europe
In this case, the quan es are maintained in the instrument composi on table (as 0.25, 0.35 and 0.4) and the Composite Calcula on Rule of the Fund Share
instrument must be set to Percentage of Values.
If, in the example, the SMI is 7000 and the Fund share is 200, the posi on is:
In this case, these index instruments can be created with Valua on rule = Parent. The quan es are maintained in the instrument composi on table (as 0.25,
0.35, and 0.4). Set the Composite Calcula on Rule of the Fund Share instrument to “Sum”.
If, in the example, the Fund share price is 200, the posi on is:
Opera ons
The following sec ons describe how to enter transac ons in this instrument:
Dividends
Dividends
Dividends are paid using an Income opera on.
Valua on
Fund Spli ng
Risk Valua on
Journal
Event Genera on
[Link] Instruments Reference [Link]#_Toc33613432%3FTocPath%3DHom… 112/228
5/31/2021 Financial Instruments Reference Guide
Valua on
Fund shares are valued according to their Price Calcula on rule and Valua on rule.
Note: A Signature Por olio instrument is a fund share with a sub-nature as an external product and a Price Calcula on rule as por olio specific price. For
instruments with this se ng, the Valua on func on will not search for prices in instr_price but instead in en ty por olio_instr_price only.
Fund Spli ng
If fund spli ng is required, the exposure in the component posi ons is shown. Displaying the Fund share and/or the component instruments is done by filter mainly
on the Extended Posi on Fund Split field (see the Data Model for more informa on on the extended posi on logical table).
Note that:
For a logical fusion at the Front Office – PM level, a “Risk” posi on (derived from a fund spli ng or a Risk View) cannot
merge with an “Accoun ng” posi on.
To use the por olio to define a fund, select Mutual Fund from the Nature field's drop-down list. The Fund Share instrument must be put in the Fund Weigh ng
logical a ribute. Click Fund Weigh ng bu on at the bo om of the screen.
When running a valua on of a por olio,the posi ons in the por olio at the fund valua on date show the composi on of the fund. The weight of the posi on in an
instrument is simply calculated as the posi on's current market value divided by the total market value.
Fund share units must be bought in a standard por olio, in this case AAA_Fundshare. That way, the por olio that holds the Fund Share units can be split in the
Valua on to reflect the mutual fund posi ons associated with the Fund share.
Risk Valua on
If the Fund share is defined as Hybrid, it is replaced by its component instruments in a risk exposure valua on. This is independent of the fact that fund spli ng is
required. Therefore, to obtain a full exposure to all components, it is recommended to enable fund spli ng if you require risk posi ons.
Journal
Typically, the Journal func on shows all dividend projec ons as well as the cash flows pertaining to the PE fund.
Event Genera on
Typically, the Event Genera on func on generates the relevant opera ons pertaining to the various events of a PE fund.
Examples
Equity Index Fund
Enter the components in the composi on sub-table with their weights (Quan ty field), for example, instrument 022213 has
a weight of 15%. Note that Front Office - PM handles the changes in the composi on or weights.
Set the Composite Calcula on Rule field to Percentage Value as the value of the fund is the weighted sum (according to the
%) of its components.
[Link] Instruments Reference [Link]#_Toc33613432%3FTocPath%3DHom… 113/228
5/31/2021 Financial Instruments Reference Guide
Set the Valua on Rule field to Composite. That way, if there is no price in the chrono table (which is only available once a
month), then Front Office – PM calculates the value of a share according to the weights and prices of the indices composing
the fund.
Set the Risk Nature field to Hybrid in the main instrument table. This means that in the Risk View of the valua on, the
holding of a share of this fund is replaced by its components (independently of the “Fund Spli ng Calcula on Rule”).
At the opera on level, Front Office – PM can recalculate the composite value of the Fund share. The quote value is computed from the prices entered for each
component index.
The Composite Calcula on Rule field is set to Percentage Value and the ra o for a capital share is equal to:
Price of the capital share / (number of capital shares * capital share price + number of income shares * income share price)
Curves
The Curve nature is used to define a term structure, in par cular yield curves and vola lity curves. For an interest rate term structure, the Curve nature defines the
rela onship between the maturity of a Fixed Income instrument and the realised return of the instrument if it is held to maturity. For a vola lity term structure, it
defines the rela onship between me and vola lity.
The yield curve used is the zero-coupon yield curve, which gives the yield to maturity as a func on of the me to maturity for a zero-coupon bond.
The basis of theore cal valua ons of all interest-bearing instruments (e.g., fixed income, money market, discount instruments, swaps, etc) is the yield curve
associated with the instrument. It is composed of zero-coupon rates. When the func on cannot find an associated yield curve with corresponding rates, it looks for
the default rate of the instrument currency. The default rate of the instrument currency is typically the annually compounded risk-free rate that is used to compute
the prices of op ons. For interest-rate instruments, the corresponding yield curve must be entered.
The func on is sensi ve to the prices entered for each rate. This might appear obvious but if a price is missing, the result is zero and no extrapola on is carried out. If
the rate frequency is missing from the instrument defini on, the result is incorrect.
Characteris cs
A Curve is a composite instrument. The components are "rate" instruments. For example, the EUR yield curve contains the characteris cs of the Curve (e.g.,
interpola on rules, calendar conven ons). Each point is defined by a rate instrument (e.g., 1 month EUR rate, 6 month EUR rate, 1 year EUR rate, etc). Each rate has a
price (1 month EUR rate is quoted at 2.75% on the 23rd of March 2008, etc).
Instrument Data
The specific a ributes of curves are the following:
A ribute Descrip on
Default Flag Sets the curve as the default curve for the defined currency. You can only define
one default curve per currency.
Compounding informa on
When genera ng floa ng rate cash flows, the basic rates are some mes compounded. The
following a ributes define if and how this occurs:
Compounding Sets the type of compounding to be performed, if any (e.g. "none", Flat, etc.).
Conven on
Interpola on conven on
When compu ng rates that are in between two points of the curve, it is necessary to interpolate.
The following data defines how this is done:
A ribute Descrip on
Interpola on Sets the type of interpola on to be performed. For x1 < x <x2 the value y(x) will
Conven on be calculated as follows:
Linear flat end: A er the last point found, the rate is assumed to be
constant
Accrual Rule Day count method for interpola ng in the dates. Note that a 30 / x rule will
induce discon nui es because the 30th and 31st of a month will get the same
discount factor. To avoid this, it is recommended to use an ACT / x rule.
A ribute Descrip on
Interest Rate If the interpola on rule is spot or forward, then the type of spot rate in which to
Conven on interpolate is determined by the interest rate conven on.
Payment Indicates the payment frequency of cash flows or interest rate compounding;
Frequency currently, should be set to 1 year, except when transla ng series of zero coupon
rates into discount factors.
Payment
Frequency
Unit
The rates that make up the yield curve are contained in the instrument composi on sub-table.
It is also possible to define one yield curve with reference to another one. In this case, set the main yield curve as the parent instrument. To define a spread, use the
Margin nature in the instrument chrono of the yield curve. The margin percentage must be entered as a whole number (e.g., 2 for 2%). In this case, it is not required
to maintain the instrument composi on of the yield curve, as the composi on of the parent yield curve and the spread will be used for the calcula ons.
Remarks
Exponen al interpola on of discount factors is obtained using linear interpola on in con nuously compounded rates. In par cular:
Deliverable Instruments
The Deliverable instrument nature is a composite instrument that is designed to contain a list of deliverable bonds for bond futures contracts so that cheapest to
deliver issues and conversion factors can be automa cally computed. No func onality currently exists for this nature of instrument.
Debts
There are several ways to create debt instruments. If the debt is a fixed amount redeemed on expira on and has one or several interest payments, you can enter it
as a short posi on in a Money Market, a Discount, or a Fixed Income instrument. However, if the amount of the debt is variable (for example, it depends on the
market value of the por olio), you can create instruments with a Debt nature.
The market value of debt instruments can have one of the following characteris cs: it can either grow over me and then be paid (e.g., a management fee that at
the end of the year will be x% of the market value of the por olio increases with me), or be treated as an ini al expense that is amor sed over me (e.g., start up
costs of mutual funds that are amor sed over a given period).
It is a characteris c of debt instrument nature that you can easily include or exclude them from financial func ons using the Include / Exclude Debt checkbox in the
Domain.
Instrument Data
The following sec ons describe which data to enter and where:
Expense Accrual
Amor sa on
In the Create/Modify Instrument screen, set the Valua on Rule field to Quote = 1 from the drop-down list.
Set the Valua on Rule field to Script from the drop-down list.
Click Base Value bu on and enter a script to define the basis of the debt amount computa on.
Click Mul plier bu on and enter a script to define by what value the base value is to be mul plied to obtain the
amount of debt.
Example:
The base value is the market value of the por olio excluding Fund shares issued by the same Fund manager but
including all debts.
The mul plier is 0.2% above 1,000,000 CHF and 0.5% below.
Notes:
If the Fund module is enabled, the mul plier percentages can be stored in the accoun ng period elements and retrieved using a script keyword. The percentages
can then be recorded in a history list.
Script Valua on rule
The Script Valua on rule ini ates a complete fund valua on process to calculate its value. This means that a complete fund valua on is also performed in the
Journal and Event Genera on func ons for this purpose (if there are debts in the por olio). The simple Script Valua on rule does not start a fund valua on but
simply evaluates the script as it stands. This makes the Journal and Event Genera on func ons more efficient.
Expense Accrual
In this case, the value of the debt increases over me on a pro rata basis star ng from 0. The value of the debt is then dependent on the amount of debt, the
payment frequency, and me.
The frequency and payment dates are defined as an "Issue / Redemp on Event".
A ribute Descrip on
A ribute Descrip on
Frequency Unit
Note that there can only be one valid Debt Provision event per instrument.
Amor sa on
This case is used to gradually write off an ini al cost and is done by crea ng a posi on in an asset that offsets the ini al cost and decreases over me. The value of
the instrument depends on the amount of debt, the amor sa on period, and me.
The amor sa on periods and speed are defined in an "Issue / Redemp on Event".
A ribute Descrip on
Propor on Percentage of debt amor sed between the Begin and End Dates (normally 100%).
Note that you can define several amor sa on periods if the speed at which the debt is amor sed changes over me (e.g., 20% over the first 2 years then 80% over
the next 3 years).
Opera ons
The following sec ons describe how to enter transac ons in this instrument:
A ribute Descrip on
Quan ty As defined in the Data Entry sec on (either the debt amount or 1 if defined by
scripts).
Quote 0
A ribute Descrip on
Quan ty As defined in the Data Entry sec on (either the debt amount or 1 if defined by
scripts).
Quote 1
Valua on
Valua on
Inclusion of debts in a valua on is done by se ng the Domain parameter Include / Exclude Debt.
A ribute Descrip on
Expense The price of these debts is ini ally 0 and increases to 1 (adjusted for the payment
accrual frequency). As the posi ons are nega ve, the market value decreases over me.
Amor sa on The price of these debts is ini ally 1 and decreases to 0. As the posi ons are
posi ve, the market value decreases over me.
A ribute Descrip on
Expense These debts show regular payment schedules based on the current es ma on of
accrual the amount of debt.
Amor sa on These debts are sold at the end of the amor sa on period.
Op on Bonds
Op on Bonds are Fixed Income instruments to which one or more op ons or warrants are a ached. They are entered as composite instruments when the
components are Fixed Income instruments (typically, ex-op on bonds) and one or more op ons. The general processing is the same as that of Fixed Incomes and is
described under that nature.
Instrument Data
The following data in the main instrument table is important for this instrument nature:
A ribute Descrip on
Risk Hybrid: The risk posi ons are that of the ex-bond and the op on (underlying
Nature exposure).
You must create Exchange Events to define how conversion occurs. In par cular, the nature must specify whether the holder or the issuer decides the conversion.
A ribute Descrip on
Nature The kind of conversion, currently only op onal conversion (holder). The Issuer
op onal conversion is not processed.
New Instrument Number of new instruments received against the number of bonds defined in
Quan ty the Reference Quan ty field.
Valua on
Journal
Valua on
Generally, conver ble bonds are quoted instruments, and thus valuated by the market price plus accrued interest.
It is also possible to calculate a theore cal price by se ng the Valua on Rule to Theore cal. In this case, Conver ble Bonds are valued as the sum of the NPV of the
bond and the value of its a ached op on, priced using the Cox, Ross & Rubinstein formula. Theore cally, the value of a Conver ble Bond is Max(N*S,B). We have the
choice between N*S (value of the underlying) and B (value of the bond).
The value of the bond is computed as an NPV either using the yield curve defined at the instrument level or using the default yield curve of the reference currency.
The op on price is valued using the binomial model with the following parameters:
Underlying price adjusted by the conversion factor, underlying quan ty/bonds quan ty
Valua on computes the theore cal price, dollar dura on, dollar convexity, BPV, and Greeks (delta, gamma, theta, vega, d(vega)/d(vol)).
You can create the theore cal composi on of the Conver ble Bond (i.e., a Fixed Income instrument and one or more op ons), using the Instrument composi on
structure and se ng the Risk Nature of the instrument to “Hybrid”. In this case, the risk posi ons of the Conver ble Bond are those of the component instruments.
Journal
With the coupon characteris cs equivalent to Fixed Income instruments, the journal shows the data related to the bond, but not the possibility of conversion.
Important note: The instrument’s quote is always considered as dirty, which means that accrued interests are included in the quote.
For dirty price, price = quote / face value. The accrued interest flag of instrument must be set to N.
For clean price, price = quote/ face value – AI (accrued interests). The accrued interest flag of instrument must be set to Y.
If a conver ble bond has a Price Calcula on rule set to Quote in Unit, the effect on the business func ons is as follows:
Data Descrip on
Accrued Accrued interests are calculated only if accrued interest flag = Yes
interests
The accrued interest computed in the valua on and the opera on must also take
into account this face value. This means that the computa on is performed as
follows:
Begin date The basis depends on the accrual rule (e.g., 365 if the accrual rule is
“Actual/365”).
Data Descrip on
Incomes Event Genera on func on computes Incomes using the following formula:
quan ty * face value * interest rate.
Quan ty Strategy Reconcilia on must also take the face value into account. This means
that the quan ty is computed using the following formula:
(actual weight – objec ve weight) * por olio reference market value / (face value
* price in reference currency)
Gross Amount Clean Price * Face Value * Quan ty Dirty Price * Face Value *
Quan ty
Ref (Instrument Price * Face value * Quan ty + Instrument Price * Face value *
Market Accrued Interest) * exchange rate Quan ty * exchange rate
Value
Other Instruments
This category is used to store miscellaneous instruments that are either without value or do not share the characteris cs of the specific instruments described in this
product guide. The instruments can be purchased and sold, quoted (though not necessarily), and can have accrued interest but no income or redemp on events
(i.e., these events for this nature of instrument are ignored by the Journal and Event Genera on func ons). The Risk View depends on the Risk Nature.
Instrument Data
An FRA is a generic instrument. In other words, you can use the same instrument for any contract on the reference interest rate. Dates are specified at the opera on
level.
A ribute Descrip on
Yield The curve on which the flows are discounted to calculate the theore cal price
Curve
Underlying Must reference an underlying instrument with a Rate nature (e.g., 3-month USD
Libor). Typically, the sub-nature of the underlying instrument is MM Rate.
Price FRA
Calcula on
Rule
Opera ons
The following sec ons describe how to enter transac ons in this instrument:
A Buy opera on is used to describe the borrowing of the fixed rate defined in the opera on and the lending at the floa ng rate defined in the instrument.
A ribute Descrip on
A ribute Descrip on
Value Date Effec ve date (i.e., the date on which the lending should start)
A ribute Descrip on
Value Date Effec ve date (i.e., the date on which the lending should start)
Valua on
Journal
Analy cs
Valua on
The value of a forward rate agreement (FRA) depends on the Forward Accoun ng Flag applica on parameter FWD_ACC_FLAG. If the flag is set to 0 (False), the
posi on is valued as: quan ty * price. An offse ng cash posi on is valued. If the flag is set to 1 (True), the value of the posi on is computed as the difference
between the current price and the contractual price.
The value of an FRA is computed by first finding the forward/forward rate beginning on the se lement date. The curve used here is the one defined for the
underlying Rate instrument. Then, the future cash flows are actualised using the yield curve specified at the Instrument level or the default curve of the currency.
The pricing rou ne first finds the interpolated rates at se lement date (Value Date) and at final date (Expira on Date) according to the yield curve entered at the
instrument level, and then computes the discount factors.
The forward/forward rate is calculated and corresponds to the quote of the instrument.
The net present value corresponds to the net present value of the difference between the agreed fixed rate and the interpola on of the forward rate.
The market value of the posi on is the product of the no onal amount and the net present value.
A ribute Descrip on
Quan ty Quan ty
Redemp on 100%
Journal
An FRA is redeemed (bought or sold) on the se lement date at the se lement price.
Analy cs
You can measure the sensi vity of the risk posi ons using the DURA() and MDURA() keywords (refer to the WealthSuite Front Office - Por olio Management -
Script Language Reference Guide for more informa on).
Example
For a 3 x 6 FRA, 3-month LIBOR (meaning in 3 months for 3 months), the instrument must be created as follows:
A ribute Value
You must enter the data for opening a posi on at the opera on level: The Opera on Date is 15-06-2008, the Value Date is 15-09-2008 and the Expira on Date is
implied by the defini on of the 3-month LIBOR instrument, which is 15-12-2008.
Forex Swaps
A forex swap (or foreign exchange swap or FX swap) is an agreement to enter simultaneously into a spot foreign exchange contract and an opposite forward foreign
exchange contract at predetermined exchange rates. The agreement is expressed in basis points that are added to the spot exchange rate. Economically, a Forex
swap is equivalent to borrowing in one currency and lending in another. The swap rate represents the interest rate differen al between the two currencies.
Instrument Data
It is important to understand the meaning of "Paid" and "Received" in this context. For a purchased Forex swap:
"Paid" refers to the currency that is paid at the end of the swap.
"Received" refers to the currency that is received at the end of the swap.
A ribute Descrip on
Instrument data
Paid Leg Term structure used to discount the paid leg (if not specified, the default curve for
Yield the currency is used).
Curve
Yield Term structure used to discount the received leg (if not specified, the default curve
Curve for the currency is used).
Generic Select generic to be able to re-use the instrument. Begin Date and End Date of the
flag contract will then be set at the opera on level. For non-generic instruments, these
dates are defined at the instrument level.
Composite: the price is computed as the sum of the Net present values
of each leg, valued of their respec ve yield curves.
Theore cal: the price is computed as a pro rata of the original swap rate.
Opera on
A ribute Descrip on
Quote Set to the swap rate (i.e., the basis points to be added from the exchange rate to
obtain the forward exchange rate).
Quan ty Nominal amount (corresponds to the amount expressed in the reference received
currency).
Account Indicates the posi ve amount in the received side currency at the maturity of the
posi on. This amount is equal to the quan ty. In fact, this amount is translated into
a debit as it represents the currency paid spot.
Account 2 Indicates the nega ve amount in the paid currency at the maturity of the posi on.
This amount is equal to the quan ty in the reference currency converted by the
“spot exchange rate” and any F&Ts to be paid.
Quote Set to the swap rate (i.e., the basis points to be subtracted from the exchange rate
to obtain the forward exchange rate).
Price Set to 0.
Quan ty Nominal amount (the amount expressed in the received side currency).
Account Indicates a posi ve amount in the received side currency equal to the quan ty.
Account 2 Indicates a nega ve amount in the paid side currency. This amount is equal to the
quan ty converted by the forward exchange rate (i.e., the spot exchange rate plus
the basis points less any F&Ts due).
Reference Set to FX Swap Close and enter the Code of the opening opera on.
Nature
An income balance posi on (paid or received according to the minus / plus sign) is generated that includes the basis
differen al; that is, the nominal amount * swap rate expressed in the instrument reference currency.
This implies that the interest rate basis is a ributed to a balance posi on expressed in the paid side currency.
Sensi vity
Valua on
The posi on is valued according to the Valua on rule.
To compute the market value, the AA rou ne first computes spot and forward amounts based on the spot and forward rates (also shown on the interest rate Risk
View). The forward amounts are then discounted on their respec ve yield curve, and the discounted amounts are then converted into the currency of valua on and
ne ed.
A ribute Descrip on
Nature Discount
Redemp on 100%
Sensi vity
The sensi vity of the risk posi ons can be measured using the DURA() and MDURA() keywords. For more informa on, refer to the WealthSuite Front Office -
Por olio Management - Script Language Reference Guide.
Example
An investor buys a EUR/CHF Forex swap for 1 million EUR, se lement in 3 months. The spot exchange rate is 1.7096 and the swap rate is 0.0145 EUR (145 basis
points). The instrument currency is EUR (the currency that will be received on se lement is EUR) and the opera on currency is CHF. The exchange rate is thus quoted
as 1 CHF = n EUR. Therefore, the forward rate is 1 CHF = (1/1.7096) + 0.0145 = 0.599432 EUR (equivalent to 1 EUR = 1.668246 CHF).
A ribute Value
A ribute Value
Price 0.0145
Amount 0
Account EUR
Account 2 CHF
Account 2
A ribute Value
Quan ty 1,000,000
Quote 0
Price 0
Amount 0
Account EUR
Account 2 CHF
Account 2
A ribute Value
Exo c Op ons
There are specific instrument data for op ons. The instrument must be created with a nature set to Exo c Op on. In the instrument table, an important data field is
the sub-nature, because it determines the calcula on of the theore cal price and the treatment of the instrument other business func ons (e.g., the journal).
Chooser
Barrier
Forward Start
One-Touch Digital
Binary
Compound
Double Knock-out
Double Knock-in
Knock-In Knock-out
Chooser
A chooser op on is also called a Call-or-Put op on or As-You-Like op on: The buyer can convert from one style of op on to a different style of op on over a pre-set
period of me. During this ini al me period, the As-You-Like behaves like a straddle (a Call and a Put op on together, at the same strike) so that as the market goes
up, it acts like a Call, and as the market goes down, it acts like a Put. By the end of this ini al pre-set me period, the holder chooses whether the op on should then
be converted to either a Call or a Put for the remaining life of the op on.
Instrument Data
A ribute Descrip on
Contract Size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here.
A ribute Descrip on
Validity Date at which the event is known, usually the same as the Begin Date of the
date instrument
Underlying The instrument underlying the op on, created under its own nature
Underlying If the quan ty is not taken into account in the opera on net amount but in the
quan ty underlying exposure, it is inpu ed here instead of the contract size in the
instrument
Fix date The date when the decision must be made about whether the op on is a call or a
put. This field is mandatory.
Valua on
When valuing the op on before the Fix Date, the exo c features (i.e., the class of the op on is not yet known) are taken into
account.
A er the Fix Date, the op on is valued as a standard op on according to the specific class. If the class is s ll not specified, it
is deemed to be a call. This implies that the op on is valued as an exo c un l Fix Date included.
Vola lity is entered in the Chrono sub-table of the exo c op on or in the Chrono sub-table of the underlying instrument.
Depending on one parameter of the pricing keyword, one or the other will be used.
Strike Look-back: A Strike Look-back op on is an op on with a payoff that is calculated using the highest intrinsic value of
the underlying security or index over the life of the op on. For a Look-back Call, this would mean the lowest strike price is
used for calcula ng the Call payoff, whereas for a Look-back Put, the highest strike price is used for this calcula on. The
holder will receive the maximum possible payoff, regardless of the value of the strike price on the issue of the op on.
Instrument Data
A ribute Descrip on
Contract Size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here.
A ribute Descrip on
Underlying The instrument underlying the op on, created under its own nature.
Underlying If the quan ty is not taken into account in the opera on net amount but in the
quan ty underlying exposure, it is inpu ed here instead of the contract size in the
instrument.
Strike Mandatory for Rate Look-back but le blank for Strike Look-back given it is the
price and undefined variable.
its
currency
Op on Call or Put, this is known from the issue date of the instrument; it determines if the
class “current extreme” input in the chrono sub-table should be considered as a
minimum or a maximum.
A ribute Descrip on
Chrono Data
Look-back current extreme contains the current extreme. When the sub-nature is Rate Look-back, it represents the rate current extreme (or underlying current
extreme price); when it is Strike Look-back, it represents the strike current extreme.
Valua on
Such op ons have an unknown payoff un l a er the end of the Look-back period. Nevertheless, pricing rou ne needs the input in Chrono” of a “Look-back current
extreme” at the date of valua on. The following are possible payoffs:
Where
For Rate Look-back, physical delivery is not possible; the opera ons generated are based on cash se lement only.
At maturity, the investor will receive the difference between the strike price and the average price of the underlying as defined in the op on contract agreement.
Average Strike Asian: An Average Strike Op on is an op on with a se lement that is based on the difference between an
averaged strike and the final price of the underlying security. The dates of averaging are pre-determined over the life of the
op on.
At maturity, the investor will receive the difference between the average strike price and the price of the underlying at expira on.
Instrument Data
A ribute Descrip on
A ribute Descrip on
Contract Size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here.
A ribute Descrip on
Underlying The instrument underlying the op on, created under its own nature.
Underlying If the quan ty is not taken into account in the opera on net amount but in the
quan ty underlying exposure, it is inpu ed here instead of the contract size in the
instrument.
Strike Mandatory for Average Rate Asian but le blank for Average Strike Asian given it is
price and the undefined variable.
its
currency
Op on Call or Put, this is known from the issue date of the instrument. It determines
class whether the “Current extreme” input in the chrono sub-table should be considered
as a minimum or a maximum.
A ribute Descrip on
Physical Always set to No for Average Rate Asian because no delivery is possible. Average
delivery Strike Asian can be cash se led or have delivery features.
flag
Chrono Data
Asian current average is the current average amount. Up un l the Begin Date, it is 0.0, and in the period, it is the current average. This is not mandatory; if nothing is
inpu ed, it is considered as zero.
Valua on
Asian op ons have an unknown payoff un l a er the end of the averaging period and at expira on. The possible payoffs are:
Where
X is the strike
In a Black model type of environment, Michael Curran’s approach for average rate op ons and Bouaziz [Link]. for average strike op ons have been used. The former
allows discrete me sampling and the la er approach assumes con nuous averaging.
Average Rate Asian: The payoff depends on the mean price of the underlying during the life of the op on. The mean price is stored as “Asian Current Average” in the
chrono sub-table of the op on. Note that physical delivery is not possible.
Barrier
Barrier op on is a family of path dependent op ons, whose payoff pa ern and survival to the expira on date depend not only on the final price of the underlying
security but also on whether or not the underlying security sells at, or goes through, a predetermined barrier (in-strike, out-strike) at any point during the life of the
op on.
Barrier op ons may be either Calls or Puts; hence eight combina ons of barriers are available.
Instrument Data
A ribute Descrip on
A ribute Descrip on
Contract Size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is input here
A ribute Descrip on
Physical Is ac ve when the barrier nature is up-and-in or down-and-in, it is not relevant for
delivery OUT op ons. Furthermore, physical delivery is not allowed when the Payoff nature
flag is Binary or Asset-on; it is possible only with a Payoff nature equal to Vanilla or Gap
(see informa on about Payoff nature below).
Rebate Defines the rebate being paid if Knock-outs are knocked out or the rebate being
payoff paid for Knock-ins expires without breaching the barrier. For IN op ons, the rebate
is paid at expiry; for OUT op ons the rebate is paid when the barrier is breached (at
hit) or at expiry depending on the rebate at hit flag.
Rebate at Is True if the rebate is received when the barrier is hit, and False if the rebate is
hit flag received at expiry. For IN op ons, the rebate is paid at expiry only; for OUT op ons,
the rebate can be paid at hit or at expiry.
Season Indicates at which date the barrier was crossed. If this date is less than the
date valua on date, the op on is deemed to be knocked in or knocked out, has become
effec ve, or has disappeared.
Asset on payoff: the payoff is equal to the “scale factor” mes the
underlying price, if the underlying price is superior or equal to the strike;
it indicates an asset-or-nothing op on.
Gap payoff: the payoff is equal to underlying price minus strike minus
“gap”, if the underlying price is superior or equal to the strike.
A ribute Descrip on
Frequency Describes, for discretely monitored barrier op ons, the period between looks. For a
and con nuously monitored barrier, these fields should be le as <None>.
frequency
unit
Valua on
When valuing the op on before the season date (date when the barrier was hit), the exo c features are taken into account.
Once the season date is filled, the op on is valued as the NPV of the eventual rebate.
The following is the descrip on of the payoff of a call op on expiring in the money:
Binary Gap
When the reference date is anterior (or season date is blank), the same ra onale is applied depending on the price of the underlying rela ve to the barrier.
Forward Start
The forward start op on (or deferred strike op on or delayed start op on) allows the holder to defer the se ng of the strike price un l some future me of the
holder’s choice, up to an agreed deadline. At the point when the buyer so elects, the strike price will be fixed in rela on to the then prevailing spot price according to
a formula previously agreed as part of the terms of the op on.
Instrument Data
A ribute Descrip on
A ribute Descrip on
Contract Size If the quan ty is to be taken into account in the opera on net amount and
underlying exposure, it is inpu ed here
A ribute Descrip on
Underlying The instrument underlying the op on, created under its own nature
Underlying If the quan ty is not taken into account in the opera on net amount but in the
quan ty underlying exposure, it is inpu ed here, instead of the contract size in the
instrument.
Scale factor The factor on the spot rate at the strike fixing date (also called alpha)
Op on style European or American; this is known from the issue date of the instrument
Payoff None (not Vanilla since a Vanilla payoff needs a strike input)
nature
Valua on
When valuing the op on before the fix date, the exo c features are taken into account.
A er the fix date, the op on is valued as a standard op on according to the strike price fixed.
One-Touch Digital
A One-Touch op on, similarly called an Exploding op on, is a European-style Call spread with an early exercise price trigger a ached. This price trigger terminates
the contract and provides for se lement at the maximum value of the op on if the underlying security touches or goes through the outstrike at any me during the
life of the contract. If this trigger does not terminate the op on sooner, automa c European-style exercise occurs at expira on.
If the spot price touches or goes through the outstrike price at any me before maturity, the op on automa cally expires and the holder receives the difference
between the outstrike and the strike, mul plied by the face amount.
If the outstrike is never hit, then at expiry the op on payoff will be similar to a European-style op on payoff.
Instrument Data
A ribute Descrip on
Contract Size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here
A ribute Descrip on
A ribute Descrip on
Op on Always European
style
Barrier The cri cal level that defines whether payoff will occur.
Rebate Is True if the rebate is received when the barrier is hit, and False if the rebate is
at hit received at expiry. For IN op ons, the rebate is paid at expiry only; for OUT op ons,
flag the rebate can be paid at hit or at expiry.
Payoff Indicates the payoff of the op on. The only permi ed value is Binary.
nature
Valua on
Valua on of One-touch digital op ons is based on me-dependent barriers. One major assump on is that the barriers are flat.
Observing whether the barrier has been breached or not is con nuous during the life of the op on. Knock-in digital op ons may pay at hit or at expiry, whereas
Knock-out op ons pay only at expiry.
Journal first checks whether season date in term event sub-table has been filled. If it has, the op on posi on is reversed on season date or maturity date (depending
on the rebate at hit flag). If season date is not filled, the posi on is compared to the value of the underlying instrument to work out what could happen to the
posi on.
Binary
Binary op ons are op ons with discon nuous payoffs. A typical example of a binary op on is all or nothing. It will provide the op on buyer a payoff of “all” or
“nothing”, depending on the value of the op on at expiry. The “all” part can be the no onal amount of the op on or any other amount of cash unrelated to the
intrinsic value of the op on. In other words, the op on pays out a set amount if the underlying asset is above or below a certain specified level at the op on’s
maturity date. How far the underlying asset price is above or below the strike price is not important since the payoff will be “all” or “nothing” at the maturity date.
Instrument Data
A ribute Descrip on
Valua on rule Quoted (when prices are provided in the instrument price table)
A ribute Descrip on
Contract size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here.
A ribute Descrip on
Payoff nature Indicates the payoff of the op on. Permi ed values are:
Vanilla payoff
Asset on payoff
Gap payoff
Valua on
The following is the descrip on of the payoff of a Call op on expiring in the money:
Binary Gap
As the payoff structure should always be digital (i.e., a fixed amount is paid), the pay-off nature should be set to Binary.
The premium for a con ngent premium op on will exceed that of an ordinary op on but the premium will be paid only if the op on is in the money at expira on.
Instrument Data
A ribute Descrip on
Valua on rule Quoted (when prices are provided in the instrument price table)
Contract size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here
A ribute Descrip on
Underlying The instrument underlying the op on, created under its own nature.
Underlying If the quan ty is not taken into account in the opera on net amount but in the
quan ty underlying exposure, it is inpu ed here, instead of the contract size in the
instrument
A ribute Descrip on
Op on style European or American; this is known from the issue date of the instrument
Vanilla payoff
Con ngent The premium that is paid if the op on expiring in the money; in other words, the
premium premium is con ngent upon the op on expiring in the money
Valua on
The payoff of such op on takes into account the con ngent premium.
Compound
A Compound op on is an op on on an op on. The holder of the Compound op on has the right to purchase (or sell) another op on on a pre-set date at a pre-set
premium called the premium strike op on.
Both a compound Call and Put op ons are in the money if the premium strike is less than the valua on of the underlying op on on the compound op on’s exercise
date. On this date, the holder may choose to allow the compound op on to expire unexercised if the holder does not find the op on to be necessary or favourable.
In this case, the holder would not pay the remaining premium designated by the strike premium. If the holder decides to exercise the op on, the holder pays the
strike premium and the acquired op on will perform as a standard op on throughout its regular life.
Instrument Data
A ribute Descrip on
A ribute Descrip on
Valua on rule Quoted (when prices are provided in the instrument price table)
Contract size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here
A ribute Descrip on
Underlying Defines the data for these “op ons on op ons”. This is a case of an op on on an
instrument underlying op on on an underlying instrument. Note that the underlying op on
must be a plain Vanilla op on and expire at least at a later me.
Op on Call or Put
class
Op on European or American; this is known from the issue date of the instrument
style
Vanilla payoff
Valua on
Compound op ons have two strikes and two exercise dates. AA handles the valua on of such op ons with different structures of maturity. The Compound op on is
called the outer op on and the underlying op on is called the inner.
Double Knock-out
The op on knocks out if one of the barriers is hit during the life of the op on. Both for the upper and lower barriers, a rebate may be defined. For each rebate, one
can specify if it is paid at hit or at expiry. If the op on is not knocked out, the payoff is then defined.
Instrument Data
A ribute Descrip on
Contract size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here
A ribute Descrip on
Lower Defines the rebate being paid if the op on is knocked out by hi ng the lower
Rebate barrier. The rebate is paid when the barrier is breached (at hit) or at expiry
depending on rebate at hit flag.
Rebate at Is True if the rebate is received when the lower barrier is hit, and False if the
hit flag rebate is received at expiry.
A ribute Descrip on
Upper Defines the rebate being paid if the op on is knocked out by hi ng the upper
Rebate barrier. The rebate is paid when the barrier is breached (at hit) or at expiry
depending on upper rebate at hit flag.
Upper Is True if the rebate is received when the upper barrier is hit, and False if the
rebate at rebate is received at expiry
hit flag
Vanilla payoff
Asset on payoff
Gap payoff
Frequency Describes the period between searches for discretely monitored Double Knock-out
and op ons. For con nuously monitored Knock-out op ons, these fields should be le
frequency as <none>.
unit
Valua on
The following is the descrip on of the payoff of a Call op on expiring in the money:
Binary Gap
Double Knock-out op ons are analysed as in Broadie, Glasserman & Kou (1995).
Double Knock-out op ons lose their exo c features during their life when knocked out. Their NPV is then determined by the NPV of the upper or lower rebate,
whether the upper or lower rebate has been hit. When valuing a Knock-out, season and fix dates are first checked. If one of them is specified, NPV of rebate or upper
rebate is computed considering the flow on season/fix date, or on end date depending on the values of rebate/upper rebate at hit flags.
Double Knock-in
A class of double barrier op ons that includes two Knock-in barriers.
It is a European plain Vanilla op on with two American barriers; one barrier as regular (it can be hit when the op on moves out of the money) and one as a reverse
barrier (it can be hit when the op on moves into the money).
If at least one barrier is hit, then the payoff is the underlying Vanilla op on.
Instrument Data
A ribute Descrip on
Front Office – PM does not support theore cal pricing for this class.
Contract size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here
A ribute Descrip on
Validity date Date at which the event is known, usually the same as the Begin Date of the
instrument.
Underlying The instrument underlying the op on, created under its own nature.
Underlying If the quan ty is not taken into account in the opera on net amount but in the
quan ty underlying exposure, it is inpu ed here instead of the contract size in the
instrument.
A ribute Descrip on
Op on style European
Physical flag Indicates whether the underlying is physically delivered, or the op on posi on is
delivery cash se led. Physical delivery is allowed in this case since the Payoff nature is a
Vanilla func on.
Frequency Describes the period between searches for discretely monitored Knock-in
and barriers. For con nuously monitored barriers, these fields should be le as
frequency <none>.
unit
Valua on
The Double Knock-in is valuated with a quoted approach only.
Knock-In Knock-out
A class of double barrier op ons that mixes a Knock-in and a Knock-out barrier.
Knock-out un l expira on, which implies that the Knock-in barrier must be hit to enable the Vanilla op on, and the Knock-
out is applicable for the life me of the op on. The two barriers can be any mix of regular and reverse barriers: RKI+RKO,
RKI+KO, RKO+KI, and KI+KO.
Instrument Data
A ribute Descrip on
Front Office – PM does not support theore cal pricing for this class.
Contract size If the quan ty is taken into account in the opera on net amount and
underlying exposure, it is inpu ed here.
A ribute Descrip on
Validity date Date at which the event is known, usually the same as the Begin Date of the
instrument.
Underlying The instrument underlying the op on, created under its own nature.
Underlying If the quan ty is not taken into account in the opera on net amount but in the
quan ty underlying exposure, it is inpu ed here instead of the contract size in the
instrument.
Op on style European
A ribute Descrip on
Physical flag Indicates whether the underlying is physically delivered, or the op on posi on is
delivery cash se led. Physical delivery is allowed in this case since the Payoff nature is a
Vanilla func on.
Lower Sets the nature of the lower barrier depending on the mix RKI+RKO, RKI+KO,
Barrier RKO+KI, and KI+KO.
Nature
Upper Sets the nature of the upper barrier depending on the mix RKI+RKO, RKI+KO,
barrier RKO+KI, and KI+KO.
nature
Frequency Describes the period between searches for discretely monitored Knock-in
and barriers. For con nuously monitored barrier, these fields should be le as
frequency <none>.
unit
Valua on
The Knock-in Knock-out are valuated with quoted approach only.
Instrument Data
The op on is structured by establishing upfront two separate strike prices; one strike for each security. When the op on expires, the op on holder will receive the
difference between the maturity value on the be er performing security and its strike price in percentage terms, applied against the face amount of the contract.
The terminal payoff of these op ons is defined as maximum of: (spot instrument one – spot instrument two; 0). The basic structure is to define as an underlying a
composite instrument made up of 1 instrument one and –1 instrument two.
Otherwise all data is as a normal op on. The vola lity of each component is stored at the component level. The correla on between the two assets is stored at the
composite instrument level (instrument chronological data).
Mortgage-Backed Securi es
An asset-backed security is constructed by packaging together a group of securi es and then issuing a new security whose buyer has a claim against the cash flows
generated by the original package. This process is known as securi sa on.
The Mortgage-Backed Security (MBS) is a typical example. A firm puts together a por olio of mortgages and then sells claims against that por olio. The investor buys
a piece of that credit-risk-free mortgage por olio. Payments containing interest and principal are then due to the investor.
One of the problems with MBS is that homeowners generally hold the right to pay off their mortgages at any me. In a period of declining rates, mortgage holders
receive principal repayments earlier than planned, which leaves mortgage investors with cash flows to be invested at an interest rate lower than expected or planned
for.
Instrument Data
The following sec ons describe which data to enter and where:
Sub-nature
Mortgage Nature
Sub-nature
Mortgage passthrough: A securi sed mortgage with interest and principal paid to the investor by the servicing intermediary
shortly a er these payments are received from the borrowers.
PO (Principal Only): A por on of the underlying collateral cash flows is stripped apart to create a Principal Only type of MBS.
Investors pay a price generally deeply discounted from the face value and receive the face value through scheduled
payments and prepayments. By defini on, POs have a stated fixed interest rate of zero. The yield is mainly a func on of the
prepayment speed. Slower-than-expected prepayment speeds will have a nega ve effect on yield; conversely, faster-than-
expected prepayment speeds will have a posi ve effect on yield.
IO (Interest Only): A por on of the underlying collateral cash flows is stripped apart to create an Interest Only type of MBS.
They have no face or par value and receive no principal. IO securi es are en tled to a por on of the interest rate paid on
the en re pool of the underlying MBS. The principal amount that serves as a reference for determining the amount of
interest to be paid on an IO class is commonly referred to as the “no onal principal balance” of the IO class. The cash flow
payable to an IO class decreases as the no onal principal balance declines. As a consequence, the future cash flow
an cipated from an investment in IO securi es will decline in periods of fast prepayments (e.g., declining interest rates) and
increase in periods of slow prepayments (e.g., rising interest rate environment).
Mortgage Nature
The Mortgage nature indicates the nature of the underlying mortgages of an MBS.
Level-payment, Fixed-Rate Mortgage: The borrower pays interest and repays principal in equal instalments over an agreed-
upon period of me. Each monthly mortgage payment is due on the first of each month and is equal to:
Interest of 1/12th of the fixed annual interest rate mes the amount of the outstanding mortgage balance at the
beginning of the previous month,
Graduate Payment Mortgage (GPM): The interest rate and the terms of the mortgage are fixed. The difference here is that
the monthly mortgage payment is smaller in the ini al years than the level-payment, fixed-rate mortgage with the same
mortgage rate, but becomes larger in the final years. The terms of a GPM plan include:
Mortgage rate
Number of years over which the monthly mortgage payment will increase and when level payments will begin
Balloon/Reset Mortgage: The borrower is given long term financing by the lender but at a specified future date, the contract
is renego ated. It is equivalent to an early redemp on of the remainder of the outstanding principal. This is defined as an
event in the issue/redemp on sub-table, with the nature set at Balloon/Reset.
Prepayment rate (Chrono): the prepayment rate where the prepayment model is CPR or APR.
Swap ons
A swap on is an op on on an interest rate swap (IRS). Over-the-counter (OTC) swap ons are invariably European style but American style swap ons are possible.
A receiver swap on (a put) gives the owner of the swap on the right but not the obliga on to receive fixed interest and pay
floa ng interest for a fixed amount and tenor at a predetermined date and me.
A payer swap on (a call) gives the owner of the swap on the right but not the obliga on to pay fixed interest and receive
floa ng interest for a fixed amount and tenor at a predetermined date and me.
The pricing of swap ons reflects the poten al vola lity of future swap rates, extrapolated from less vola le future forward rates.
On expiry, the receiver swap on will be exercised when the prevailing market rate for the swap tenor held is lower than the strike of the op on owned. Similarly, a
payer swap on will be exercised when the prevailing market rate for the swap tenor held is higher than the strike of the op on owned.
Exercised swap ons may be exercised in one of two ways, physical delivery of the underlying or cash se lement.
Physical swap se lement: The buyer has the right and the writer the obliga on to effect the underlying swap. During the life
of the op on however, the circumstances of the par es to the deal may change. The op on holder may become concerned
over the possibility of default by the writer, alterna vely either party may suffer a reduc on in its credit ra ng therefore
becoming unsuitable as a swap counterparty. In these scenarios, the documenta on of the deal may provide for early cash
se lement.
Cash se lement: The calcula on basis for cash se lement on exercise is not provided in standard documenta on and must
be agreed between the par es at the me of the deal. Usually, when the op on is wri en, the par es will nominate a
number of approved reference banks. These banks will provide bid and offer rates for the underlying swap tenor; these
rates and the en re group of rates are averaged to produce a mean rate. The mean rate is compared with the strike to
determine if any cash payment is due to the op on buyer. Another procedure for cash se lement calcula on is discoun ng:
The value of fixed and floa ng payments of the underlying swap are discounted to net present value and the rate is
compared to the strike.
Instrument Data
Same as op on, except underlying is an instrument with nature swap.
Flow Instruments
Flow Instruments are defined solely by their future cash flows. Front Office – PM then values these instruments by discoun ng the future cash flows. Sensi vity
factors are also computed.
The Flow Instrument nature allows banks to handle instruments with more complex payoffs. In par cular, this type of instrument can be used to handle:
Equity Swaps
When you create your Flow Instruments, be sure to select the Flow Instrument nature.
Equity Swaps
An equity swap is defined by an interest rate condi on for the floa ng leg and an income event for the dividends es mated during the life of the contract. As the
dividend issue dates are not known, they must be forecasted.
Instrument Data
The following data must be entered in the instrument table:
Valua on rule must be set to Theore cal so that the instrument gets valuated with a theore cal price.
Enter the accrual rule for compu ng the coupon (usually Actual/365).
Income Event
Floa ng leg
An Income Event must be created for the floa ng leg. The following data is mandatory:
A ribute Descrip on
Payment Period between the last payment date and the next payment date
Frequency
Unit
A ribute Descrip on
Yield Yield curve that is used to discount the cash flows generated by the income event. If
Curve it is not specified, the default yield curve (with the same Currency as the Income
Event) is used automa cally.
Dividend leg
One Income Event per dividend must be created. The following data is mandatory:
A ribute Descrip on
Payment Period between the last payment date and the next payment date
Frequency
Unit
Yield Yield curve that is used to discount the cash flows generated by the income event. If
Curve it is not specified, the default yield curve (with the same Currency as the Income
Event) is used automa cally
A ribute Descrip on
Interest Calcula on Rule Defines if the interest rate condi on is fixed or floa ng.
Mortgage-Backed Securi es
Instrument Data
A ribute Descrip on
Valua on The value is Theore cal so that the AdAM keyword is called through the Valua on
Rule rule defined in the AA_DEF_VAL_RULE system parameter.
Income Event
An Income event must be created for the floa ng leg. The following data is mandatory:
A ribute Descrip on
Payment This data is added to the Income Event Begin Date to compute the different
Frequency payment dates.
Payment
Frequency
Unit
Yield Yield curve that is used to discount the cash flows generated by the Income Event. If
Curve it is not specified, the default yield curve with the same currency as the income
event is automa cally used.
A ribute Descrip on
Issue/Redemp on Event
An Issue/Redemp on Event must be entered for each repayment and capital increase. The following informa on is necessary:
A ribute Descrip on
Quote Redemp on quote (not used: ignore the “1” that is inserted by default).
Price Normally computed according to the Price Calcula on rule (=> 0.01 if the Price
Calcula on rule is Quote/100).
Frequency Added to the redemp on begin date to compute the different payment dates.
Frequency
Unit
Yield Yield curve that is used to discount the cash flows generated by the
Curve Issue/Redemp on Event. If it is not specified, the default yield curve in the same
currency as the Issue/Redemp on Event is automa cally used.
Examples
Equity Swap
Mortgage-Backed Securi es
Equity Swap
Formulas
[Link] Instruments Reference [Link]#_Toc33613432%3FTocPath%3DHo… 163/228
5/31/2021 Financial Instruments Reference Guide
Forward-Forward Rate Computa on
The Forward-Forward Rate Computa on uses the following formula:
Transforma on of the simple rates into compound rates in the yield curve:
rS = simple rate
n = number of days between the Ini al Date and rate maturity (e.g., 3-month rate)
Computa on of the rate at the Begin Date of the flow (linear interpola on):
where r1 = rate between the flow Begin Date and the Domain Ini al Date
rk = rate that comes just a er the flow Begin Date on the yield curve a ached to the rate
rk-1 = rate that comes just before the Begin Date of the flow on the yield curve a ached to the rate
n1 = number of days between the flow Begin Date and the Domain Ini al Date.
Computa on of the rate at the End Date of the flow (linear interpola on):
where r2 = rate between the flow payment date and Domain Ini al Date
rk = rate that comes just a er the flow payment date on the yield curve a ached to the rate
rk-1 = rate that comes just before the Begin Date of the flow on the yield curve a ached to the rate
n2 = number of days between the flow payment date and the Domain Ini al Date
where ni = number of days between the flow payment date and the Domain Ini al Date
where ni = number of days between the flow payment date and the Domain Ini al Date
Price Computa on
Discount of all generated flows using the Discount factors computed with the formula:
Where CFi = Cash Flow i = quan ty * r fwd-fwd (for the considered period)
Test Case
Flow instrument
The following images show the main data entry fields and tables for an equity swap (in this case, the FBA_BBL_Equity_Swap instrument). The first image shows a
Flow Instrument being created in the Modify Instrument screen:
You must then create four Income Events, three dividends to pay (Income To Pay nature) and a floa ng leg to receive (Income To Receive nature). Click on bu on
Income Event to open the screen:
Second dividend to pay is the same as the first dividend except for:
Third dividend to pay is the same as the first dividend except for:
The floa ng leg to receive needs the same data as the first dividend except for
Currency: CHF
You must then create an Interest Rate Condi on to define the floa ng leg:
Rate
A er you have created the Rate, you must create Prices for it. To do this, click the Price bu on at the bo om of the screen:
FBA_BBL_RATE1 prices:
Yield curve
FBA_EUR_YieldCurve and FBA_CHF_YieldCurve:
Here is the data of the two yield curves. First, the Euro yield curve:
Result in the Journal (to be compared with the preceding ExcelÔ spreadsheets)/Event Genera on
Result in the Valua on (to be compared with the preceding ExcelÔ spreadsheets)
Mortgage-Backed Securi es
Formulas
The computa on methods are iden cal to the ones described for Equity swaps (see sec on Equity Swap). The only difference is that if Issue/Redemp on Events are
defined, the quan ty on which the incomes are calculated must be computed using the following formula:
r = mortgage rate
Rn = Par al Redemp on at me n
Test Case
Flow Instrument
Next, you must create an Interest Rate Condi on to define the floa ng leg. To do this, click the Int Rate Cond bu on at the bo om of the Instrument screen and click
Create bu on:
Propor on: 40
Propor on: 10
Propor on: 50
Rate
The rate is the same as for Equity SwapRateRateRateRate.
Yield curve
The mortgage-backed security yield curve is FBA_CHF_YieldCurve:
The following illustrates the result in the Journal (to be compared with the preceding ExcelÔ spreadsheet)/Event Genera on:
Structured Products
Front Office – PM includes some features to help in the management of structured products such as a set of a ributes to record the terms and condi ons rela ve to
these products. The principle is to manage this type of product as a sub-class of a financial instrument deriving from an exis ng nature already supported.
Through this approach, the structured product can inherit the a ributes and features applicable for the instrument nature selected to host its defini on, and to
record the addi onal informa on specific for the structured product.
For the exis ng nature, an addi onal a ributes is available to classify the instrument as a structured product, and the sub-nature is extended to cover more types of
financial products that belong to the structured product class.
Therefore, the screen defini ons of Fixed Income, Conver ble Bonds, Exo c Op on, and Money Market nature include a set of a ributes and capabili es to derive
from their defini on the se ngs of different cases of structured products.
Currently, the financial library available with TAP (Simcorp) does not support structured products for financial calcula ons such as delta, dura on, alpha etc. The
values can be imported via an interface or a service call and to be stored in the Instrument Chrono table for the calcula ons to be enabled.
The following sec ons provide addi onal informa on and examples of the possibili es offered by Front Office – PM to configure structured products:
A ribute Descrip on
A ribute Descrip on
Sub-nature A large set of sub-natures is available to classify the instrument per type of
structured product. In the standard packing, the following are delivered:
Accumulator
Decumulator
Bonus Notes
Digital Investment
Tower Investment
Basket Op on
Structured Op on
Pivot Op on
Forward Forward
Fixing Date Instrument The date of underlying valua on. If different from the begin date,
this date is o en mes few days prior to the begin date.
Ini al Fixing Instrument The ini al fixing price/level of the underlying instrument (in the
Price case of Single underlying instrument) or of basket (in the case of
Term Event Average Basket.)
Exercise Instrument The strike price rela ve to the underlying instrument in the case
Quote of single underlying instrument or of the basket in the case of an
Term Event Average Basket.
The purpose is to dis nguish the strike price from the redemp on,
which is applicable to the instrument itself.
Down and In
Upper Instrument The upper side barrier applicable for the underlying instrument.
Barrier
Term Event It is calculated as Upper Barrier % * Ini al Fixing Price
Upper Instrument An alterna ve way to define an upper barrier. Sets the upper
Barrier % barrier as a percentage of the Ini al fixing price.
Term Event
It is also calculated as Upper Barrier / Ini al Fixing Price.
Rebate Up Instrument The rebate applicable when the upper barrier is breached.
Upper Instrument Specifies whether the upper rebate is paid when the barrier is
Rebate at breached or at maturity.
Hit
Accumulator
Decumulator
Digital
Short
Long
Capital Instrument The level of protec on of the capital at expira on if the underlying
Protec on instrument’s price falls below the exercise quote.
Par cipa on Instrument The level of par cipa on applicable when the price of the
Level underlying instrument is above a threshold (generally the
strike/exercise quote).
Par cipa on Instrument The level of par cipa on applicable when the price of the
Level Down underlying instrument is below a threshold (generally the
Side strike/exercise quote)
Bonus Level Instrument The price that represents the bonus applicable for the payoff if the
underlying price does not breach threshold.
Minimum Instrument The minimum payoff amount in case of digital condi ons.
Value
Maximum Instrument The maximum payoff amount in case of digital condi ons.
Value
Protected Instrument The date before which the barrier condi ons are not yet
Date enabled/applicable.
Knock-In Instrument The date on which the structured product has been knocked in (if
Date applicable.)
Knock-Out Instrument Tthe date on which the structured product has been knocked out
Date (if applicable.)
Below Instrument The date on which the structured product ended below the Strike
Exercise price (if applicable.)
Date
The instrument price can be derived from the price of the instrument in the composi on.
The risk view can process the decomposi on of the instrument according to the components.
For one instrument, of course, it requires having to eventually define several other instruments.
A ribute Descrip on
Instrument
A ribute Descrip on
Fixing The currency in which the DCI will be redeemed (either the investment
Currency currency or the alternate currency)
a term deposit that has the same defini on as the instrument above, and for a quan ty of 1.
an FX exo c op on for a quan ty that represents a ra o derived from the interest rate generated by the term deposit
A ribute Descrip on
Instrument
Nature Exo c Op on
Op on class Put
Op on Style European
The following sec ons provides examples of the usage of these a ributes. These examples demonstrate how to set structured products into Front Office – PM:
A ribute Descrip on
Instrument
Sub-nature Capital Protec on Notes (for non-coupon paying notes) or Capital Protec on
Notes with Coupon (for coupon paying notes)
Price Quote/100
Calcula on
Rule
Underlying Set the underlying category: Single Instrument; Average Basket or Worst-Of
Category Basket
Underlying In the case of single underlying instrument, references the applicable underlying
instrument to define the redeemed value to the investor at maturity.
Example: XYZ
Else (in the case of basket underlying), refer to Composi on sec on below
Exercise Strike price of the underlying instrument at maturity to define the redemp on
Quote value in the case of single underlying (else refer to Composi on sec on).
Example: $10
A ribute Descrip on
Exercise Strike price in percentage terms in the case of single underlying (else refer to
Quote % Composi on sec on)
Example: 100%
Barrier Barrier price rela ve to the Knock-out condi on in the case of single underlying
(else refer to Composi on sec on).
Example: $14. If at end date, the price is above the barrier, the investor receives
the rebate, which is $11.
Barrier % Barrier in percentage terms in the case of single underlying (else refer to
Composi on sec on)
Example: 140%
Example: 11
Capital Level of protec on of the capital at expira on if the underlying price falls below
Protec on the exercise quote.
Example: 100%. If the underlying price at maturity is 6, then the investor has
his/her capital fully protected.
Par cipa on Level of par cipa on if the price of the underlying is above the strike but below
Level the barrier.
Example: 90%. If the underlying price at maturity is 12, then the investor receives
10 + 2*90%=$11.80 per underlying unit.
Cap Level The maximum poten al profit that can be earned by the investor.
Exercise Strike price in percentage terms in the case of each underlying in a basket.
Quote %
Example: 100%
A ribute Descrip on
Example: $14
Example: 140%
Interest Rate Condi ons (not set if there is no coupon) - Refer to Interest rate condi ons sec on
in Fixed Income if coupons are set.
Opera ons
The Capital Protected Notes are bought and sold using the ‘buy’ and ‘sell’ opera ons.
The instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments and are specific contracts between the buyer and
seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and other terms and
condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
The risk posi on (view) for valua on assumes the note remains ac ve un l the end date and the view then decomposes the note into:
I. A zero coupon/ interest bearing bond posi on (capital guarantee part is handled in this posi on)
II. A posi on in the underlying instrument (Risk equivalent to a long call op on on the underlying)
Zero Coupon Bond (note without coupon)/ Interest bearing bond (note with coupon)
The bond posi on will inherit all features of the CPN and will be evaluated by a theore cal rule, using the AA_DF_BOND() keyword. The quan ty is set to the
quan ty of the posi on of the note, maturity set to the end date of the note, interest rate set to 0 (for notes without coupon) or set to interest calcula on rule (for
notes with coupon) and then the theore cal price of the bond as of the valua on date is computed.
The quan ty of the bond would include the capital protec on component of the note and the formulae is:
Underlying posi on
A new system parameter ‘RISK_STN_COST_RULE’ (similar to ‘RISK_OPT_COST_RULE’) is added and this would determine the cost price rule applicable for the
underlying of the structured notes. The possible values (default value is 2) are:
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
Underlying
Valua on
Category
If knock-out date is not null, then show the quan ty as above, with the price set to
rebate price.
Else,
Par cipa on price^^^ is calculated only when current market price >= Cost price.
Par cipa on price^^^ = Cost price + par cipa on level * (current market price –
cost price)
The other business logic is same as for the single underlying instrument except the
price is computed for each posi on in the basket.
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the CPN is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is retrieved from the underlying instrument quan ty), while the
quan ty of the worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Cash posi on
An offse ng cash posi on will be shown in the currency of the note that is calculated by using the current value of the CPN adjusted for the value of bond and the
underlying equity posi on.
The underlying posi on will be shown with the underlying quan ty * delta of the note. The delta for the CPN is given by the issuer (stored in instrument chrono
table). All other business logic (bond, underlying posi on pricing logic and cash posi on) is the same as for "Full exposure". If a delta is not available, then the result
would be the same as "Full exposure".
Journal
The Final Redemp on value of a Capital Protected Note depends on events occurring during the life me of the note or at final valua on/maturity date depending on
the op on style. These events are whether the note has been knocked out or not and whether it has ended below or above the strike price.
The system’s current date – which is the system date (SYSDATE()) -- is a key a ribute is spli ng the historical and future cashflows.
The trading day is derived from the calendar in the instrument table.
All cashflows except those of the final redemp on (e.g. coupons) will be similar to how those are generated for a simple bond (fixed income).
If the barrier has been knocked out (current date >= As of maturity date, the Final
knocked-out date). Redemp on is expected to be as:
Quote = 100
If the barrier has not been knocked out (current date As of maturity date, the Final
< knocked-out date or knocked-out date is null) and if Redemp on is expected to be as:
underlying instrument price is above strike price
(below exercise date is null) Quote = 100
If the barrier has not been knocked out (current date As of maturity date, the Final
< knocked-out date or knocked-out date is null) and if Redemp on is expected to be as:
underlying instrument price is below strike price
(below exercise date is not null) Quote = 100
At maturity, the investor does not have any guarantee to recover the fully-invested capital. The price of the underlying, at maturity, is compared with the strike to
define the redemp on value. This higher risk is compensated by a higher coupon payment during the life of the instrument compared with a fixed income that has
the same risk exposure.
In addi on, a barrier can be integrated, with the possibility to have a con nuous monitoring of the barrier during its life or at maturity only.
A ribute Descrip on
Instrument
Begin Date, Set as usual with the issue date and the maturity date
End Date
Price Quote/100
Calcula on
Rule
A ribute Descrip on
Fixed Rate The applicable coupon. It is also possible to manage it via interest rate condi on.
Example: 10%
Op on Style Used for barriers to record whether the monitoring is con nuous (American) or at
expiry (European).
Underlying The underlying instrument type: Single Instrument; Average Basket or Worst-Of
Category Basket
Underlying In the case of single underlying instrument, references the applicable underlying
instrument to define the redeemed value to the investor at maturity.
Example: XYZ
Else (in the case of basket underlying), refer to Composi on sec on below
Exercise Strike price of the underlying instrument at maturity to define the redemp on
Quote value in the case of single underlying (else refer to Composi on sec on).
Example: $10
Exercise Strike price in percentage terms in the case of single underlying (else refer to
Quote % Composi on sec on)
Example: 100%
Barrier Barrier price rela ve to the Knock-out condi on in the case of single underlying
(else refer to Composi on sec on).
Example: $8
Barrier % Barrier in percentage terms in the case of single underlying (else refer to
Composi on sec on)
Example: 80%
Par cipa on Level of par cipa on if the price of the underlying instrument is above the strike
Level but below the barrier.
Example: 90%. If the underlying price at maturity is 12, then the investor receives
10 + 2*90%=$11.80 per underlying unit.
A ribute Descrip on
Exercise Strike price in percentage terms in the case of each underlying in a basket.
Quote %
Example: 100%
Example: $8
Example: 80%
Opera ons
Reverse Conver ble Notes are bought and sold using the ‘buy’ and ‘sell’ opera ons.
The instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments and are specific contracts between the buyer and
seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and other terms and
condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
The risk posi on (view) for valua on assumes the note remains ac ve un l the end date and the view then decomposes the note into:
II. A posi on in the underlying instrument (Risk equivalent to a short put op on on the underlying)
The business logic is same as for the bond component of Capital Protec on notes with the only excep on being no capital protec on a ached to reverse
conver bles (RCN).
Underlying posi on
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
Underlying
Valua on
Category
If knock-in date is null, then show the quan ty as above, with both the price and
cost set to 0.
If knock-in date is not null and if the price of the underlying instrument is higher
than the cost price, then
If knock-in date is not null and if the price of the underlying instrument is lower or
equal to the cost price, then
If knock-in date is null, then show the quan ty as above, with both the price and
cost set to 0.
If knock-in date is not null and if the price of the average basket is higher than the
average cost price of the basket, then
If knock-in date is not null and if the price of the average basket is lower or equal to
the average cost price of the basket, then
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the RCN is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Cash posi on
An offse ng cash posi on will be shown in the currency of the note that is calculated by using the current value of the RCN adjusted for the value of bond and the
underlying posi on.
The underlying posi on will be shown with the underlying quan ty * delta of the note. The delta for the RCN is given by the issuer (stored in instrument chrono
table). All other business logic (bond, underlying posi on pricing logic and cash posi on) is the same as for "Full exposure". If a delta is not available, then the result
would be the same as "Full exposure".
Journal
The Final Redemp on value of a Reverse Conver ble Note depends on events occurring during the life me of the note or at final valua on/maturity date depending
on the op on style. These events are whether the note has been knocked in or not and whether it has ended below or above the strike price.
The system’s current date – which is the system date (SYSDATE()) -- is a key a ribute is spli ng the historical and future cashflows.
The trading day is derived from the calendar in the instrument table.
All cashflows except those of the final redemp on (e.g. coupons) will be similar to how those are generated for a simple bond (fixed income).
Quan ty = - quan ty of
posi on * (1 + min of (0 or
par cipa on level *
underlying performance)
If the barrier has not been knocked in As of maturity date, the Final Redemp on is
(current date < knocked-in date or expected to be:
knocked-in date is null)
Quote = 100
A ribute Descrip on
Instrument
Coupon Strike Level Set the instrument’s coupon strike level in amount
Coupon Strike Level (%) Set the instrument's coupon strike level in percentage
First Benchmark Date Set the observa on date of the first coupon period of the instrument
Opera ons
[Link] Instruments Reference [Link]#_Toc33613432%3FTocPath%3DHo… 188/228
5/31/2021 Financial Instruments Reference Guide
Memory Coupon Notes are bought and sold using the ‘buy’ and ‘sell’ opera ons.
The instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments. Generally, such instruments are specific contracts
between the buyer and seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and
other terms and condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
The risk posi on (view) for valua on assumes the note remains ac ve un l the end date and the view then decomposes the note into:
II. A posi on in the underlying instrument (Risk equivalent to a long call op on on the underlying)
The business logic is same as for the bond component of Capital Protec on notes with the only excep on being no capital protec on is a ached to memory coupon
notes (MCN).
Underlying posi on
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
If knock-in date is null, then show the quan ty as above, with both the price and
cost set to 0.
If knock-in date is not null and if the price of the underlying instrument is higher or
equal to the cost price, then
If knock-in date is not null and if the price of the underlying instrument is lower
than the cost price, then
If knock-in date is null, then show the quan ty as above, with both the price and
cost set to 0.
If knock-in date is not null and if the price of the average basket is higher or equal
to the average cost price of the basket, then
If knock-in date is not null and if the price of the average basket is lower than the
average cost price of the basket, then
Underlying
Valua on
Category
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the MCN is determined by the worst performing instrument. The other
instruments in the basket will be shown with price and cost set to 0 (the quan ty
of the same will not be 0 and is fetched from the underlying quan ty), while the
quan ty of the worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Cash posi on
An offse ng cash posi on will be shown in the currency of the note that is calculated by using the current value of the MCN adjusted for the value of bond and the
underlying posi on.
The underlying posi on will be shown with the underlying quan ty * delta of the note. The delta for the MCN is given by the issuer (stored in instrument chrono
table). All other business logic (bond, underlying posi on pricing logic and cash posi on) is the same as for "Full exposure". If a delta is not available, then the result
would be the same as "Full exposure".
Journal
All cashflows except those of the Income (i.e. coupons) will be similar to those of an RCN.
Income cashflows will be generated for the Memory Coupon method described in sec on Journal.
A pay out equal to the cap level if the underlying price is equal or higher than the cap level.
A pay out equal to the underlying price if the underlying price is below the cap level.
The instrument can be coupled with a barrier eventually, which will define a level of safety that guarantees a protec on if the underlying price does not fall below.
A ribute Descrip on
Instrument
Begin Set as usual with the issue date and the maturity date
Date, End
Date
A ribute Descrip on
Price Quote/100
Calcula on
Rule
Underlying Set the underlying type: Single Instrument; Average Basket or Worst-Of Basket
Category
Underlying In the case of single underlying, references the applicable underlying instrument to
define the redeemed value to the investor at maturity.
Example: XYZ
Else (in the case of basket underlying), refer to Composi on sec on below
Exercise Strike price and Discount price of the underlying instrument at maturity to define
Quote the redemp on value in the case of single underlying (else refer to Composi on
sec on).
Example: $10
Exercise Strike price in percentage terms in the case of single underlying (else refer to
Quote % Composi on sec on)
Example: 100%
Barrier Barrier price rela ve to the Knock-out condi on in the case of single underlying
(else refer to Composi on sec on). If the price does not fall below, then the pay
out is defined at the cap level; otherwise, it is at the underlying price at maturity.
Example: $7
Barrier % Barrier in percentage terms in the case of single underlying (else refer to
Composi on sec on)
Example: 70%
Barrier Defines the nature of the applicable barrier, which in this case is a down-out
Nature because it disables the protec on.
Cap Level The maximum poten al profit that can be earned by the investor. If the price of the
underlying moves up, the profit is limited by the cap.
Example: $10
A ribute Descrip on
Exercise Strike price in percentage terms in the case of each underlying in a basket.
Quote %
Example: 100%
Example: $7
Example: 70%
Depending on the condi on applied to the underlying price at maturity, the following payoff is associated:
10 11% 0%
9 11% - 10%
7 11% - 30%
4 -49% - 60%
Opera ons
Discount Cer ficates are bought and sold using the ‘buy’ and ‘sell’ opera ons.
The instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments and are specific contracts between the buyer and
seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and other terms and
condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
The risk posi on (view) for valua on assumes the cer ficate remains ac ve un l the end date and the view then decomposes the note into:
II. A posi on in the underlying instrument (Risk equivalent to a short put op on on the underlying)
Underlying posi on
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
If knock-in date is null, then show the quan ty as above, with both the price and
cost set to 0.
The other business logic is the same as for a single underlying instrument except
the price is computed for each posi on in the basket.
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the DC is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Cash posi on
An offse ng cash posi on will be shown in the currency of the cer ficate that is calculated by using the current value of the DC adjusted for the value of bond and
the underlying posi on.
The underlying posi on will be shown with the underlying quan ty * delta of the cer ficate. The delta for the DC is given by the issuer (stored in instrument chrono
table). All other business logic (bond, underlying posi on pricing logic and cash posi on) is the same as for "Full exposure". If a delta is not available, then the result
would be the same as "Full exposure".
Journal
The Final Redemp on value of a Discount Cer ficate depends on events occurring during the life me of the note or at final valua on/maturity date depending on
the op on style. These events are whether the note has been knocked in or not and whether it has ended below or above the strike price.
The system’s current date – which is the system date (SYSDATE()) -- is a key a ribute is spli ng the historical and future cashflows.
The trading day is derived from the calendar in the instrument table.
If the barrier has been knocked in (current date As of maturity date, the Final Redemp on is
>= knocked-in date). expected to be:
Quote = 100
If the barrier has not been knocked in (current As of maturity date, the Final Redemp on is
date < knocked-in date or knocked-in date is expected to be:
null)
Quote = 100
A ribute Descrip on
Instrument
Price Quote/100
Calcula on
Rule
Underlying The underlying instrument type: Single Instrument; Average Basket or Worst-Of
Category Basket
Underlying In the case of single underlying instrument, references the applicable underlying
instrument to define the redeemed value to the investor at maturity.
Example: XYZ
Else (in the case of basket underlying), refer to Composi on sec on below
Exercise Strike price of the underlying instrument at maturity to define the redemp on
Quote value in the case of single underlying (else refer to Composi on sec on).
Example: $10
A ribute Descrip on
Exercise Strike price in percentage terms in the case of single underlying instrument (else
Quote % refer to Composi on sec on)
Example: 100%
Barrier Barrier price rela ve to the Knock-out condi on in the case of single underlying
instrument (else refer to Composi on sec on).
Example: $8
Barrier % Barrier in percentage terms in the case of single underlying (else refer to
Composi on sec on)
Example: 80%
Upside Investors will receive more than their ini al investment par cipa on if the
Par cipa on underlying price is above the strike and has not breached the barrier.
Example: 100%
Downside Investors will receive more than their ini al investment par cipa on if the
Par cipa on underlying price is below the strike and has not breached the barrier.
Example: 100%
Cap Level The maximum poten al profit that can be earned by the investor.
Exercise Strike price in percentage terms in the case of each underlying in a basket.
Quote %
Example: 100%
Example: $8
Example: 80%
A ribute Descrip on
Opera ons
Twin-Win Cer ficates are bought and sold using the ‘buy’ and ‘sell’ opera ons.
The instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments and are specific contracts between the buyer and
seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and other terms and
condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
The risk posi on (view) for valua on assumes the twin-win cer ficate (TWC) remains ac ve un l the end date and the view then decomposes the cer ficate into:
II. A posi on in the underlying instrument (Risk equivalent to a long put op on on the underlying)
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
Par cipa on price^^^ is calculated only current market price >= Cost price.
Par cipa on price^^^ = Cost price + par cipa on level * (current market price –
cost price)
The other business logic is the same as for a single underlying instrument except
the price is computed for each posi on in the basket.
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the TWC is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
Cost price^^ = (If current market price >= Cost price, use cost price as per
RISK_STN_COST_RULE system parameter)
Else,
Cost price + downside par cipa on level * (cost price – current market price)
If knock-out date is not null, then show the quan ty as above, with both the price
and cost set to 0.
The other business logic is the same as for a single underlying instrument except
the price is computed for each posi on in the basket.
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the TWC is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Cash posi on
An offse ng cash posi on will be shown in the currency of the cer ficate that is calculated by using the current value of the TWC adjusted for the market values of
the underlying posi on.
The underlying posi on will be shown with the underlying quan ty * delta of the cer ficate. The delta for the TWC is given by the issuer (stored in instrument
chrono table). All other business logic (underlying posi ons pricing logic and cash posi on) is the same as for "Full exposure". If a delta is not available, then the
result would be the same as "Full exposure".
Journal
The Final Redemp on value of a Twin-Win depends on events occurring during the life me of the note or at final valua on/maturity date depending on the op on
style. These events are whether the note has been knocked out or not and whether it has ended below or above the strike price.
The system’s current date – which is the system date (SYSDATE()) -- is a key a ribute is spli ng the historical and future cashflows.
The trading day is derived from the calendar in the instrument table.
All cashflows except those of the final redemp on (e.g. coupons) will be similar to how those are generated for a simple bond (fixed income).
Quote = 100
Quan ty = -
quan ty of
posi on * ( 1+
performance
of underlying)
If the barrier has not been knocked out (current date < As of maturity date, the Final
knocked-out date or knocked-out date is null) and if Redemp on is expected to be:
underlying instrument price is above strike price (below
exercise date is null) Quote = 100
-Q * [1+min(C, P * Δ%)]
If the barrier has not been knocked out (current date < As of maturity date, the Final
knocked-out date or knocked-out date is null) and if Redemp on is expected to be:
underlying instrument price is below strike price (below
exercise date is not null) Quote = 100
-Q * [1+ABS(P(d) * Δ%)]
A ribute Descrip on
Instrument
Price Quote/100
Calcula on
Rule
A ribute Descrip on
Underlying The underlying instrument type: Single Instrument; Average Basket or Worst-Of
Category Basket
Underlying In the case of single underlying instrument, references the applicable underlying
instrument to define the redeemed value to the investor at maturity.
Example: XYZ
Else (in the case of basket underlying), refer to Composi on sec on below
Exercise Strike price of the underlying instrument at maturity to define the redemp on
Quote value in the case of single underlying (else refer to Composi on sec on).
Example: $10
Exercise Strike price in percentage terms in the case of single underlying (else refer to
Quote % Composi on sec on)
Example: 100%
Barrier Barrier price rela ve to the Knock-out condi on in the case of single underlying
(else refer to Composi on sec on).
Example: $8.
Barrier % Barrier in percentage terms in the case of single underlying (else refer to
Composi on sec on)
Example: 80%
Par cipa on Level of par cipa on if the price of the underlying instrument is above the strike
Level but below the barrier.
Example: 90%. If the underlying price at maturity is 12, then the investor receives
10 + 2*90%=$11.80 per underlying unit.
Cap Level The maximum poten al profit that can be earned by the investor.
Bonus Level Defines the applicable bonus level price for payoff if the underlying price is below
strike but does not breach the barrier.
Example: $13
$9 and the barrier is not breached, the investor receives a payoff of 13-10
due to the bonus level
$9 and the barrier is breached, the investor receives a payoff of 10-9 due
to the Knock-out effect on the bonus schema
A ribute Descrip on
Exercise Strike price in percentage terms in the case of each underlying in a basket.
Quote %
Example: 100%
Example: $8
Example: 80%
Opera ons
Bonus Notes are bought and sold using the ‘buy’ and ‘sell’ opera ons.
The instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments and are specific contracts between the buyer and
seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and other terms and
condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
The risk posi on (view) for valua on assumes the bonus notes (BN) remains ac ve un l the end date and the view then decomposes the note into:
II. A posi on in the underlying instrument (Risk equivalent to a long put op on on the underlying)
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
Par cipa on price^^^ is calculated only current market price >= Cost price.
Par cipa on price^^^ = Cost price + par cipa on level * (current market price –
cost price)
Underlying
Valua on
Category
The other business logic is the same as for a single underlying instrument except
the price is computed for each posi on in the basket.
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the BN is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
If knock-out date is not null, then show the quan ty as above, with both the price
and cost set to 0.
The other business logic is the same as for a single underlying instrument except
the price is computed for each posi on in the basket.
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the BN is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Cash posi on
An offse ng cash posi on will be shown in the currency of the note that is calculated by using the current value of the BN adjusted for the market values of the
underlying posi on.
Journal
The Final Redemp on value of a Bonus Note depends on events occurring during the life me of the note or at final valua on/maturity date depending on the op on
style. These events are whether the note has been knocked out or not and whether it has ended below or above the strike price.
The system’s current date – which is the system date (SYSDATE()) -- is a key a ribute is spli ng the historical and future cashflows.
The trading day is derived from the calendar in the instrument table.
All cashflows except those of the final redemp on (e.g. coupons) will be similar to how those are generated for a simple bond (fixed income).
Quote = 100
Quan ty = -
quan ty of
posi on * (
1+
performance
of
underlying)
If the barrier has not been knocked out (current date < As of maturity date, the Final
knocked-out date or knocked-out date is null) and if Redemp on is expected to be:
underlying instrument price is above strike price (below
exercise date is null) Quote = 100
-Q * [1+min(C, P * Δ%)]
If the barrier has not been knocked out (current date < As of maturity date, the Final
knocked-out date or knocked-out date is null) and if Redemp on is expected to be:
underlying instrument price is below strike price (below
exercise date is not null) Quote = 100
A ribute Descrip on
Instrument
A ribute Descrip on
Price Quote/100
Calcula on
Rule
Underlying Set the underlying type: Single Instrument; Average Basket or Worst-Of Basket
Category
Underlying In the case of single underlying, references the applicable underlying instrument
to define the redeemed value to the investor at maturity.
Example: XYZ
Else (in the case of basket underlying), refer to Composi on sec on below
Exercise Strike price of the underlying instrument at maturity to define the redemp on
Quote value in the case of single underlying (else refer to Composi on sec on).
Example: $10
Exercise Strike price in percentage terms in the case of single underlying (else refer to
Quote % Composi on sec on)
Example: 100%
Barrier Barrier price rela ve to the Knock-out condi on in the case of single underlying
(else refer to Composi on sec on).
Example: $8
Barrier % Barrier in percentage terms in the case of single underlying (else refer to
Composi on sec on)
Example: 80%
Par cipa on Level of par cipa on if the price of the underlying is above the strike but below
Level the barrier.
Example: 90%. If the underlying price at maturity is 12, then the investor receives
10 + 2*90%=$11.80 per underlying unit.
Cap Level The maximum poten al profit that can be earned by the investor.
A ribute Descrip on
Exercise Strike price in percentage terms in the case of each underlying in a basket.
Quote %
Example: 100%
Example: $8
Example: 80%
Opera ons
Airbag Cer ficates are bought and sold using the ‘buy’ and ‘sell’ opera ons.
The instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments. Generally, such instruments are specific contracts
between the buyer and seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and
other terms and condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
The risk posi on (view) for valua on assumes the air bag cer ficate (ABC) remains ac ve un l the end date and the view then decomposes the cer ficate into:
II. A posi on in the underlying instrument (Risk equivalent to a long call op on on the underlying)
III. A posi on in the underlying instrument (Risk equivalent to a short put op on on the underlying) with strike at airbag levels
The business logic is same as for the bond component of Capital Protec on notes with the only excep on being no capital protec on a ached to ABC.
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
Underlying
Valua on
Category
Par cipa on price^^ is calculated only current market price >= Cost price.
Par cipa on price^^ = Cost price + par cipa on level * (current market price –
cost price)
The other business logic is the same as for a single underlying instrument except
the price is computed for each posi on in the basket.
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the ABC is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
The cost price of the underlying instrument is determined using the airbag price^^
while the actual cost price^^^ is the price based on RISK_STN_COST_RULE system
parameter.
If knock-out date is not null, then show the quan ty as above, with both the price
and cost set to 0.
The other business logic is the same as for a single underlying instrument except
the price is computed for each posi on in the basket.
Underlying
Valua on
Category
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the ABC is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument.
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Cash posi on
An offse ng cash posi on will be shown in the currency of the cer ficate that is calculated by using the current value of the ABC adjusted for the market values of
the bond and underlying posi ons.
The underlying posi on will be shown with the underlying quan ty * delta of the cer ficate. The delta for the DC is given by the issuer (stored in instrument chrono
table). All other business logic (bond, underlying posi ons pricing logic and cash posi on) is the same as for "Full exposure". If a delta is not available, then the result
would be the same as "Full exposure".
Journal
The Final Redemp on value of an Airbag Cer ficates depends on events occurring during the life me of the note or at final valua on/maturity date depending on
the op on style. These events are whether the note has been knocked out or not and whether it has ended below or above the strike price.
The system’s current date – which is the system date (SYSDATE()) -- is a key a ribute is spli ng the historical and future cashflows.
The trading day is derived from the calendar in the instrument table.
All cashflows except those of the final redemp on (e.g. coupons) will be similar to how those are generated for a simple bond (fixed income).
Quan ty = - quan ty of
posi on * ( 1+ performance
of underlying)
Quote = 100
-Q * [1+min(C, P * Δ%)]
Quote = 100
-Q * [1+min(0, AM + Δ%)]
Mini-Futures (Turbos) are open-ended debt instruments that are similar to a leveraged straight long call op on (long turbo) or short call op on (short turbo)
A Discount Cer ficate may have any combina on of terms and condi ons, the most basic of which being exercise price and knock in barrier (stop loss) and leverage.
- Leverage amount of a long at-the-money call in the case of a long posi on in the Mini Futures
- Leverage amount of short at-the-money call in the case of a short posi on in the Mini Futures
A ribute Descrip on
Instrument
Price Quote/100
Calcula on
Rule
Underlying Set the underlying type: Single Instrument; Average Basket or Worst-Of Basket
Category
A ribute Descrip on
Underlying In the case of single underlying, references the applicable underlying instrument to
define the redeemed value to the investor at maturity.
Example: XYZ
Else (in the case of basket underlying), refer to Composi on sec on below
Ini al Applicable for Single underlying. This determines the pay-out of the note.
Fixing Price
Example: $10
Else (in the case of basket underlying), refer to Composi on sec on below
Exercise Strike price of the underlying instrument at maturity to define the redemp on
Quote value in the case of single underlying (else refer to Composi on sec on).
Example: $10
Exercise Strike price in percentage terms in the case of single underlying (else refer to
Quote % Composi on sec on)
Example: 100%
Lower Barrier price rela ve to the Knock-out condi on in the case of single underlying
Barrier (else refer to Composi on sec on).
Example: $14.
A ribute Descrip on
Exercise Strike price in percentage terms in the case of each underlying in a basket.
Quote %
Example: 100%
Example: $14
Example: 140%
Opera ons
Mini-Futures are bought and sold using the ‘buy’ and ‘sell’ opera ons.
The instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments. Generally, such instruments are specific contracts
between the buyer and seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and
other terms and condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
This method assumes that the value of Mini Future on the valua on date provided the stop loss is not triggered (as they can be closed at any date). If the stop loss is
triggered, the posi on is squared off.
Find the financing level^ for each instrument (for all categories) =
Mini future price for each instrument^^ = Cost price – financing level
Underlying posi on
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
Else,
The cost price for the posi on is the mini future price and the stop loss price is the
barrier price.
The other business logic is the same as for a single underlying instrument except
the price is computed for each posi on in the basket.
Underlying
Valua on
Category
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the ABC is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument. Note: If
there are 2 or more worst performing instruments, then equal weights would be
assigned to each of them.
Cash posi on
An offse ng cash posi on will be shown in the currency of the cer ficate that is calculated by using the current value of the cer ficate adjusted for the market
values of the underlying posi ons.
Underlying posi on
Based on the underlying type category (Single/ Average Basket/ Worst-of Basket), the quan ty of the underlying posi on is derived:
Underlying
Valua on
Category
Else,
The cost price for the posi on is the mini future price and the stop loss price is the
barrier price.
The other business logic is the same as for a single underlying instrument except
the price is computed for each posi on in the basket.
Worst-of There would be more than one underlying instrument and each instrument will be
Basket shown. However, there would be no weights in this basket and the risk exposure of
the ABC is determined by the worst performing instrument. The other instruments
in the basket will be shown with price and cost set to 0 (the quan ty of the same
will not be 0 and is fetched from the underlying quan ty), while the quan ty of the
worst-of instrument is determined by:
The other business logic is the same as for a single underlying instrument
Note: If there are 2 or more worst performing instruments, then equal weights
would be assigned to each of them.
Cash posi on
An offse ng cash posi on will be shown in the currency of the cer ficate that is calculated by using the current value of the cer ficate adjusted for the market
values of the underlying posi ons.
The underlying posi on will be shown with the underlying quan ty * delta of the cer ficate. The delta is given by the issuer (stored in instrument chrono table). All
other business logic (underlying posi ons pricing logic and cash posi on) is the same as for "Full exposure". If a delta is not available, then the result would be the
same as "Full exposure".
Mini-Futures have an unspecified/unknown maturity date and as such, no final redemp on cashflows are expected in the journal of liquidity.
A ribute Descrip on
Instrument (Main)
Price Quote
Calcula on
Rule Price = 1
Fixing date The first se lement date. This date is always a er the begin date and before the
end date. It must be always on a business day (of the calendar, associated with the
instrument).
Payment Sets the frequency of the se lement of the accumula on or decumula on done
Frequency (for informa on purposes only).
Example: 1 Month
Convert Used to iden fy whether Principal only or Principal + Interest are converted to the
Interest alternate currency at redemp on date.
Fixing The currency in which the investment will be redeemed at maturity; whether it is
Currency the investment currency or the alternate currency (or one of the alternate
currencies in the case of a TCI)
A ribute Descrip on
Price Price = 1
Calcula on
Rule
Nature Exo c Op on
Price Quote
Calcula on
Rule
Term Event #2
Underlying References the alternate currency of the DCI (first alternate currency of the TCI.)
Example: EUR
A ribute Descrip on
Nature Exo c Op on
Price Quote
Calcula on
Rule
Term Event #3
Example: GBP
Opera ons
DCI's and TCI's are bought and sold using the ‘buy’ and ‘sell’ opera ons.
DCI's and TCI's are valued according to their valua on rule. Typically, such instruments are either quoted or priced at 1 (similar to simple Money Market
instruments). The system parameter DCI_DEF_INSTR_VAL_RULE will be used to specify how these investments are expected to be priced.
The instrument composi on as described above reflects the risk nature of the DCI/TCI contract. The risk posi on (view) for valua on assumes the contract remains
ac ve un l the end date and the view then decomposes the contract into a posi on in the instruments in the Composi on with an offse ng cash posi on.
In risk posi on (in ‘full exposure’ view), the posi on of a DCI/ TCI will be decomposed into the following:
Posi on Amounts
Investment If the op on in DCI or one of the op ons in TCI have lower barrier level set and
Currency knock-in date is null or 0 (meaning the op on is not yet knocked-in) or knock-out
date is present (meaning op on is knocked-out) on current (Valua on) date, then
no currency posi on would be shown for the related op on,
Else
Contract size = 1
Quan ty =
Alternate
Currency
Quan ty * Price
For DCI instrument posi ons (with a single op on a ached in composi on) all amounts will be fully assigned to the single op on. For TCI posi on, the Market Value
will be equally split to the 2 linked op ons in the composi on table
The delta exposure Risk View will be similar to Risk View according to the full exposure with the excep on that the Currency op ons will be decomposed as per the
delta method instead.
Journal
At maturity date, based on the fixing date and fixing currency, TAP determines if the main instrument contract will be repaid in the investment currency or in one of
the alternate currencies.
Journal flows should be generated for any DCI/TCI instrument -- nature_e = 5 and sub_nat_e IN(85,86) -- opera ons regardless of whether and how the Composi on
(instr_compo) is defined (whether the MM and Op ons are in the composi on or not, i.e. the Core Instrument Defini on in previous sec on is sufficient.) This
requirement applies to Journal func on only (and not to Valua on func on)
As for standard money market instruments, there Journal of Liquidity will generate 2 opera ons:
Investment redeemed in investment currency Opera on 1: Final Redemp on (Sell Transac on)
(Fixing Currency equal to Reference Currency) with the following characteris cs:
OR (Fixing date a er current date)
Quan ty = Quan ty from opera on
Price/Rate = 1
Investment redeemed in alternate currency Opera on 1: Final Redemp on (Sell Transac on)
(Fixing Currency is different from Reference with the following characteris cs:
Currency) and Principal-only converted at
redemp on (Convert Interest = Principal Quan ty = Quan ty from original opera on
Only)
Price/Rate = 1
Investment redeemed in alternate currency Opera on 1: Final Redemp on (Sell Transac on)
(Fixing Currency is different from Reference with the following characteris cs:
Currency) and Principal + Interest converted
at redemp on (Convert Interest = Principal + Quan ty = Quan ty from original opera on
Interest)
Price/Rate = 1
From a structural perspec ve, Accumulators / Decumulators present a payoff similar to a set of short put / call op ons with the same strike price of an underlying
instrument, with an expira on date of each op on that matches an accumula on/ decumula on date.
This product can include addi onal condi ons such as a barrier (both upper and lower), leverage and protected date.
A ribute Descrip on
Instrument
Nature Exo c Op on
Price Quote
Valua on
Rule This price must be provided by the price history. Front Office – PM does not have
the capability to price it.
A ribute Descrip on
Fixing date Sets the first se lement date. This date is always a er the begin date and before
the end date. It must be always on a business day (of the calendar, associated with
the instrument).
Compound Sets the accumula on or decumula on frequency (for informa on purposes only).
Frequency
Example: 1 Day for a daily
Payment Sets the frequency of the se lement of the accumula on or decumula on done
Frequency (for informa on purposes only).
Example: 1 Month
Knock-in Used to capture the date (if applicable) when the instrument was knocked in (first
Date me the KI barrier was breached: either from below for Up/In or from above for
Down/In barrier types). This value is populated by the back-end and is not
calculated by TAP.
Knock-out Used to capture the date (if applicable) when the instrument was knocked out (first
Date me the KO barrier was breached: either from below for Up/Out or from above for
Down/Out barrier types). This value is populated by the back-end and is not
calculated by TAP.
Term Event
Underlying References the applicable underlying instrument to define the redeemed value to
the investor at maturity.
Example: XYZ
Underlying Sets the number of underlying instrument units to buy or sell for each accrual
Quan ty accumula on or decumula on.
Example: 25
Upper Upper barrier price rela ve to the Knock-out condi on for the accumulator and
Barrier decumulator.
A ribute Descrip on
Example: For decumulator – Down & Out. If the underlying instrument price moves
down, the decumulator is terminated.
Lower Lower barrier price rela ve to the Knock-in condi on for the accumulator and
Barrier decumulator.
Example: For decumulator - Down & In. If the underlying instrument price moves
down, the decumulator is ini ated.
Example: Leverage is 2. If one day the underlying instrument price moves below
(for accumulator) or above (for decumulator) and if underlying quan ty is 25, the
quan ty to buy or sell becomes 50=25*2.
Opera ons
The accumulator and decumulator instruments are bought and sold using the ‘buy’ and ‘sell’ opera ons.
Accumulator and decumulator instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments and are specific contracts
between the buyer and seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and
other terms and condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
Typically, the risk nature of this kind of instrument is the risk nature of the underlying instrument. The risk posi on (view) for valua on assumes the contract remains
ac ve un l the end date and the view then decomposes the contract into a posi on in the underlying instrument with an offse ng cash posi on.
In risk posi on (in ‘full exposure’ view), the underlying posi on with the underlying quan ty as the remaining quan ty ll maturity will be shown. One of the
following scenarios can occur:
If knock-out date < valua on date with valua on date = any No underlying posi on
se lement date with no protected date feature enabled in the would be shown.
contract or if the contract’s knock-in date has not occurred
before the valua on date.
If knock-out date < valua on date (ini al date in ‘valua on’ No underlying posi on
domain) with protected date feature enabled in the contract and would be shown.
protected date < valua on date.
If the valua on date is between the begin date and the end date The outstanding part of the
of the contract and if the valua on date is same as any life me of the contract is
se lement date. determined by:
Life me part = (end date –
valua on date)/ (end date –
begin date)
Remaining quan ty =
Life me part * Total quan ty
Market value = Remaining
quan ty * current market
price of the underlying
posi on
Cost price (per unit of
underlying) = exercise quote
Cost value = Remaining
quan ty * cost price
If the valua on date is between the begin date and the end date The outstanding part of the
of the contract and if the valua on date is not the same as any life me of the contract is
se lement date and knock-out date is null or knock-out date is determined by:
greater than the valua on date. Life me part = (end date -
previous se lement date)/
(end date – begin date)
If the valua on date is between the begin and the end date of The outstanding part of the
the contract and if the valua on date and knock-out date is the life me of the contract is
same which is not the same as any se lement date (with a determined by:
protected date defined). Life me part = (protected
date – previous se lement
date)/ (end date – begin
date)
If the valua on date is prior to the begin date of the contract. The outstanding part of the
life me of the contract is
determined by:
Life me part = 1
An offse ng cash posi on will be shown in the currency of the accumulator / decumulator that is calculated as the difference between the market value of posi on
as per accoun ng view minus the market value derived above in any of the scenarios.
The underlying posi on will be shown with the underlying quan ty * delta of the op on (Accumulator is equivalent to short put op on while the decumulator is
equivalent to short call op on. The delta for both the cases is not calculated by the TAP financial server and must be available in the Instrument Chrono table) as the
remaining quan ty ll maturity. All other business logic is the same as for Full exposure. If a delta is not available, then the result would be the same as "Full
exposure".
Journal
A series of se lement dates for the accumulator / decumulator which falls between the ‘Reference Date’ (inclusive) and ‘Final Date’ (inclusive) is created. The dates
are based on the fixing date (which is the first se lement date – this could be a date prior or a er the reference date) and are based on the payment frequency unit.
[Link] Instruments Reference [Link]#_Toc33613432%3FTocPath%3DHo… 219/228
5/31/2021 Financial Instruments Reference Guide
The subsequent se lement dates are created using the instrument's calendar. If there is no specific calendar linked to the instrument, then the system calendar is
used. The ‘Reference Date’ and ‘Final Date’ can be fetched from ‘Reference Date’, ‘Final Date’ a ributes of the ‘Domain – Journal’ respec vely.
If the contract has been knocked out between the ‘Reference Date’ and ‘Final Date’, then the series of dates are created un l the se lement date immediately a er
the knock-out date.
The system’s current date – which is the system date (SYSDATE()) -- is a key a ribute in spli ng the historical and future cashflows.
The trading day is derived from the calendar in the instrument table.
Accumulator: a ‘Buy’ opera on is created for the underlying instrument using the underlying instrument quan ty, gearing
(used only if the price of the underlying is below the exercise quote) and the exercise quote. The cash ou lows from this
opera on (a buy opera on results in cash ou lows – outage of cash) will be reflected on the Journal page based on the
se lement dates. Hence, the cashflows would be nega ve.
Decumulator: a ‘Sell’ opera on is created for the underlying instrument using the underlying instrument quan ty, gearing
(used only if the price of the underlying is above the exercise quote) and the exercise quote. The cash inflows from this
opera on (a sell opera on results in cash inflows – intake of cash) will be reflected on the Journal page based on the
se lement dates. Hence, the cashflows would be posi ve.
If final Date is less than the No cashflows or quan ty would be shown for this posi on.
begin date of the accumulator /
decumulator or knock-in date >
final Date or no knock-in has
occurred before the current
date.
If end Date >= final Date >= Quan ty for each trading day within a se lement period
current date > knock-in date >= star ng from the knock-in date to the current date where the
begin date > reference Date price of the underlying instrument is higher or equal to the
and no knock out event has exercise quote and for each trading day from current date to
occurred. Final Date (a) = Underlying quan ty
If end Date >= final Date >= Quan ty/ Cashflows on knock-out date = 0
current date > knock-out date >
knock-in date = begin date = Quan ty for each trading day within a se lement period from
reference date and no the knock-in date un l the knock-out date -1 where the price
protected date is defined. of the underlying is higher or equal to the exercise price (a) =
Underlying quan ty
If end date >= final date >= Quan ty on knock-out date (a) = Underlying quan ty *
current date > knock-out date > number of trading days between the protected date and the
knock-in date = begin date = knock-out date.
reference date and no
protected date is defined. Quan ty for each trading day within a se lement period from
the knock-in date un l the knock-out date -1 where the price
of the underlying is higher or equal to the exercise price (b) =
Underlying quan ty
If end date >= final date > Quan ty for each trading day within a se lement period from
reference date >= current date reference date to final date (a) = Underlying quan ty
= knock-in date >= begin date
and no knock out event has Based on the number of trading days in each se lement
occurred from begin date to period, use the quan ty from (a) and calculate the cashflows
current date. as quan ty * exercise quote. Sum the quan es and cashflows
for each se lement period.
If final date > end date >= Quan ty for each trading day within a se lement period from
reference date = knock-in date the reference date to the end date (a) = Underlying quan ty
= current date >= begin date
and no knock out event has Based on the number of trading days in each se lement
occurred from begin date to period, use the quan ty from (a) and calculate the cashflows
current date. as quan ty * exercise quote. Sum the quan es and cashflows
for each se lement period.
If final date >= end date > begin Quan ty for each trading day within a se lement period from
date >= reference date >= begin date to end date (a) = Underlying quan ty
current date and no knock-in
feature in the contract (lower Based on the number of trading days in each se lement
barrier price is null or 0). period, use the quan ty from (a) and calculate the cashflows
as quan ty * exercise quote. Sum the quan es and cashflows
for each se lement period.
If current date >= end date >= If knock-in date and knock-out dates are not between the
final date > reference date >= reference date and the final date:
begin date
Quan ty for each trading day within a se lement period from
the reference date to the final date and where the price of the
underlying instrument is higher or equal to the exercise price
(a) = Underlying quan ty
If current date >= final date >= If the knock-in date and/or the knock-out date is available and
end date > begin date >= between the reference date and the final date and no
reference date protected date is defined
TARKOs are very similar to Par cipa ng Forwards but with an addi onal feature of a Target Value, that is defined at the incep on of the contract. A target value
represents the accumulated profit in price terms. This is the maximum profit value that can be earned from the contract, i.e. when the contract reaches this value,
the remaining outstanding commitment under the contract is knocked-out.
Both contracts are defined on a pair of currencies, i.e. the buy and sell currencies, and are a combina on of 2 or 3 series of forex op ons that are defined in the
instrument composi on table:
Long Call Op on
A fixed amount of the buy currency is to be bought against the sell currency at the given strike price with a certain frequency un l a maturity date. Knock-in and
knock-outs can be defined in the op ons.
Short Put Op on
A fixed amount of the sell currency is to be sold against the buy currency at the given strike price with a certain frequency un l a maturity date. Knock-in and knock-
outs can be defined in the op ons.
Vanilla Call Op on
A fixed amount of the buy currency against the sell currency at the given strike price with a certain frequency un l a maturity date. No knock-ins or knock-outs are
defined in the op ons. This is op onal and might not be present in most of the contracts.
The following provides an example of instrument se ng to manage par cipa ng forwards / TARKOs:
A ribute Descrip on
Instrument
Nature Exo c Op on
Price Quote
Valua on
Rule This price must be provided by the price history. Front Office – PM does not have
the capability to price it.
Nature Op on
The end date of the op on will be the same or lesser than the end date
of the main contract, but greater than the begin date of the main
contract.
Underlying Underlying quan ty in the call (including Vanilla call) and put op ons. This is the
Quan ty quan ty that will be purchased at every se lement dates.
Underlying For the call op ons (long and vanilla), it is the currency bought and for the put
Currency op on, this is again the currency bought (the put is being shorted).
A ribute Descrip on
Fixing date Sets the first se lement date. This date is always a er the begin date and before
the end date. It must be always on a business day (of the calendar, associated
with the instrument).
Payment Sets the frequency of the se lement of the op ons (for informa on purposes
Frequency only).
Example: 1 Month
Knock-in Used to capture the date (if applicable) when the op on was knocked in (first
Date me the KI barrier was breached: either from below for Up/In or from above for
Down/In barrier types). This value is populated by the back-end and not
calculated by TAP.
Knock-out Used to capture the date (if applicable) when the op on was knocked out (first
Date me the KO barrier was breached: either from below for Up/Out or from above
for Down/Out barrier types). This value is populated by the back-end and not
calculated by TAP.
Pay Off Long for the long call op on, Short for the short put op on and Vanilla for the
Nature Vanilla call op on.
Upper Upper barrier price rela ve to the Knock-out condi on for the op ons.
Barrier
For TARKOs - The intrinsic profit value. This sets the top limit accumulated profit
the underlying can reach before the contract is ‘knocked out’. This check is done
weekly and once the limit is reached, the contract would expire.
Upper Upper barrier level in percentage terms. If the upper barrier price is not provided,
Barrier % this percentage has to be mul plied by the ‘Exercise Quote’ to calculate the upper
barrier price. Applicable only for par cipa ng forwards.
Upper Defines the nature of the applicable upper barrier. For the long call op on, the
Barrier nature is set to 'Up & Out' while for the short put op on, the nature is set to
Nature 'Down & Out'.
Lower Lower barrier price rela ve to the knock-in condi on for the op ons.
Barrier
Lower Lower barrier level in percentage terms. If the lower barrier price is not provided,
Barrier % this percentage has to be mul plied by the ‘Exercise Quote’ to calculate the lower
barrier price.
Barrier Defines the nature of the applicable lower barrier. For the long call op on, the
Nature nature is set to 'Up & In' while for the short put op on, the nature is set to 'Down
& In'.
Total The total quan ty to be bought (for the long call and vanilla op on) and sold (for
Quan ty the short put op on).
Opera ons
[Link] Instruments Reference [Link]#_Toc33613432%3FTocPath%3DHo… 225/228
5/31/2021 Financial Instruments Reference Guide
The par cipa ng forward and TARKO instruments are bought and sold using the ‘buy’ and ‘sell’ opera ons.
The instruments are valued according to their valua on rule. Typically, such instruments are quoted instruments. Generally, such instruments are specific contracts
between the buyer and seller. The price is quoted (fixed) by the seller of such contracts at the me of execu on and once the buyer agrees to the contract price and
other terms and condi ons of the contract, the deal is executed. Therefore, these instruments need not have a daily quote during the contract period.
Typically, the risk nature of this kind of instrument is the risk nature of the underlying currency instrument. The risk posi on (view) in valua on assumes the contract
remains ac ve un l the end date and the view decomposes the contract in a posi on in the underlying currency with an offse ng cash posi on.
In risk posi on (in ‘full exposure’ view), both the buys (including Vanilla, if applicable) and sell currency with the underlying quan ty will be shown as the remaining
quan ty ll maturity. One of the following scenarios can occur:
If the op ons in the contract have the knock-out feature (i.e. the No underlying currency
upper price is set and is not null or 0) and knock-out date < current posi on would be shown.
date = se lement date or knock-in levels (lower barrier) is not null
or 0 and knock-in date is not available.
If the op ons begin date < current date and current date < end The outstanding part of
date and current date = se lement date. the life me of each of the
op ons are determined
by:
Life me part = (end date –
valua on date)/ (end date
– begin date)
Remaining quan ty =
Life me part * Total
quan ty
Market value = Remaining
quan ty * current market
price of the underlying
currency posi on
Cost price (per currency) =
redemp on quote
Cost value = Remaining
quan ty * cost price per
currency
If the op ons begin date < current date and current date < end The outstanding part of
date and current date <> se lement date. the life me of each of the
op ons are determined
by:
Life me part = (end date –
previous se lement date)/
(end date – begin date)
If the valua on date is prior to the begin date of the contract. The outstanding part of
the life me of the contract
is determined by:
Life me part = 1
An offse ng cash posi on will be shown in the currency of the par cipa ng forward / TARKOs that is calculated as the difference between the market value of the
contract as per accoun ng view minus the market value derived above in any of the scenarios.
Journal
A series of se lement dates are created for the call (including Vanilla, if applicable) and put op ons between the ‘Reference Date’ (inclusive) and ‘Final Date’
(inclusive). This is created by using the fixing date (which is the first se lement date – this could be a date prior or a er the reference date) and based on the
payment frequency unit. The subsequent se lement dates are created using the calendar that is linked to the op ons. If there is no calendar linked to the op ons,
then the system calendar is used. The ‘Reference Date’ and ‘Final Date’ can be fetched from ‘Reference Date’, ‘Final Date’ a ributes of the ‘Domain – Journal’
respec vely.
If any of the op ons have been knocked out between the ‘Reference Date’ and ‘Final Date’, then the series of dates are created un l the preceding se lement date
a er the knock-out date.
For each se lement date, a ‘Buy’ (for the call and Vanilla op on, if applicable) is created for the currency that is to be bought using the underlying quan ty and the
exercise quote while a ‘Sell’ (for the put op on) is also created for the currency that is to be sold using the underlying quan ty (this is already adjusted with the
par cipa on levels, i.e. the no onal amount is adjusted to this extent) and the exercise quote. Since it a sell of put op on, the underlying instrument is bought. The
buy (underlying) currency is shown as posi ve cashflow while the sell (reference or exercise) currency is shown as a nega ve cashflow.
The system’s current date – which is the system date (SYSDATE()) -- is a key a ribute is spli ng the historical and future cashflows.
The trading day is derived from the calendar in the instrument table.
If the final date is less than the begin date of No cashflows or quan ty would be shown for
the op ons or the knock-in date > the final this posi on.
ate or no knock-in has occurred ll the
current date or knock-in is prior to the
reference date.
If end date >= final date >= current date > For each of the op ons:
knock-in date >= begin date > reference date
and no knock out event has occurred. Quan ty for each se lement day star ng from
the knock-in date to the final date (a) =
Underlying quan ty
If end date >= final date >= current date > For each of the op ons:
knock-out date > knock-in date = begin date =
reference date and no protected date is Quan ty for each se lement day star ng from
defined. the knock-in date to the knock-out date (a) =
Underlying quan ty
If end date >= final date > reference date >= For each of the op ons:
current date = knock-in date >= begin date
and no knock out event has occurred from Quan ty for each se lement day star ng from
begin date to current date. the reference date to the final date (a) =
Underlying quan ty
If final date > end date >= reference date = For each of the op ons:
knock-in date = current date >= begin date
and no knock out event has occurred from Quan ty for each se lement day star ng from
begin date to current date. the reference date to the end date (a) =
Underlying quan ty
If final date >= end date > begin date >= For each of the op ons:
reference date >= current date and no knock-
in feature in the contract (lower barrier price Quan ty for each se lement day star ng from
is null or 0). the begin date to the end date (a) = Underlying
quan ty
If current date >= end date >= final date > If the knock-in date and the knock-out date are
reference date >= begin date not between the reference date and the final
date:
If current date >= final date >= end date > If the knock-in date and/or the knock-out date is
begin date >= reference date available and between the reference date and
the final date: