FpML® Financial product Markup Language Working Draft 30 January 2009

Version: 4.6

This version: http://www.fpml.org/spec/fpml-4-6-1-wd-1

Latest version: http://www.fpml.org/spec/fpml-4-6-1-wd-1

Previous version: http://www.fpml.org/spec/fpml-4-5-5-tr-1/

Errata for this version: http://www.fpml.org/spec/fpml-4-6-1-wd-1/html/fpml-4-6-errata.html

Build Number: 1; Document built: Tue 02/03/2009 13:33:40.81

Copyright (c) 1999 - 2009 by International Swaps and Derivatives Association, Inc.

Financial Products Markup Language is subject to the FpML® Public License.

FpML® is a registered trademark of the International Swaps and Derivatives Association, Inc.

A copy of this license is available at http://www.fpml.org/license/license.html



The FpML specifications provided are without warranty of any kind, either expressed or implied, including, without limitation, warranties that FpML, or the FpML specifications are free of defects, merchantable, fit for a particular purpose or non-infringing. The entire risk as to the quality and performance of the specifications is with you. Should any of the FpML specifications prove defective in any respect, you assume the cost of any necessary servicing or repair. Under no circumstances and under no legal theory, whether tort (including negligence), contract, or otherwise, shall ISDA, any of its members, or any distributor of documents or software containing any of the FpML specifications, or any supplier of any of such parties, be liable to you or any other person for any indirect, special, incidental, or consequential damages of any character including, without limitation, damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses, even if such party shall have been informed of the possibility of such damages.



1 INTRODUCTION AND OVERVIEW

1.1 STATUS OF THIS DOCUMENT

This is the FpML 4.6 Working Draft for review by the public and by FpML members and working groups.

The FpML Working Groups encourage reviewing organizations to provide feedback as early as possible. Comments on this document should be sent by filling in the form at the following link: http://www.fpml.org/issues. An archive of the comments is available at http://www.fpml.org/issues/

There are also asset class-specific mailing lists; you can join them at the following link:

Join a Working Group at FpML

A list of current FpML Recommendations and other technical documents can be found at

http://www.fpml.org/spec

This document has been produced as part of the FpML 4.6 activity and is part of the Standards Approval Process.

1.2 ORGANIZATION OF THE DOCUMENTATION

The FpML documentation is organized into a number of subsections.

This section provides an overview of the specification.

1.2.1 Schema Reference

These are automatically generated reference documents detailing the contents of the various sections in the FpML schema.

1.2.2 Other Documents in the Specification

1.2.3 Diagram Notation

Most diagrams in this specification come from TIBCO's XML Turbo application which is used to batch generate the pictures in the documentation. The notation follows the pattern:

  • No bubble indicates a mandatory element or attribute
  • A '?' indicates an optional element or attribute
  • A '*' indicates an occurrence of zero or many
  • A '+' indicates an occurrence of one or many
  • A '..' bubble with numbers above and below indicates specific range
  • A '1' in a bubble indicates the presence of a nested sequence or choice group
  • Diagonal lines indicate a choice group (< shape)
  • Non-diagonal lines indicate a sequence ([ shape)
  • A 'D' in a bubble indicates an attribute with a default value

images/main/BaseType.jpg

images/main/DerivedType.jpg

1.3 WORKING GROUP MEMBERS AND ACKNOWLEDGEMENTS

This document was produced by the following working groups:

1.3.1 Architecture Working Group

  • Andrew Jacobs (HandCoded Software), chair
  • Anthony B. Coates (Miley Watts)
  • Igor Dayen (Object Centric Solutions)
  • Daniel Dui (University College London)
  • Marc Gratacos (ISDA)
  • Simon Heinrich (IONA Technologies)
  • Lyteck Lynhiavu (ISDA)
  • Andrew Parry (JP Morgan Chase Bank)
  • Raj Patel (HSBC)
  • Henri Pegeron (DTCC)
  • Matthew Rawlings (JP Morgan Chase Bank)
  • John Weir (Goldman Sachs)
  • Irina Yermakova (ISDA)

1.3.2 Business Process Working Group

  • Marc Gratacos (ISDA), chair
  • John Booth (Northern Trust)
  • Marie-Paule Dumont (SWIFT)
  • Lucio Iida (Barclays Global Investors)
  • Andrew Jacobs (HandCoded)
  • Pierre Lamy (Goldman Sachs)
  • Lyteck Lynhiavu (ISDA)
  • Brian Lynn (Global Electronic Markets)
  • Francoise Massin (SWIFT)
  • Matthew Rawlings (JPMorgan)
  • Steve Ross-Talbot (Hattrick Software)
  • Christian Unger (BBH)
  • Irina Yermakova (ISDA)

1.3.3 Validation Working Group

  • Pam Field-Webber (Progress Software), chair
  • Mark Addison (Component Knowledge)
  • Jim Brous (Metro Solutions)
  • Andrew Dingwall-Smith (Message Automation)
  • Ivan Djurkin (BGI)
  • Daniel Dui (Barclays Capital and UCL)
  • Marc Gratacos (ISDA)
  • Andrew Jacobs (HandCoded Software)
  • Lyteck Lynhiavu (ISDA)
  • Christian Nentwich (Message Automation)
  • Matthew Rawlings (JPMorgan Chase)
  • Irina Yermakova (ISDA)

1.3.4 IRD Products Working Group

  • Harry McAllister (BNP Paribas), chair
  • John Aldridge (JP Morgan Chase Bank)
  • Marc Gratacos (ISDA)
  • Robert Green (DTCC)
  • Guy Gurden (Swapswire)
  • Pierre Lamy (Goldman Sachs)
  • Philippe Negri (Sungard)
  • Jamie Orme (Goldman Sachs)
  • Andrew Parry (JP Morgan Chase Bank)
  • Marty Ross-Trevor (Bank of Tokyo-Mitsubishi)
  • Marc Teichman (T-Zero)
  • Jeff Valentino (Bank of America)
  • Irina Yermakova (ISDA)

1.3.5 Credit Derivatives Working Group

  • Ben Lis (T-Zero), chair
  • Kathy Andrews (Bank of America)
  • Milla Bouklieva (Goldman Sachs)
  • Karel Engelen (ISDA)
  • Piers Evans (SwapsWire)
  • Marc Gratacos (ISDA)
  • Robert Green (DTCC)
  • Guy Gurden (SwapsWire)
  • Tony Kao (Goldman Sachs)
  • Lyteck Lynhiavu (ISDA)
  • Pierre Lamy (Goldman Sachs)
  • Anna Lukasiak (Goldman Sachs)
  • Andrew Parry (JPMorgan Chase Bank)
  • Henri Pegeron (DTCC)
  • Mark Perry (Goldman Sachs)
  • Marc Teichman (T-Zero)
  • Irina Yermakova (ISDA)
  • Shel Xu (Goldman Sachs)

1.3.6 FX Working Group

  • Rick Schumacher (Wall Street Systems), chair
  • Lee Buck (Morgan Stanley)
  • Fred Burge (JP Morgan Chase)
  • Marcello Davanzo (KPMG)
  • Alexander Ernst (RiskTrak Financial)
  • Gary Goldberg (FXPress)
  • Rahul Gupta (FXAll)
  • Lee Haines (Reuters)
  • Richard Hall (Evolution)
  • Antoine Hurstel (BNP Paribas)
  • Bruce Kenney (Mizuho Capital Markets)
  • Dan Kolner (UBS)
  • Anna Lukasiak (Goldman Sachs)
  • Tim Madeley (Cognotec)
  • Francoise Massin (SWIFT)
  • Donna McCollum (SunGard Trading Systems)
  • Ned Micelli (Reuters)
  • Justin Oglethorpe (Citigroup)
  • Hugues Planzol (BNP Paribas)
  • Frank Smith (Atriax)
  • Gavin Smith (RCP Consultants)
  • Bill Specht (Currenex)
  • Tony Spraggs (Reuters)
  • Viral Tolat (Integral)
  • Jayesh Vira (SunGard Trading Systems)

1.3.7 Equity Derivatives Working Group

Voting Members

  • Andrew Parry (JP Morgan Chase Bank), Chair
  • Jasone Brasil (State Street)
  • James Clark (Swapswire)
  • Piers Evans (Swapswire)
  • Robert Green (DTCC)
  • Guy Gurden (Swapswire)
  • Shabbir Irfani (Goldman Sachs)
  • Rajan Khorana (Citadel Group)
  • Robert Masri (DTCC)
  • Coner Mongey
  • Bin Shen (Goldman Sachs)
  • Marc Teichman (T-Zero)

Non-Voting Members

  • Takeo Asakura (Swapswire)
  • Oluwasegun Bewaji (University of Essex)
  • Jim Bonner (ML)
  • Jim Brous (Metro Solutions)
  • Karel Engelen (ISDA)
  • Philip Franz (Bank of America)
  • Steve Goswell (Barclays Global)
  • Marc Gratacos (ISDA)
  • Vinod Jain (Headstrong)
  • Lucio Iida (Barclays Global)
  • Ayesha Khanna (DTCC)
  • Philip Leach (DTCC)
  • Jianan Li (Citadel Group)
  • Gaurav Makhija (Citadel Group)
  • Mark Parris (UBS)
  • Dharmender Rai (Lehman)
  • Alicia Szybillo (DTCC)
  • Sam Twum (Blue Tawny)
  • Irina Yermakova (ISDA)

1.3.8 Commodity Derivatives Working Group

  • Owen King (Markit), co-chair
  • Hans Ellis (SWIFT), co-chair
  • Hugh Brunswick (EFETnet)
  • Esther Canosa (Goldman Sachs)
  • Alistair Cross (Goldman Sachs)
  • Piers Evans (Markit)
  • Luis Fierro (DB)
  • Jared Getz (Glencore)
  • Marc Gratacos (ISDA)
  • Raphael Iyageh (Goldman Sachs)
  • Chito Jovellanos (Forward Look)
  • Owen King (Markit)
  • Lyteck Lynhiavu (ISDA)
  • Brian Lynn (Global E-Markets)
  • Bulent Ozkan (Triple Point)
  • Ali Peera (Goldman Sachs)
  • Carrie Slagle (ICE)
  • John Solder (UBS)
  • Peter Stockman (DTCC)
  • Chuck Witter (Morgan Stanley)
  • Irina Yermakova (ISDA)

1.3.9 Syndicated Loan Working Group

  • Bhavik Katira (TenDelta), chair
  • Ellen Hefferen (LSTA)
  • Oleg Starovoitov (UBS)
  • Robert Murray (Bank of America)
  • Marc Gratacos (ISDA)
  • Derek LaSalle (JPMorgan)
  • Sreedhar Segu (DTCC)
  • Lyteck Lynhiavu (ISDA)
  • Karel Engelen (ISDA)
  • Scott MacLaughlin (Goldman Sachs)
  • Henri Pegeron (DTCC)
  • Solomon Roytshteyn (Deloitte)
  • Jeffrey Studer (JPMorgan)
  • Irina Yermakova (ISDA)
  • Derek Butler (FNF)
  • Chris Childs (DTCC)
  • Ken Katz (Misys)
  • Hans Ellis (Swift)
  • Sarah Wagner (JPMorgan FCS Corp)

1.3.10 Pricing and Risk Working Group

  • Brian Lynn (Global Electronic Markets), chair
  • Michael Di Stefano (Integrasoft)
  • Amod Dixit (Standard Chartered Bank)
  • Marc Gratacos (ISDA)
  • Mahmood Hanif (Bank of America)
  • Eugene Kagansky (JPMorgan Chase)
  • Pierre Lamy (Goldman Sachs)
  • Philippe Negri (Sungard)
  • Henrik Nilsson (TriOptima)
  • Robert Stowsky (Brookpath Partners)
  • Vlad Efroimson (Bank of America)
  • Irina Yermakova (ISDA)

1.4 FpML INTRODUCTION

The Financial Products Markup Language (FpML) is the industry standard enabling e-business activities in the field of financial derivatives and structured products. The development of the standard, controlled by ISDA (the International Swaps and Derivatives Association), will ultimately allow the electronic integration of a range of services, from electronic trading and confirmations to portfolio specification for risk analysis. All types of over-the-counter (OTC) derivatives will, over time, be incorporated into the standard.

FpML is an application of XML, an internet standard language for describing data shared between computer applications.

1.5 REQUESTED FEEDBACK

1.5.1 Loan Notices

The FpML Loan Working Group has defined support for a set of Loan Notices (Drawdown, Interest Payment, Repayment, One Off Fee, Ongoing Fee, Repayment Confirmation). The group has produced a schema representation aiming to cover the notifications in this business process, examples, and documentation. The FpML Standards Committee invites comments on these proposed materials including schemas, examples, and documentation.

1.5.2 Cash Flow Matching and Portfolio Reconciliation

The FpML Business Process Working Group has defined support for Cash Flow Matching and Portfolio Reconciliation. The group has produced a schema representation aiming to cover the messages exchanged in this business process, examples, and documentation. The FpML Standards Committee invites comments on these proposed materials including schemas, examples, and documentation.

1.5.3 nthToDefault element within IndexReferenceInformation

The Credit Derivatives Working Group has decided not to include nth-to-default support within the current Credit Default Swap Index product representation (IndexReferenceInformation complex type). The FpML Standards Committee invites comments to know whether this would be a valuable feature to support.

1.5.4 TradeAmended

As requested by some hedge funds, the new AllocationAmended message includes information about the original trade (allocation) that has been amended. This is not consistent with the existing TradeAmended message which only includes details of the amended trade. The FpML Standards Committee invites comments on this implementation approach.

1.5.5 Allocations - Collateral Information

The "short-form" representation of allocations requires independent amount information. This required information may be an issue for listed instruments. The FpML Standards Committee invites comments on this implementation approach.

1.5.6 Providing Feedback

Comments on this document should be sent by filling in the form at the following link: http://www.fpml.org/issues .

1.6 CHANGES IN THIS VERSION

1.6.1 Changes compared to FpML 4.5 Trial Recommendation 2009-01-05

  • Credit Derivatives:
    • Added support for Standard Coupon CDS:
      • Added new "StandardNorthAmericanCorporate" value to Matrix Term and Broker Confirmation Type schemes.
  • Equity Derivatives:
    • Added support for Equity Swaps on European Index underlyers:
      • Amended Equity Swap Transaction Supplement structure by adding the optional boolean elements optionalEarlyTermination and breakFundingRecovery.
      • Added a new enumeration "TypeOfIndexSwapEnum" that defines Accrual and FairValue values for each type of index swap.
      • Amended ReturnLeg structure by adding an optional element typeOfIndexSwap in order to hold the values for type of index swap.
      • Amended InterestCalculation structure by adding an optional boolean element called linearInterpolation.
    • Added support for Variance Option Transaction Supplement.
  • Syndicated Loan:
    • Amended OnGoingFeeTypeEnum enumeration, added a new value "LetterOfCreditFee" for an on-going fee charged for the issuance of a letter of credit to a named beneficiary, on behalf of the borrower against a facility.
  • FX Derivatives:
    • Added an example of how Dual Currency Deposits can be represented using the Strategy component, combining a Term Deposit and an FX Option.
  • Coding Schemes:
    • Matrix Term scheme has been updated to support.
    • Broker Confirmation Type scheme has been updated.
  • Validation Rules:
    • Syntax for validation rules has been updated based on the new validation rule specification.
  • The following issues have been resolved:
  • View PDF for details on schema changes

    View PDF for details on validation rules changes

1.6.1.1 Incompatible changes compared to FpML 4.5

None.

1.6.2 Changes compared to FpML 4.4

In addition to the changes describe above, the following additions have been implemented since FpML 4.4:

  • Business Process:
    • Amended the FeeLeg structure by adding an optional id attribute.
  • Commodity Derivatives:
    • Added support for commodity underlyer, commodity swaps, and commodity options.
  • Equity Derivatives:
    • A Bug Fixed - A FloatingRateCalculationReference type is added to reference a floating rate interest calculation from CompoundingRate's "interestLegRate" element.
    • Added support for Equity Swaps on Americas Index underlyers.
  • Interest Rate Derivatives:
    • Added NDS clause for supporting a schedule of valuation dates.
    • A Bug Fixed - Within the RelevantUnderlyingDateReference complex type, added missing an "href" attribute to be used as a pointer to a relevant underlying date.
  • Syndicated Loan:
    • Added support for Letter of Credit Balance Notice, Letter of Credit Termination Notice, Letter of Credit Issuance Notice, Rollover Notice, Letter of Credit Amendment Notice and Pricing Change Notice.
  • Shared:
    • Amended Master Agreement Type to make it more generic by separating the Master Agreement type and Master Agreement Type's version:
      • Removed version from ISDA Master Agreement Type scheme values (e.g."ISDA").
      • Created a new Master Agreement Version scheme that defines the version of the master agreement governing the transaction (e.g. "2002").
      • Within MasterAgreement type, added a second optional "masterAgreementVersion" value of type "MasterAgreementVersion" to specify the version of the generic master agreement type.
      • Added a new type "MasterAgreementVersion" that has a scheme attribute "masterAgreementVersionScheme" to specify the version of the master agreement.
  • Validation Rules:
    • Syntax for validation rules has been updated based on the new validation rule specification.
  • Coding Schemes:
    • Business Center scheme has been updated.
    • Commodity Business Calendar scheme has been added.
    • Commodity Frequency Type scheme has been added.
    • Commodity FX Type scheme has been added.
    • Commodity Market Disruption scheme has been added.
    • Commodity Market Disruption Fallback scheme has been added.
    • Commodity Quantity Frequency scheme has been added.
    • Commodity Reference Price scheme with standard description for each code (without full ISDA description) has been added.
    • Contractual Definitions scheme has been updated.
    • Day Count Fraction scheme has been updated.
    • Loan Position Change Type scheme has been added.
    • Master Agreement Type scheme has been updated.
    • Master Agreement Version scheme has been added.
    • Master Confirmation Type scheme has been updated.
    • Price Quote Units scheme has been updated.
    • Quantity Unit scheme has been added.
    • Time Zone scheme has been added.
1.6.2.1 Incompatible changes compared to FpML 4.4

None.

1.7 SCOPE

The scope of FpML 4.6 includes broadened BusinessProcess/Messaging coverage and additional product support, specifically:

1.7.1 Architecture Framework

The various Working Groups have developed FpML 4.6 within the FpML Architecture 2.2 Specification defined by the Architecture Working Group. This document defines that standards and principles on which the FpML grammatical definitions are based.

The FpML Architecture 2.2 builds upon the earlier FpML Architecture specifications and the conventions of FpML 1.02b before that. The refinement of the FpML architecture is an evolutionary process bought about by changes in the XML technology upon which it is based and the requirements of the standard as its scope expands.

1.7.2 Business Process Scope

The FpML Messaging Working Group was formed to define a messaging framework and sample messages for selected business processes. The Business Process Working Group has continued the work and additional business processes have been added. The business processes currently supported include:

  • Trade Affirmation
  • Trade Confirmation
  • Request for Quote
  • Novations
  • Terminations
  • Increases
  • Amendments
  • Allocations
  • Cash Flow Matching
  • Contract notifications to faciliate communication between asset managers and custodians.
  • Portfolio Reconciliation

To support these business processes, a number of messages have been defined. Please see the "Business Process Architecture" section for more information.

1.7.3 Validation Scope

The Validation Working Group provides semantic, or business-level validation rules for FpML 4.6. These validation rules, which are aimed at normalizing the use of elements within FpML, are issued as part of the FpML Specification in the validation section of this document.

The validation working group publishes with its releases:

  • A set of rules described in English
  • A technical description written in XQuery for each rule
  • Positive and negative test case documents for each rule
  • Non-normative reference implementations

The current specification includes a set of rules for Interest Rate Derivatives, Equity Derivatives, Credit Derivatives, Loans, FX, and for shared components. The rules for the different asset classes will be further enhanced in future versions.

1.7.4 IRD Scope

In FpML 4.6 Working Draft the following Interest Rate Derivative products are covered:

  • Single and Cross-Currency Interest Rate Swap
  • Forward Rate Agreement
  • Interest Rate Cap
  • Interest Rate Floor
  • Interest Rate Swaption (European, Bermuda and American Styles; Cash and Physical Settlement)
  • Extendible and Cancelable Interest Rate Swap Provisions
  • Mandatory and Optional Early Termination Provisions for Interest Rate Swaps
  • FX Resetable Cross-Currency Swap

1.7.5 Credit Derivatives Scope

In FpML 4.6 Working Draft the following Credit Derivative products are covered:

  • Credit Default Swap
  • Standard Coupon Credit Default Swap
  • Credit Default Swap Index
  • Tranche on Credit Default Swap Index
  • Credit Default Swap Basket
  • Credit Default Swap on a Mortgage
  • Credit Default Swap on a Loan
  • Option on Credit Default Swap
  • Credit Event Notice

1.7.6 FX Scope

In FpML 4.6 Working Draft the following FX products are covered:

  • FX Spot
  • FX Forward (including non-deliverable forwards, or NDFs)
  • FX Swap
  • FX Options (European and American; barriers, digitals, binaries, average rates; cash and physical settlement)
  • Option Strategies (multiple simple options)

In addition, support for the following money market instrument is also provided:

  • Term Deposits
  • Dual Currency Deposits combining an FX Option and a Term Deposit within a Strategy component.

1.7.7 Equity Derivative Options and Forwards Scope

The EQD Products Working Group has extended the FpML standard to cover the following Equity Derivative products

  • Broker Equity Options;
  • Long Form Equity Forwards;
  • Long Form Equity Options;
  • Short Form Equity Options represented as Transaction Supplements under ISDA Master Confirmation Agreements.

1.7.8 Return Swaps Scope

FpML provides generic Return Swaps support including "long form" Equity Swap representations, as well as Total Return Swaps. A separate product element called equitySwapTransactionSupplement supports "short form" Equity Swap Transaction Supplement.

Return-type Swaps have 1-to-many Legs, all of which must be derived from the ReturnSwapLeg type. Instances of Legs are returnLeg and interestLeg. Other Leg types may be derived from ReturnSwapLeg at will, to allow for private extensions to support whatever type of Generic Return Swap is desired.

The scope of this FpML representation for return swaps is to capture the following types of swaps that have equity-related underlyers:

  • Single stock swaps as well as basket swaps (i.e. swaps with multiple underlyers);
  • Swaps that have a different types of underlying assets (equity, index, mutual funds, exchange-traded funds, convertible bond, futures), or a combination of these;
  • 2-legged swaps with a combination of an equity leg and a funding leg, as well as swaps that either have only one leg (e.g. fully funded or zero-strike swap) or multiple equity legs (e.g. outperformance swaps);
  • Total Return Swaps, a type of swap in which one party (total return payer) transfers the total economic performance of a reference obligation to the other party (total return receiver).
  • Swaps that have specific adjustment conditions, such as execution swaps or portfolio rebalancing swaps;
  • Swaps that involve the exchange of principal cashflows;
  • Swaps that have inital and final stubs;
  • Swaps which can be represented as Transaction Supplements under ISDA Master Agreements;
  • Variance Swaps (deprecated, a separate varianceSwap product element has been created - See Variance Product Architecture)

Extraordinary Events terms have been incorporated, to take into consideration the release of the 2002 ISDA Definitions for Equity Derivatives.

Trigger swaps, in which equity risk morphs into a fixed income risk once a certain market level is reached, may be supported in a subsequent release.

1.7.9 Correlation Derivatives Scope

The Equity Derivative Working Group extended FpML to cover:

  • Correlation Swaps

1.7.10 Variance Derivatives Scope

The Equity Derivative Working Group extended FpML to cover:

  • Variance Swaps, a type of volatility swap where the payout is linear to variance rather than volatility, therefore the payout will rise at a higher rate than volatility;
  • Short Form Variance Options represented also as Transaction Supplements under ISDA Master Confirmation Agreements.

1.7.11 Dividend Derivatives Scope

The Equity Derivative Working Group extended FpML to cover:

  • Dividend Swap Transaction Supplement

1.7.12 Commodity Derivative Product Scope

The Commodities Working Group will extend the FpML standard to include trade types and products for the OTC commodities markets, following the structure and coverage of the 2005 ISDA Commodity Definitions. The following are included in version 4.3:

  • Support for commodity swaps
  • Vanilla Fixed/Floating Swaps
  • Caps and Floors
  • Natural Gas as the underlying Commodity product

Business Process is including Confirmations, Valuations, Reporting

1.7.13 Syndicated Loan Product Scope

The Syndicated Loan Business Working Group collectively decided to focus on designing one-way borrower-centric notifications. These notifications comprise most of the manual traffic that both agent banks and lenders must process on a daily basis.

The Syndicated Loan Working Group extended FpML to cover:

  • Syndicated Loan Notifications between Agent Bank and Lenders, including:
    • Facility Level Notifications
      • Scheduled Principal Repayment Notice
      • Unscheduled Mandatory and Voluntary Principal Repayment Notice
      • On-Going Fee Notice
      • One-Off Fee Notice
      • Letter of Credit Balance Notice
      • Letter of Credit Termination Notice
      • Letter of Credit Issuance Notice
      • Pricing Change Notice
      • Repayment Notice
      • Rollover Notice
    • Loan Contract Level Notifications
      • Drawdown Notice
      • Rate Set Notice
      • Interest Payment Notice
      • One-Off Fee Notice

In order to fully describe the notifications, it was necessary to design the following supporting object types, all of which are embedded within various notification types:

  • "Short-form" Product Definitions. These are summary objects which, in the future, will form the foundation for defining the 'long-form' loan product:
    • Deal Summary
    • Facility Summary
  • Loan Contract and Letter of Credit (Funded and Unfunded Loan) Definitions. These objects describe the value of outstanding loan contracts at a given point in time. The outstanding loan balance fluctuates over the life of a facility. There are two variations designed: the short-form summary and the long-form version of the loan contract:
    • Loan Contract Summary
    • Loan Contract
    • Letter of Creditt
    • L/C Summary
  • Lender Position Definitions. These objects describe the amount of a facility and loan contract that a single lender owns at a given point in time:
    • Facility Commitment Position
    • Loan Contract Position

1.7.14 Pricing and Risk Scope

The Pricing and Risk scope for FpML 4.6 Working Draft is:

Valuation and basic risk on the following products:

  • Vanilla IR Swaps (single and dual currency fix/float swaps, non-CMS/CMT)
    • Valuation reporting (trades only)
    • Market Data (Yield Curves, FX spot rates)
    • Market risk reporting (Delta Risk vs. Curve Inputs, FX exposures) for trades
  • Credit Default Swaps
    • Valuation reporting for trades
    • Market Data (ir curves, credit spread, recovery rate, probability of default)
    • Market risk reporting (risk with respect to. the above variables) for trades
  • IR Caps/Floors/ EuropeanSwaptions, and corresponding risk types
    • Valuation reporting for trades
    • Market data (volatility surfaces)
    • Market risk reporting
      • Volatility/Vega Risk
      • Convexity/Gamma Risk (applies to all products)
      • Time Decay/Theta (applies to all products)
  • Portfolio level valuation and risk
    • Valuation
    • Risk reporting

The Pricing and Risk Working Group has also provided some definitions that might be useful for other types of valuation and risk reporting.

1.8 CHARACTER ENCODING AND CHARACTER REPERTOIRE

1.8.1 Character Encoding

Producers of FpML documents intended for interchange with other parties must encode such documents using either UTF-8 or UTF-16. Consumers of FpML documents must be able to process documents encoded using UTF-8, as well as documents encoded using UTF-16. For more information, see

http://www.w3.org/TR/REC-xml#charencoding

1.8.2 Character Repertoire

Unrestricted FpML elements may use any valid XML characters. For more information, see

http://www.w3.org/TR/REC-xml#charsets

Certain elements and attributes (such as scheme URIs) are defined with more restrictive types, such as xsd:normalizedString, xsd:token, or xsd:anyURI. For these types, please see the relevant data type definition in the XML Schema datatypes specification:

http://www.w3.org/TR/xmlschema-2/

1.9 TOOLS AND VALIDATION

1.9.1 Schema and Example Validation

The schema files and examples in this document have been validated with XercesJ (v.2.2.1 and v.2.6.2) and HandCoded's Toolkit for FpML Processing (version Java 1.1 Alpha 2).

Top Next