TRS Trade Definition

Top ↑

TRS Portfolio and Trade Definitions

A TRS portfolio holds the trades whose details can be used for accrual calculations

Once a company and entity have been created, the two steps required to define a non-MTM portfolio of TRS trades are as follows:

  1. create a non-MTM portfolio; and
  2. add TRS trades.

You can then perform a system-wide search on any Trade ID.

Portfolio Example

You can use the predefined ‘ALT_INV_FUND’ portfolio, or define your own independently. This page will guide you through the process using an example: manually creating a ‘NEWTRSPORTFOLIO’ that replicates ‘ALT_INV_FUND’ with its underlying trades. For trade definition, we will use two examples: manually defining a ‘USDOIS_10Y’ IRS trade, or importing all the trades. You can download the example .CSV data import file here.

1. Creating a Non-MTM Portfolio

Under Portfolios/Portfolio List, at the portfolio list level, you can create a portfolio either manually or by importing the definition data.

Manually Creating a Non-MTM Portfolio

Creating a non-MTM portfolio
Portfolios/Non-MTM Portfolio List
Alt for image
After clicking on Add New, setting Portfolio ID = NEWTRSPORTFOLIO and Name = NEW TRS PORTFOLIO NAME, selecting NEWCOMP and NEWENT as the Company ID and Entiy ID respectively, and unselecting Shared between teams
Alt for image
After selecting Shared between teams and clicking on Save
Alt for image

Importing a Non-MTM Portfolio

To import a portfolio (or a list of portfolios), click on (import) and select the relevant portfolio list definition .CSV file. You can download the import file template here .

Field Name Description Permissible Values
Portfolio ID The ID for the portfolio (immutable) Free text  (no spaces)
Name The name of the portfolio Free text
Company ID The Company ID Any existing company
See company configuration
Entity ID The Entity ID Any existing entity
See entity configuration
Description Portfolio description Free text
Shared Between Teams Whether the portfolio will be accessible across all teams Boolean
Teams The team(s) that will have access to the portfolios
Applicable only if Shared between Teams = FALSE
Any existing team(s)
See creating a team

2. Adding TRS trades

Under Portfolios/Non-MTM Portfolio List, at the portfolio level you can add TRS trades, either manually or by importing the definition data.

Case 1: Manually Creating a Trade

To manually create a trade, click on Add New (or edit an existing one by double-clicking on the line item). You can then select the TRS trade type (e.g. ‘Shares’) and then set the various trade’s attributes.

There are two types of TRS trades in Xplain: ‘TRS Bond’ (where the underlying index is a bond) and ‘TRS Share’ (where the underlying index is an equity index or a share).

Adding a TRS trade
Portfolios/Non-MTM Portfolio List/NEWTRSPORTFOLIO
Alt for image
Case 1: After clicking on Add New and selecting 'TRS Bond'
Alt for image

Case 2: Importing a Trade

To import a trade, click on (import) and select the relevant TRS trade list definition .CSV file.

You can download the import file template here .

Case 2: After clicking on Import and selecting the relevant TRS trade list file - Versioning options
Alt for image
Case 2: After clicking on Import
Alt for image

A trade field will either be mandatory (M), optional (O), conditional (C) (i.e. mandatory upon a certain condition), optional with a default value (D) or harcoded in Xplain (H).

In addition to the generic fields that set out information about the trade, a TRS will have:

  1. Specific trade fields
  2. A funding leg (Overnight, Fixed or Ibor)
  3. A Performance Leg

A description of the funding leg’s attributes and corresponding permissible values are set out in the Portfolios and Trades Permissible Values section.

Permissible trade’s attributes will either be mandatory (M), optional (O), conditional (C) (i.e. mandatory upon a certain condition), optional with a default value (D) or harcoded in Xplain (H).

Field Name Description Permissible Values TYPE
Pay Leg Type Pay Leg Type Ibor | Overnight | Fixed | Performance M
Receive Leg Type Recieve Leg Type Dependent on trade type and other leg M
Ccy Trade 3-letter ISO 4217 currency code See Permissible Currencies M
Management Fees Management fees (with respect to the performance leg) Numeric (+ve) O
Management Fees Day Count Management fees' day count See Permissible Daycount Conventions C
Performance Leg Last Payment Withheld Performance leg last payment withheld? Boolean
Default = FALSE
D
Funding Leg Last Payment Withheld Funding leg last payment withheld? Boolean
Default = FALSE
D

Additionally to the fields applicable to trade legs defined in Portfolios and Trades Permissible Values, the following fields apply for the funding leg of a TRS.

LEG TYPE Field Name Description Permissible Values TYPE
Ibor Initial Coupon The value for the initial fixing rate used in ibor funding leg valuation Numeric O
Ibor Accrual Offset Days Leg accrual date offset (in business days) Integer (+ve)
Default = 0
D
Ibor Ibor Fixing Calendar Fixing business day calendar(s), separated by '+' Default = Leg Calendar D
Overnight Accrual Offset Days Leg accrual date offset (in business days) Integer (+ve)
Default = 0
D
Fixed Accrual Offset Days Leg accrual date offset (in business days) Integer (+ve)
Default = 0
D
Overnight Overnight Fixing Offset Days Index fixing date offset (in business days) Integer
Default = 0
D

Field Name Description Permissible Values TYPE
Notional Leg notional Numeric M
Accrual Freq Frequency of leg accrual dates See Permissible Frequencies M
Payment Freq Frequency of leg payment dates See Permissible Frequencies M
Payment Offset Days Leg payment date offset (in business days) Integer
Default = 0
D
Compounding Method Leg compounding method See Permissible Compounding Methods
Only applicable if AccrualFreq <> PaymentFreq
Default = "None"
D
Accrual Offset Days Leg accrual date offset (in business days) Integer (+ve)
Default = 0
D
TRS Index TRS index Any existing TRS index M
TRS Index Type TRS index type Hardcoded based on trade type
BOND | SHARE
H
TRS Index Fixing Offset Days Index fixing date offset (in business days) Negative Integer
Default = 0
D
TRS Index Fixing Calendar Fixing business day calendar(s), separated by "+" See Permissible Calendars D
Initial Base Index The value for the initial index used in performance leg valuation Numeric D
Dividend Payout Dividend payable for share index Numeric (+ve)
For Trade Type = ""TRS_SHARE""
Default = 0
C
Identifier Leg Identifier Leg Identifier for individual legs, must be unique O

System-wide Search on Trade ID

You can perform a system-wide search on any Trade ID by entering part of the Trade ID in the search box in the top right corner and clicking on . You can click on any result to be redirected to the selected trade.

Searching for an external Trade ID
Alt for image
Searching for a Trade ID
Alt for image

TRS Market Data
TRS Accrual Calculations - Run and Results
Introduction to Xplain
Curves
Portfolios
Data
Valuations
Data Cleansing
Preferences
Admin
Importing and Versioning
XVA Module
TRS Module