FpML Financial product Markup Language Working Draft 12 October 2005

Version: 4.2

This version: http://www.fpml.org/spec/2005/wd-fpml-4-2-2005-10-12

Latest version: http://www.fpml.org/spec/2005/wd-fpml-4-2-2005-10-12

Previous version: http://www.fpml.org/spec/2005/wd-fpml-4-2-2005-05-04/

Errata for this version: http://www.fpml.org/spec/errata/wd-fpml-4-2-2005-10-12-errata.html

Document built: Tue 11/15/2005 16:21:25.47

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




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.



Table Of Contents

    1 Messaging Examples
        1.1 Introduction
        1.2 Example 1 - Request Trade Confirmation
        1.3 Example 2 - Trade Confirmed
        1.4 Example 3 - Portfolio Message
        1.5 Example 4 - Equity Option Increase
        1.6 Example 5 - Equity Cash Share Request Confirmation
        1.7 Example 6 - Equity Index Option Request Confirmation
        1.8 Example 7 - Equity Physical Share Request Confirmation
        1.9 Example 8 - Equity Option Partial Termination
        1.10 Example 9 - Equity Option Termination
        1.11 Example 10 - Equity Swap Partial Termination
        1.12 Example 11 - Equity Swap Full Termination
        1.13 Example 12 - Credit Default Swap Request Increase Termination
        1.14 Example 13 - Credit Default Swap Full Termination Confirmation
        1.15 Example 14 - Credit Default Swap Partial Termination Confirmation
        1.16 Example 15 - Credit Default Swap Request Amendment Confirmation
        1.17 Example 16 - FX Single Leg with multiple roles and accounts
        1.18 Example 17 - Two sided swap with multiple roles and accounts
        1.19 Example 18 - Credit Default Swap Short Form US Corporate with broker role
        1.20 Example 19 - Long-Form Allocation of a Credit Default Swap
        1.21 Example 20 - Short-Form Allocation of a Credit Default Swap
        1.22 Example 21 - Credit Event Notice
        1.23 Example 22 - Allocation Created
        1.24 Example 23 - Allocation Amendment
        1.25 Example 24 - Allocation Cancelled
        1.26 Example 25 - Request Allocation
    2 Interest Rate Derivative Examples
        2.1 Introduction
        2.2 Example 1 - Fixed/Floating Single Currency Interest Rate Swap
        2.3 Example 2 - Fixed/Floating Single Currency Interest Rate Swap with Initial Stub Period and Notional Amortization
        2.4 Example 3 - Fixed/Floating Single Currency Interest Rate Swap with Compounding, Payment Delay and Final Rate Rounding
        2.5 Example 4 - Fixed/Floating Single Currency Interest Rate Swap with Arrears Reset, Step-Up Coupon and Upfront Fee
        2.6 Example 5 - Fixed/Floating Single Currency Interest Rate Swap with Long Initial Stub and Short Final Stub
        2.7 Example 6 - Fixed/Floating Cross Currency Interest Rate Swap
        2.8 Example 7 - Fixed/Floating Overnight Interest Rate Swap (OIS)
        2.9 Example 8 - Forward Rate Agreement
        2.10 Example 9 - European Swaption, Physical Settlement, Explicit Underlying Effective Date
        2.11 Example 10 - European Swaption, Physical Settlement, Relative Underlying Effective Date
        2.12 Example 11 - European Swaption, Physical Settlement, Partial Exercise, Automatic Exercise
        2.13 Example 12 - European Swaption, Cash Settlement, Swaption Straddle
        2.14 Example 13 - European Swaption, Cash Settled, cashflows included
        2.15 Example 14 - Bermuda Swaption, Physical Settlement.
        2.16 Example 15 - American Swaption, Physical Settlement.
        2.17 Example 16 - Fixed/Floating Single Currency IRS With Mandatory Early Termination.
        2.18 Example 17 - Fixed/Floating Single Currency IRS With European Style Optional Early Termination.
        2.19 Example 18 - Fixed/Floating Single Currency IRS With Bermuda Style Optional Early Termination, Cashflows + optionalEarlyTerminationAdjustedDates.
        2.20 Example 19 - Fixed/Floating Single Currency IRS With American Style Optional Early Termination.
        2.21 Example 20 - Fixed/Floating Single Currency IRS With European Cancelable Provision.
        2.22 Example 21 - Fixed/Floating Single Currency IRS With European Extendible Provision.
        2.23 Example 22 - Interest Rate Cap
        2.24 Example 23 - Interest Rate Floor
        2.25 Example 24 - Interest Rate Collar
        2.26 Example 25 - Fixed/Floating IRS Where The Floating Stream Notional Is Reset Based On Prevailing Spot Exchange Rate
        2.27 Example 26 - Example 25 - Fixed/Floating IRS Where The Floating Stream Notional Is Reset Based On Prevailing Spot Exchange Rate - Cashflows.
        2.28 Example 27 - Inverse Floater
        2.29 Example 28 - Bullet Payments
        2.30 Example 29 - Swap with Non-Deliverable Settlement Provision
    3 Inflation Swaps Examples
        3.1 Introduction
        3.2 Example 1 - Year-on-Year
        3.3 Example 2 - Year-on-Year with Bond Reference
        3.4 Example 3 - Year-on-Year Initial Level
        3.5 Example 4 - Year-on-Year with Interpolation
        3.6 Example 5 - Zero-Coupon
    4 Credit Derivative Examples
        4.1 Credit Default Swap
             4.1.1 Example 1 - Asian Corporate, Long Form, Fixed Regular Payment Schedule
             4.1.2 Example 2 - Asian Corporate, Short Form, Fixed Regular Payment Schedule
             4.1.3 Example 3 - Australian Corporate, Long Form, Fixed Regular Payment Schedule
             4.1.4 Example 4 - Australian Corporate, Short Form, Fixed Regular Payment Schedule
             4.1.5 Example 5 - Emerging Markets Asian Corporate, Long Form, Fixed Regular Payment Schedule
             4.1.6 Example 6 - Emerging Markets European Sovereign, Long Form, Fixed Regular Payment Schedule
             4.1.7 Example 7 - European Corporate, Long Form, Fixed Regular Payment Schedule
             4.1.8 Example 8 - European Corporate, Short Form, Fixed Regular Payment Schedule
             4.1.9 Example 9 - European Sovereign, Long Form, Fixed Regular Payment Schedule
             4.1.10 Example 10 - US Corporate, Long Form, Fixed Regular Payment Schedule
             4.1.11 Example 11 - US Corporate, Short Form, Fixed Regular Payment Schedule
             4.1.12 Example 12 - Emerging Markets Asian Sovereign, Long Form, Fixed Regular Payment Schedule
             4.1.13 Example 13 - Asia Sovereign, Long Form, Fixed Regular Payment Schedule
             4.1.14 Example 14 - Emerging Markets Latin American Corporate, Long Form, Fixed Regular Payment Schedule
             4.1.15 Example 15 - Emerging Markets Latin American Sovereign, Long Form, Fixed Regular Payment Schedule
        4.2 Credit Default Swap Index
             4.2.1 Example 1 - CDX Example
             4.2.2 Example 2 - iTraxx Example
        4.3 Independent Amount
             4.3.1 Example 1 - Independent Amount
        4.4 Credit Event Notice
             4.4.1 Example 1 - Credit Event Notice
    5 Foreign Exchange Examples
        5.1 Introduction
        5.2 Example 1 - FX Spot
        5.3 Example 2 - FX Spot 'Cross' (non-base currency) with Side Rates
        5.4 Example 3 - FX Forward
        5.5 Example 4 - FX Forward with specific Settlement Instructions
        5.6 Example 5 - FX Forward identified as using standard settlement instructions
        5.7 Example 6 - FX Forward with split settlement
        5.8 Example 7 - Non-deliverable FX Forward
        5.9 Example 8 - FX Swap
        5.10 Example 9 - FX OTC Option - European exercise
        5.11 Example 10 - FX OTC Option - American exercise
        5.12 Example 11 - Non-deliverable FX OTC Option
        5.13 Example 12 - FX OTC Barrier Option
        5.14 Example 13 - FX OTC Double Barrier Option
        5.15 Example 14 - FX OTC Digital/Binary Option -- Euro Binary
        5.16 Example 15 - FX OTC Digital/Binary Option -- Euro Range Digital
        5.17 Example 16 - FX OTC Digital/Binary Option -- One-Touch
        5.18 Example 17 - FX OTC Digital/Binary Option -- No-Touch
        5.19 Example 18 - FX OTC Digital/Binary Option -- Double One-Touch
        5.20 Example 19 - FX OTC Digital/Binary Option -- Double No-Touch
        5.21 Example 20 - FX OTC Average Rate Option with Parametric Schedule
        5.22 Example 21 - FX OTC Average Rate Option with Specific Date Schedule
        5.23 Example 22 - Straddle (sample usage of Strategy)
        5.24 Example 23 - Delta Hedge (sample usage of Strategy)
        5.25 Term Deposit Example 1 - Simple Term Deposit
        5.26 Term Deposit Example 2 - Term Deposit with Settlement Instructions
    6 Equity Options Examples
        6.1 Introduction
        6.2 Example 1 - American Call Stock Long Form
        6.3 Example 2 - Calendar Spread Short Form
        6.4 Example 3 - Call or Put Spread Short Form
        6.5 Example 4 - European Call Index Long Form
        6.6 Example 5 - Asian Option Long Form
        6.7 Example 6 - Averaging In Long Form
        6.8 Example 7 - Barrier Knockout with Rebate Long Form
        6.9 Example 8 - Basket Long Form
        6.10 Example 9 - Bermuda Long Form
        6.11 Example 10 - Binary Barrier Long Form
        6.12 Example 11 - Quanto Long Form
        6.13 Example 12 - Vanilla Short Form
        6.14 Example 13 - 1996 American Call Stock
    7 Equity Swaps Examples
        7.1 Introduction
        7.2 Example 1 - Single Underlyer Execution Swap Long Form
        7.3 Example 2 - Composite Basket Swap Long Form
        7.4 Example 3 - Index Swap With a Quanto Feature Long Form
        7.5 Example 4 - Zero-strike Equity Swap
        7.6 Example 5 - Single Underlyer Swap with an Upfront Fee as well as a Brokerage Fee Long Form
        7.7 Example 6 - Single Index Long Form
        7.8 Example 7 - Single Underlyer Swap with both an Initial and a Final Stub
    8 Equity Forwards Examples
        8.1 Introduction
        8.2 Example 1 - Equity Forward Stock Long Form
    9 Variance Swaps Examples
        9.1 Introduction
        9.2 Example 1 - Variance Swap Index
        9.3 Example 2 - Variance Swap Single Stock
    10 Pricing and Risk Examples
        10.1 Use Cases/Examples
             10.1.1 Terminology:
             10.1.2 Request/Response scenarios:
                 10.1.2.1 Scenario 1 – Request Trade Value
                 10.1.2.1.1 Use Case 1 Description
                 10.1.2.2 Scenario 2 – Request Portfolio Value/Sensitivity
                 10.1.2.2.1 Use Case 2A Description
                 10.1.2.2.2 Use Case 2B Description
                 10.1.2.3 Scenario 3 – Request Sensitivity Generation
                 10.1.2.3.1 Use Case 3A Description
                 10.1.2.3.2 Use Case 3B Description
                 10.1.2.3.3 Use Case 3C Description
                 10.1.2.4 Scenario 4 – Request New Trade Impact
                 10.1.2.5 Scenario 5 – Perform Analyses
                 10.1.2.5.1 Use Case 5A Description
                 10.1.2.6 Scenario 6 – Request Pricing Inputs
             10.1.3 Notification Scenarios
                 10.1.3.1 Position Report
                 10.1.3.2 Use Case 7:
                 10.1.3.3 Use Case 8:

1 Messaging Examples

1.1 Introduction

This section contains example FpML documents for several message types. Each demonstrates how different messaging features are modeled in FpML.

The sample xml documents are available for download from the fpml.org website.

1.2 Example 1 - Request Trade Confirmation

File: msg_ex01_request_confirmation.xml

1.3 Example 2 - Trade Confirmed

File: msg_ex02_trade_confirmed.xml

1.4 Example 3 - Portfolio Message

File: msg_ex03_portfolio.xml

1.5 Example 4 - Equity Option Increase

File: msg_ex04_eqd_option_increase.xml

1.6 Example 5 - Equity Cash Share Request Confirmation

File: msg_ex05_eqd_cash_share_request_confirmation.xml

1.7 Example 6 - Equity Index Option Request Confirmation

File: msg_ex06_eqd_index_option_request_confirmation.xml

1.8 Example 7 - Equity Physical Share Request Confirmation

File: msg_ex07_eqd_physical_share_request_confirmation.xml

1.9 Example 8 - Equity Option Partial Termination

File: msg_ex08_eqd_option_partial_termination.xml

1.10 Example 9 - Equity Option Termination

File: msg_ex09_eqd_option_termination.xml

1.11 Example 10 - Equity Swap Partial Termination

File: msg_ex10_eqd_swap_partial_termination.xml

1.12 Example 11 - Equity Swap Full Termination

File: msg_ex11_eqd_swap_full_termination.xml

1.13 Example 12 - Credit Default Swap Request Increase Termination

File: msg_ex12_cd_request_increase_confirmation.xml

1.14 Example 13 - Credit Default Swap Full Termination Confirmation

File: msg_ex13_cd_request_full_termination_confirmation.xml

1.15 Example 14 - Credit Default Swap Partial Termination Confirmation

File: msg_ex14_cd_request_partial_termination_confirmation.xml

1.16 Example 15 - Credit Default Swap Request Amendment Confirmation

File: msg_ex15_cd_request_amendment_confirmation.xml

1.17 Example 16 - FX Single Leg with multiple roles and accounts

File: msg_ex16_fx_single_leg_roles_accounts.xml

1.18 Example 17 - Two sided swap with multiple roles and accounts

File: msg_ex17_two_sided_swap_roles_accounts.xml

1.19 Example 18 - Credit Default Swap Short Form US Corporate with broker role

File: msg_ex18_cds_2003_short_us_corp_broker_role.xml

This example shows how to model broker parties using the tradeSide structure instead of using the brokerPartyReference element.

1.20 Example 19 - Long-Form Allocation of a Credit Default Swap

File: msg_ex19_cds_long_form_allocation_accounts.xml

This example shows a "long-form" representation of allocations for a Credit Default Swap. This means that the block and the allocated trades have a full FpML representation.

1.21 Example 20 - Short-Form Allocation of a Credit Default Swap

File: msg_ex20_cds_short_form_allocation.xml

This example shows a "short-form" representation of allocations for a Credit Default Swap. This means that only the block trade has a full FpML representation. The allocated trades are described with parameters (percentage of notional, amount) contained in the allocations element

1.22 Example 21 - Credit Event Notice

File: msg_ex21_credit_event_notice.xml

This example shows the representation of a Credit Event Notice as FpML message. This examples is the same as cdcen_ex01_credit_event_notice_message.xml available in the cd folder.

1.23 Example 22 - Allocation Created

File: msg_ex22_cds_long_form_allocation_created.xml

This example shows an allocation being created with the AllocationCreated message. It also notes the beginning of a messaging thread between two parties.

1.24 Example 23 - Allocation Amendment

File: msg_ex23_cds_long_form_allocation_amended.xml

This example shows a change to the allocation that was created in example 22. The AllocationAmended message continues a thread between two parties.

1.25 Example 24 - Allocation Cancelled

File: msg_ex24_cds_long_form_allocation_cancelled.xml

This example shows the allocation created in example 22 being cancelled. The message thread between two parties.

1.26 Example 25 - Request Allocation

File: msg_ex25_cds_request_allocation.xml

This examples shows the usage of the RequestAllocation message and a thread between two parties.

2 Interest Rate Derivative Examples

2.1 Introduction

This section contains twenty eight example FpML trades. Each example illustrates how different product features are modeled in FpML.

Example 5 shows the defaulted 'type' attributes as part of the sample document. This illustrates the additional content model information available to a validating parser when processing an FpML document.

The sample xml document are available for download from the fpml.org website.

2.2 Example 1 - Fixed/Floating Single Currency Interest Rate Swap

File: ird_ex01_vanilla_swap.xml

On 12 December, 1994 Chase New York and Barclays Bank London enter into an ISDA swap agreement with each other. The terms of the contract are:

Note the following:

2.3 Example 2 - Fixed/Floating Single Currency Interest Rate Swap with Initial Stub Period and Notional Amortization

File: ird_ex02_stub_amort_swap.xml

The swap contract is identical to Example 1 except that there is an initial stub period and the notional amortizes.

The rate for the stub period is the linear interpolation between the 4-month and 5-month DEM-LIBOR-BBA rates.

The stub period on the floating stream runs from 16 January, 1995 to 14 June, 1995, and on the fixed stream from 16 January, 1995 to 14 December, 1995.

The notional amount is decreased by DEM 10,000,000 each year.

Note the following:

2.4 Example 3 - Fixed/Floating Single Currency Interest Rate Swap with Compounding, Payment Delay and Final Rate Rounding

File: ird_ex03_compound_swap.xml

On 25 April, 2000 Morgan Stanley Dean Witter and JPMorgan enter into an ISDA swap agreement with each other. The terms of the contract are:

Note the following:

2.5 Example 4 - Fixed/Floating Single Currency Interest Rate Swap with Arrears Reset, Step-Up Coupon and Upfront Fee

File: ird_ex04_arrears_stepup_fee_swap.xml

On 25 April, 2000 Morgan Stanley Dean Witter and JPMorgan enter into an ISDA swap agreement with each other. The terms of the contract are:

Note the following:

2.6 Example 5 - Fixed/Floating Single Currency Interest Rate Swap with Long Initial Stub and Short Final Stub

File: ird_ex05_long_stub_swap.xml

On 3 April, 2000 Chase and UBS Warburg enter into an ISDA swap agreement with each other. The terms of the contract are:

Note the following:

2.7 Example 6 - Fixed/Floating Cross Currency Interest Rate Swap

File: ird_ex06_xccy_swap.xml

On 12 December, 1994 Chase New York and Barclays Bank London enter into an ISDA cross-currency swap agreement with each other. The terms of the contract are:

Note the following:

2.8 Example 7 - Fixed/Floating Overnight Interest Rate Swap (OIS)

File: ird_ex07_ois_swap.xml

On 25 January, 2001 Citibank and Mizuho Capital enter into an ISDA swap agreement with each other. The terms of the contract are:

Note the following:

2.9 Example 8 - Forward Rate Agreement

File: ird_ex08_fra.xml

On 14 May, 1991 ABN AMRO Bank and Midland Bank enter a Forward Rate Agreement in which ABN AMRO is the seller of the notional contract amount and Midland the buyer. The terms of the contract are:

Note the following:

2.10 Example 9 - European Swaption, Physical Settlement, Explicit Underlying Effective Date

File: ird_ex09_euro_swaption_explicit.xml

On 30 August, 2000 Party buys from PartyB an option to exercise into an underlying ISDA swap. The terms of the contract are:

Note the following:

2.11 Example 10 - European Swaption, Physical Settlement, Relative Underlying Effective Date

File: ird_ex10_euro_swaption_relative.xml

On 30 August, 2000 Party buys from PartyB an option to exercise into an underlying ISDA swap. The terms of the contract are:

2.12 Example 11 - European Swaption, Physical Settlement, Partial Exercise, Automatic Exercise

File: example11_euro_swaption_partial_auto_ex.xml

On 30 August, 2000 Party buys from PartyB an option to exercise into an underlying ISDA swap. The terms of the contract are:

2.13 Example 12 - European Swaption, Cash Settlement, Swaption Straddle

File: ird_ex12_euro_swaption_straddle_cash.xml

On 30 August, 2000 Party buys from PartyB an option to exercise into an underlying ISDA swap. The terms of the contract are:

2.14 Example 13 - European Swaption, Cash Settled, cashflows included

File: ird_ex13_euro_swaption_cash_with_cfs.xml

On 30 August, 2000 Party buys from PartyB an option to exercise into an underlying ISDA swap. The terms of the contract are:

Note the following:

2.15 Example 14 - Bermuda Swaption, Physical Settlement.

File: ird_ex14_berm_swaption.xml

On 30 August, 2000 Party buys from PartyB an option to exercise into an underlying ISDA swap. The terms of the contract are:

Note the following:

2.16 Example 15 - American Swaption, Physical Settlement.

File: ird_ex15_amer_swaption.xml

On 30 August, 2000 Party buys from PartyB an option to exercise into an underlying ISDA swap. The terms of the contract are:

Note the following:

2.17 Example 16 - Fixed/Floating Single Currency IRS With Mandatory Early Termination.

File: ird_ex16_mand_term_swap.xml

On 30 August, 2000 PartyA and PartyB agree to enter into an ISDA swap with early termination provision. The terms of the contract are:

Note the following:

2.18 Example 17 - Fixed/Floating Single Currency IRS With European Style Optional Early Termination.

File: ird_ex17_opt_euro_term_swap.xml

On 30 August, 2000 PartyA and PartyB agree to enter into an ISDA swap with early termination provision. The terms of the contract are:

2.19 Example 18 - Fixed/Floating Single Currency IRS With Bermuda Style Optional Early Termination, Cashflows + optionalEarlyTerminationAdjustedDates.

File: ird_ex18_opt_berm_term_swap.xml

On 30 August, 2000 PartyA and PartyB agree to enter into an ISDA swap with early termination provision. The terms of the contract are:

Note the following:

2.20 Example 19 - Fixed/Floating Single Currency IRS With American Style Optional Early Termination.

File: ird_ex19_opt_amer_term_swap.xml

On 30 August, 2000 PartyA and PartyB agree to enter into an ISDA swap with early termination provision. The terms of the contract are:

2.21 Example 20 - Fixed/Floating Single Currency IRS With European Cancelable Provision.

File: ird_ex20_euro_cancel_swap.xml

On 30 August, 2000 PartyA and PartyB agree to enter into an ISDA swap with Cancelable provision. The terms of the contract are:

2.22 Example 21 - Fixed/Floating Single Currency IRS With European Extendible Provision.

File: ird_ex21_euro_extend_swap.xml

On 30 August, 2000 PartyA and PartyB agree to enter into an ISDA swap with Extendible provision. The terms of the contract are:

2.23 Example 22 - Interest Rate Cap

File: ird_ex22_cap.xml

On 29 April, 2001 PartyA sells to PartyB an interest rate cap. The terms of the contract are:

Note the following:

2.24 Example 23 - Interest Rate Floor

File: ird_ex23_floor.xml

On 29 April, 2001 PartyA sells to PartyB an interest rate floor. The terms of the contract are:

Note the following:

2.25 Example 24 - Interest Rate Collar

File: ird_ex24_collar.xml

On 29 April, 2001 PartyB sells to PartyA an interest rate collar (PartyA buys a cap and sells a floor). The terms of the contract are:

Note the following:

2.26 Example 25 - Fixed/Floating IRS Where The Floating Stream Notional Is Reset Based On Prevailing Spot Exchange Rate

File: ird_ex25_fxnotional_swap.xml

On 9 January, 2001 PartyA and PartyB agree to enter into an FX Reseting interest rate swap. The terms of the contract are:

2.27 Example 26 - Example 25 - Fixed/Floating IRS Where The Floating Stream Notional Is Reset Based On Prevailing Spot Exchange Rate - Cashflows.

File: ird_ex26_fsnotional_swap_with_cfs.xml

On 9 January, 2001 PartyA and PartyB agree to enter into a forward starting FX Reseting interest rate swap. The terms of the contract are:

Things to note:

2.28 Example 27 - Inverse Floater

File: ird_ex27_inverse_floater.xml

On 30 August, 2000 PartyA and PartyB agree to enter into an ISDA. The terms of the contract are:

Things to note:

2.29 Example 28 - Bullet Payments

File: ird_ex28_bullet_payments.xml

On 29 April, 2000 PartyA agrees the payment of a single cashlow to PartyB. The terms of the contract are:

2.30 Example 29 - Swap with Non-Deliverable Settlement Provision

File: ird_ex29_non-deliverable_settlement_swap.xml

Example that shows non-deliverable terms of an interest rate swap.

These non-deliverable terms specify the conditions under which the cashflows will be made in a different currency (the "settlement currency") than the currency in which a given leg is denominated (the "reference currency").

3 Inflation Swaps Examples

3.1 Introduction

This section contains example FpML trades for Inflation Swaps. Each example illustrates how different product features are modeled in FpML.

The sample xml documents are available for download from the fpml.org website.

3.2 Example 1 - Year-on-Year

File: inflation_swap_ex01_yoy.xml

3.3 Example 2 - Year-on-Year with Bond Reference

File: inflation_swap_ex02_yoy_bond_reference.xml

3.4 Example 3 - Year-on-Year Initial Level

File: inflation_swap_ex03_yoy_initial_level.xml.xml

3.5 Example 4 - Year-on-Year with Interpolation

File: inflation_swap_ex04_yoy_interp.xml

3.6 Example 5 - Zero-Coupon

File: inflation_swap_ex05_zc.xml

4 Credit Derivative Examples

4.1 Credit Default Swap

This section contains example credit default swap trades expressed in FpML. These examples cover typical trades in the various regions and sectors that constitute the global credit default swap market.

Each example is fully described by the ISDA confirm which accompanies it. Note that the ISDA confirms represent example transactions documented under the 1999 ISDA Credit Derivatives Definitions. For the short form examples 2, 8 and 11 and the long form examples 7 and 10 additional FpML example files have been included illustrating how the deal would typically be documented under the 2003 ISDA Credit Derivatives Definitions.

The name of each example consists of three components:

In some cases there is an example that uses the 2003 ISDA definitions.

4.1.1 Example 1 - Asian Corporate, Long Form, Fixed Regular Payment Schedule

FpML File: cd_ex01_long_asia_corp_fixreg.xml

ISDA Confirm: cd_ex01_long_asia_corp_fixreg.pdf

4.1.2 Example 2 - Asian Corporate, Short Form, Fixed Regular Payment Schedule

FpML File: cd_ex02_short_asia_corp_fixreg.xml

FpML File (2003 version): cd_ex02_2003_short_asia_corp_fixreg.xml

ISDA Confirm: cd_ex02_short_asia_corp_fixreg.pdf

4.1.3 Example 3 - Australian Corporate, Long Form, Fixed Regular Payment Schedule

File: cd_ex03_long_aussie_corp_fixreg.xml

ISDA Confirm: cd_ex03_long_aussie_corp_fixreg.pdf

4.1.4 Example 4 - Australian Corporate, Short Form, Fixed Regular Payment Schedule

File: cd_ex04_short_aussie_corp_fixreg.xml

ISDA Confirm: cd_ex04_short_aussie_corp_fixreg.pdf

4.1.5 Example 5 - Emerging Markets Asian Corporate, Long Form, Fixed Regular Payment Schedule

File: cd_ex05_long_emasia_corp_fixreg.xml

ISDA Confirm: cd_ex05_long_emasia_corp_fixreg.pdf

4.1.6 Example 6 - Emerging Markets European Sovereign, Long Form, Fixed Regular Payment Schedule

File: cd_ex06_long_emeur_sov_fixreg.xml

ISDA Confirm: cd_ex06_long_emeur_sov_fixreg.pdf

4.1.7 Example 7 - European Corporate, Long Form, Fixed Regular Payment Schedule

File: cd_ex07_long_euro_corp_fixreg.xml

File (2003 version): cd_ex07_2003_long_euro_corp_fixreg.xml

ISDA Confirm: cd_ex07_long_euro_corp_fixreg.pdf

4.1.8 Example 8 - European Corporate, Short Form, Fixed Regular Payment Schedule

File: cd_ex08_short_euro_corp_fixreg.xml

File (2003 version): cd_ex08_2003_short_euro_corp_fixreg.xml

ISDA Confirm: cd_ex08_short_euro_corp_fixreg.pdf

4.1.9 Example 9 - European Sovereign, Long Form, Fixed Regular Payment Schedule

File: cd_ex09_long_euro_sov__fixreg.xml

ISDA Confirm: cd_ex09_long_euro_sov__fixreg.pdf

4.1.10 Example 10 - US Corporate, Long Form, Fixed Regular Payment Schedule

File: cd_ex10_long_us_corp_fixreg.xml

File (2003 version): cd_ex10_2003_long_us_corp_fixreg.xml

ISDA Confirm: cd_ex10_long_us_corp_fixreg.pdf

4.1.11 Example 11 - US Corporate, Short Form, Fixed Regular Payment Schedule

File: cd_ex11_short_us_corp_fixreg.xml

File (2003 version): cd_ex11_2003_short_us_corp_fixreg.xml

ISDA Confirm: cd_ex11_short_us_corp_fixreg.pdf

4.1.12 Example 12 - Emerging Markets Asian Sovereign, Long Form, Fixed Regular Payment Schedule

File: cd_ex12_long_emasia_sov_fixreg.xml

ISDA Confirm: cd_ex12_long_emasia_sov_fixreg.pdf

4.1.13 Example 13 - Asia Sovereign, Long Form, Fixed Regular Payment Schedule

File: cd_ex13_long_asia_sov_fixreg.xml

ISDA Confirm: cd_ex13_long_asia_sov_fixreg.pdf

4.1.14 Example 14 - Emerging Markets Latin American Corporate, Long Form, Fixed Regular Payment Schedule

File: cd_ex14_long_emlatin_corp_fixreg.xml

ISDA Confirm: cd_ex14_long_emlatin_corp_fixreg.pdf

4.1.15 Example 15 - Emerging Markets Latin American Sovereign, Long Form, Fixed Regular Payment Schedule

File: cd_ex15_long_emlatin_sov_fixreg.xml

ISDA Confirm: cd_ex15_long_emlatin_sov_fixreg.pdf

4.2 Credit Default Swap Index

4.2.1 Example 1 - CDX Example

Transaction Supplement: cd_CDX_iTraxx_example_trades.pdf

File: cdindex_ex01_cdx.xml

4.2.2 Example 2 - iTraxx Example

Transaction Supplement: cd_CDX_iTraxx_example_trades.pdf

File: cdindex_ex02_iTraxx.xml

4.3 Independent Amount

4.3.1 Example 1 - Independent Amount

The independent amount structure is in the Trade level. This example shows the use of independent amount in the context of a credit default swap.

File: cd_indamt_ex01_short_us_corp_fixreg.xml

4.4 Credit Event Notice

4.4.1 Example 1 - Credit Event Notice

File: cdcen_ex01_credit_event_notice_message.xml

File: cdcen_ex01_credit_event_notice_document.xml

Credit Event Notice Sample: cd_example_credit_event_notice.pdf

5 Foreign Exchange Examples

5.1 Introduction

This section contains twenty three example FpML trades related to FX and FX OTC options. Each example illustrates how different product features are modeled in FpML.

The sample xml documents are available for download from the fpml.org website.

5.2 Example 1 - FX Spot

File: fx_ex01_fx_spot.xml

On 23 October, 2001, Citibank New York and Barclay's London agree to a foreign exchange trade. The terms of the contract are:

5.3 Example 2 - FX Spot 'Cross' (non-base currency) with Side Rates

File: fx_ex02_spot_cross_w_side_rates.xml

On 23 October, 2001, Chase New York and CSFB New York agree to a foreign exchange trade. The terms of the contract are similar to Example 1, but in this case, the currencies exchanged are EUR and GBP. Both of these institutions are USD-based, so rates against the base currency (USD) have been captured as well. The terms of the contract are:

5.4 Example 3 - FX Forward

File: fx_ex03_fx_fwd.xml

On 19 November, 2001, ABN Amro and DeutscheBank agree to a one-month forward foreign exchange contract. The terms of the contract are:

5.5 Example 4 - FX Forward with specific Settlement Instructions

File: fx_ex04_fx_fwd_w_settlement.xml

On 12 November, 2001, UBS Zurich and Citibank New York agree to a foreign exchange contract. The terms of the contract are:

Settlement is highlighted in this example. In this case, UBS pays the GBP from their account at UBS London to Citi's GBP account at Citi London, with the ultimate beneficiary being Citi New York.

For the USD, Citi pays the USD to ultimate beneficiary UBS Zurich, but in this case, UBS Zurich holds its USD at Citibank, and therefore UBS' account as Citibank is credited.

5.6 Example 5 - FX Forward identified as using standard settlement instructions

File: fx_ex05_fx_fwd_w_ssi.xml

This is identical to Example 3, but the standard settlement scheme is used to highlight that this trade will be paid using standard, pre-agreed settlement instructions.

5.7 Example 6 - FX Forward with split settlement

File: fx_ex06_fx_fwd_w_splits.xml

On 12 November, 2001, DeutscheBank Frankfurt and ABN Amro Amsterdam agree to a forward foreign exchange contract. The terms of the contract are:

In this example, the exchange rate has been quoted as an "inverted" rate.

Split settlement is highlighted in this example in the payment of the USD. Here, the following has been specified:

The ultimate beneficiary is ABNANL2A for all USD payments, but 3 different accounts have been specified for settlement.

For the EUR, ABN pays all EUR to Deutsche, but specifies settlement of the EUR via a debit of ABN's account in EUR with Deutsche.

5.8 Example 7 - Non-deliverable FX Forward

File: fx_ex07_non_deliverable_forward.xml

On 09 January, 2002, Chase New York and CSFB New York agree to a FX non-deliverable forward contract. The terms of the contract are:

5.9 Example 8 - FX Swap

File: fx_ex08_fxswap.xml

On 23 January, 2002, Chase New York and Deutsche Frankfurt agree to an FX swap contract. The terms of the contract are:

5.10 Example 9 - FX OTC Option - European exercise

File: fx_ex09_euro_opt.xml

On 4 December, 2001, Chase agrees to purchase a standard FX OTC option from ABN Amro. The terms of the contract are:

5.11 Example 10 - FX OTC Option - American exercise

File: fx_ex10_amer_opt.xml

On 4 December, 2001, Chase agrees to purchase a standard FX OTC option from ABN Amro. The terms of the contract are:

5.12 Example 11 - Non-deliverable FX OTC Option

File: fx_ex11_non_deliverable_option.xml

On 15 January, 2001, Chase agrees to purchase a non-deliverable FX OTC USD / VEB option from ABN Amro. The terms of the contract are:

5.13 Example 12 - FX OTC Barrier Option

File: fx_ex12_fx_barrier_option.xml

On 16 August, 2001, DB agrees to purchase a EUR call against USD put barrier option with a knock-in

5.14 Example 13 - FX OTC Double Barrier Option

File: fx_ex13_fx_dbl_barrier_option.xml

On 3 January, 2001, DB agrees to purchase a 2-month double knockout FX OTC JPY put / USD call option from Chase The terms of the contract are:

5.15 Example 14 - FX OTC Digital/Binary Option -- Euro Binary

File: fx_ex14_euro_digital_option.xml

On 12 November, 2001, UBS agrees to purchase a two-week GBP/USD European binary option and pays a premium. At expiry, if the spot rate is above the trigger rate, UBS receives a payout.

5.16 Example 15 - FX OTC Digital/Binary Option -- Euro Range Digital

File: fx_ex15_euro_range_digital_option.xml

On 12 November, 2001, UBS agrees to purchase a two-week GBP/USD European range binary option and pays a premium. At expiry, if below the higher trigger rate and above the lower trigger rate, UBS receives a payout.

5.17 Example 16 - FX OTC Digital/Binary Option -- One-Touch

File: fx_ex16_one_touch_option.xml

On 12 November, 2001, UBS agrees to purchase a two-week GBP/USD one-touch option and pays a premium. At any time before expiry, if the spot rate is above the trigger rate, UBS receives a payout, but this payout is deferred until the value date of the option.

5.18 Example 17 - FX OTC Digital/Binary Option -- No-Touch

File: fx_ex17_no_touch_option.xml

On 12 November, 2001, UBS agrees to purchase a two-week GBP/USD no-touch option and pays a premium. If the spot rate remains below the trigger rate at all times until expiry, UBS receives a payout.

5.19 Example 18 - FX OTC Digital/Binary Option -- Double One-Touch

File: fx_ex18_double_one_touch_option.xml

On 12 November, 2001, UBS agrees to purchase a two-week GBP/USD double one-touch option and pays a premium. UBS receives a payout at maturity if the spot rate has crossed either trigger rate at some time during the lifetime of the option.

5.20 Example 19 - FX OTC Digital/Binary Option -- Double No-Touch

File: fx_ex19_double_no_touch_option.xml

On 12 November, 2001, UBS agrees to purchase a two-week GBP/USD double no-touch option and pays a premium. If the spot rate remains below the upper trigger rate and above the lower trigger rate at all times until expiry, UBS receives a payout.

5.21 Example 20 - FX OTC Average Rate Option with Parametric Schedule

File: fx_ex20_avg_rate_option_parametric.xml

On 16 August, 2001, DB agrees to purchase an average rate option from Chase and pays a premium. The terms of the contract are:

5.22 Example 21 - FX OTC Average Rate Option with Specific Date Schedule

File: fx_ex21_avg_rate_option_specific.xml

This example is identical to Example 20. Instead of using a parametric frequency (e.g., daily), each specific observation date has been specified. All weighting factors are 1.0, since all rates would be weighted evenly when the average rate is computed upon expiry.

5.23 Example 22 - Straddle (sample usage of Strategy)

File: fx_ex22_straddle.xml

On 20 November 2001, Chase agrees to purchase a straddle from ABN Amro. A straddle consists of buying a call and a put for the same currency pair, at the same strike price.

This contains two instances of the fxSimpleOption structure within strategy. Note that this is used when a single trade reference number is desired.

5.24 Example 23 - Delta Hedge (sample usage of Strategy)

File: fx_ex23_delta_hedge.xml

On 4 December, 2001, Chase agrees to purchase an FX OTC European option from ABN Amro. At the same time, they agree to hedge their FX spot risk by doing a FX spot transaction. This is all part of a single trade strategy.

5.25 Term Deposit Example 1 - Simple Term Deposit

File: td_ex01_simple_term_deposit.xml

ABN Amro pays 4% CHF fixed rate loan on ACT/360 basis a for 25 million Deposit from Midland starting February 14, 2002 and maturing February 15, 2002.

5.26 Term Deposit Example 2 - Term Deposit with Settlement Instructions

File: td_ex02_term_deposit_w_settlement_etc.xml

ABN Amro pays 4% CHF fixed rate loan on ACT/360 basis a for 25 million Deposit from Midland starting February 14, 2002 and maturing February 15, 2002. This example also demonstrates setting explicit settlement instructions for each cash flow.

6 Equity Options Examples

6.1 Introduction

This section contains examples of FpML trades for Equity Options products. Each example illustrates how different product features are modeled in FpML.

The sample xml documents are available for download from the fpml.org website.

6.2 Example 1 - American Call Stock Long Form

File: eqd_ex01_american_call_stock_long_form.xml

On 13 July, 2001, Party A and Party B agree to an equity option trade. The terms of the contract are:

6.3 Example 2 - Calendar Spread Short Form

File: eqd_ex02_calendar_spread_short_form.xml

On 13 July, 2001, Party A and Party B agree to an equity option trade. The terms of the contract are:

6.4 Example 3 - Call or Put Spread Short Form

File: eqd_ex03_call_or_put_spread_short_form.xml

6.5 Example 4 - European Call Index Long Form

File: eqd_ex04_european_call_index_long_form.xml

On 4 September, 2001, Party A and Party B agree to an equity option trade. The terms of the contract are:

6.6 Example 5 - Asian Option Long Form

File: eqd_ex05_asian_long_form.xml

On 28 June, 2000, Party A and Party B agree to an equity option trade. The terms of the contract are:

6.7 Example 6 - Averaging In Long Form

File: eqd_ex06_averaging_in_long_form.xml

6.8 Example 7 - Barrier Knockout with Rebate Long Form

File: eqd_ex07_barrier_knockout_rebate_long_form.xml

A European Call on Eurostoxx 50 Index traded on 1 July 2002.

6.9 Example 8 - Basket Long Form

File: eqd_ex08_basket_long_form.xml

A European call option on a basket of stocks.

6.10 Example 9 - Bermuda Long Form

File: eqd_ex09_bermuda_long_form.xml

6.11 Example 10 - Binary Barrier Long Form

File: eqd_ex10_binary_barrier_long_form.xml

A European Call on S&P500 Index trade 25 March 2002:

6.12 Example 11 - Quanto Long Form

File: eqd_ex11_quanto_long_form.xml

6.13 Example 12 - Vanilla Short Form

File: eqd_ex12_vanilla_short_form.xml

6.14 Example 13 - 1996 American Call Stock

File: eqd_ex13_1996_american_call_stock.xml

7 Equity Swaps Examples

7.1 Introduction

This section contains example FpML trades for Equity Swaps. Each example illustrates how different product features are modeled in FpML.

The sample xml documents are available for download from the fpml.org website.

7.2 Example 1 - Single Underlyer Execution Swap Long Form

File: eqs_ex01_single_underlyer_execution_long_form.xml

On 24th September, 2002, Party A and Party B agree to an equity swap trade. The terms of the contract are:

7.3 Example 2 - Composite Basket Swap Long Form

File: eqs_ex02_composite_basket_long_form.xml

On 17th July, 2002, Party A and Party B agree to an equity swap trade. The terms of the contract are:

7.4 Example 3 - Index Swap With a Quanto Feature Long Form

File: eqs_ex03_index_quanto_long_form.xml

On 19th July, 2002, Party A and Party B agree to an equity swap trade. The terms of the contract are:

7.5 Example 4 - Zero-strike Equity Swap

File: eqs_ex04_zero_strike_long_form.xml

On 17th October, 2002, Party A and Party B agree to an equity swap trade. The terms of the contract are:

7.6 Example 5 - Single Underlyer Swap with an Upfront Fee as well as a Brokerage Fee Long Form

File: eqs_ex05_single_stock_plus_fee_long_form.xml

On 10th September, 2002, Party A and Party B agree to an equity swap trade. The terms of the contract are:

7.7 Example 6 - Single Index Long Form

File: eqs_ex06_single_index_long_form.xml

7.8 Example 7 - Single Underlyer Swap with both an Initial and a Final Stub

File: eqs_ex07_long_form_with_stub.xml

On 17th July, 2002, Party A and Party B agree to an equity swap trade. The terms of the contract are:

8 Equity Forwards Examples

8.1 Introduction

This section contains example FpML trades for Equity Forwards. Each example illustrates how different product features are modeled in FpML.

The sample xml documents are available for download from the fpml.org website.

8.2 Example 1 - Equity Forward Stock Long Form

File: eqf_ex01_forward_stock_long_form.xml

9 Variance Swaps Examples

9.1 Introduction

This section contains example FpML trades for Equity Variance Swaps. Each example illustrates how different product features are modeled in FpML.

The sample xml documents are available for download from the fpml.org website.

9.2 Example 1 - Variance Swap Index

File: eqvs_ex01_variance_swap_index.xml

9.3 Example 2 - Variance Swap Single Stock

File: eqvs_ex02_variance_swap_single_stock.xml

10 Pricing and Risk Examples

10.1 Use Cases/Examples

This section identifies scenarios intended to be supported by this specification:

10.1.1 Terminology:

  • Client: The originator of a valuation request.
  • Provider: The acceptor of a valuation request that generates a valuation report.
  • Valuation Request: XML document that specifies what is to be calculated.
  • Valuation Report: XML document that contains the results of a valuation. This report may contain either one or more NPVs, or Risk related measures, or both.

10.1.2 Request/Response scenarios:

In these scenarios one party to a deal requests a report from either a counterparty, third party service, or another application or department within the same firm.

10.1.2.1 Scenario 1 – Request Trade Value

A client wants to request a price quote for a proposed trade from a provider (or set of providers). The provider might be anonymous to the client. Typically the provider would be some sort of dealer. The client may be another dealer or an electronic trading service.

  • No market data is necessary in the request.
  • No market data is returned in the result.
  • Market data is assumed to be live or current market data.
10.1.2.1.1 Use Case 1 Description

Client submits a request, including:

Provider returns a basic valuation report, including:

10.1.2.2 Scenario 2 – Request Portfolio Value/Sensitivity

A buy-side client wants to request a valuation from a dealer for a deal or portfolio of deals that it has done with that dealer. This request may be also be all deals of a specific type (IR Swaps, CD Swaps, Equity Swaps, FX options, etc.)

  • No market data is necessary in the request.
  • No market data is returned in the result.
  • Market data is for a specified end-of-day close.

Variations on Scenario 2:

  • B) The client wants to obtain sensitivity measures as well as simple PV
10.1.2.2.1 Use Case 2A Description

Client submits a request, including:

  • The portfolio details – characteristics that the trade must match
    • One party must be client
    • Product must be an IR Swap
  • A specification of the required results:
    • Characteristics of the response:
      • Base party for valuation (client)
      • Reporting Currency
      • Valuation Date
    • Requested values
      • Trade Value (NPV)
  • An example can be found at: pr_ex02a_request_port_val.xml

Provider returns a basic valuation report, including:

  • Portfolio contents (i.e. list of matching trades)
  • Valuation report, including
    • Characteristics of the valuation, e.g.
      • Valuation Date
      • Base Party
      • Reporting currency
    • For each trade,
      • Trade Value
  • An example can be found at: pr_ex02a_return_port_val.xml
10.1.2.2.2 Use Case 2B Description

Client submits a request, including:

  • The portfolio details – list of trade ids to report on
  • A specification of the required results:
    • Characteristics of the response:
      • Base party for valuation (client)
      • Reporting Currency
      • Valuation Date
    • Requested values
      • Trade Value (NPV)
      • Sensitivity of NPV to yield curve
  • An example can be found at: pr_ex02b_request_port_val_and_sens.xml

Provider returns a basic valuation report, including:

  • Portfolio contents (i.e. list of matching trades)
  • Valuation report, including
    • Characteristics of the valuation, e.g.
      • Valuation Date
      • Base Party
      • Reporting currency
    • For each trade,
      • Trade Value
      • List of sensitivities
  • An example can be found at: pr_ex02b_return_port_val_and_sens.xml
10.1.2.3 Scenario 3 – Request Sensitivity Generation

A relatively sophisticated client wants to calculate risk sensitivities and/or scenario valuations for a portfolio of deals that it can price, but either doesn’t have the tools or the compute power for sensitivity or scenario calculation.

  • Market data is specified in the request.
  • A level of control is required over pricing parameters

Provider doesn’t need to provide market data back

Variations on Scenario 3:

  • 3B – Client wants market data back and explicit link of risk to market data
  • 3C Client specifies scenarios to base market data (live or EOD) – e.g. +/- 10% credit spread, +/- 10BP interest rate change
10.1.2.3.1 Use Case 3A Description

Client submits a request, including:

  • The portfolio details – list of trade ids to report on
  • A specification of the required environment (curves to use)
  • A specification of the required results:
    • Characteristics of the response:
      • Base party for valuation (client)
      • Reporting Currency
      • Valuation Date
    • Requested values
      • Trade Value (NPV)
      • Sensitivity of NPV to yield curve
  • An example can be found at: pr_ex03a_request_sensitivity_generation.xml

Provider returns a detailed valuation report, including:

  • Portfolio contents (i.e. list of matching trades)
  • Valuation report, including
    • Characteristics of the valuation, e.g.
      • Valuation Date
      • Base Party
      • Reporting currency
    • For each trade,
      • Trade Value
      • List of sensitivities
  • A basic example can be found at: pr_ex03a_return_sensitivities.xml
  • An example providing slightly more detail about the sensivities can be found at: pr_ex03a_return_sensitivities_and_description.xml
10.1.2.3.2 Use Case 3B Description

Client submits a request, including:

  • The portfolio details – list of trade ids to report on
  • A specification of the required environment (curves to use)
  • A specification of the required results:
    • Characteristics of the response:
      • Base party for valuation (client)
      • Reporting Currency
      • Valuation Date
    • Requested values
      • Trade Value (NPV)
      • Sensitivity of NPV to yield curve
      • That the client wishes the market environment returned (marketEnvironmentIncluded = true).
  • An example can be found at: pr_ex03b_request_sensitivity_generation.xml

Provider returns a detailed valuation report, including:

  • Portfolio contents (i.e. list of matching trades)
  • Valuation report, including
    • Characteristics of the valuation, e.g.
      • Valuation Date
      • Base Party
      • Reporting currency
    • For each trade,
      • Trade Value
      • Sensitivity definitions
      • List of sensitivities, linked to market inputs
  • An example can be found at: pr_ex03b_return_sensitivities_with_definition.xml
10.1.2.3.3 Use Case 3C Description

Client submits a request, including:

Provider returns a detailed valuation report, including:

  • Portfolio contents (i.e. list of matching trades)
  • Valuation report, including
10.1.2.4 Scenario 4 – Request New Trade Impact

A buy-side client wants to understand the impact on valuation and risk exposure that a proposed deal would have on an existing portfolio. The provider may be the dealer that is proposing the trade.

This use case is implemented by the client requesting the result twice. The first request includes the original portfolio only, and the second includes the new trade.The requesting party should combine the two results.

For all additive valuations and risk measures, the second call can include only the new trade. For results which are not additive, e g value at risk, the second request includes also the original portfolio.

10.1.2.5 Scenario 5 – Perform Analyses

A trader or marketer oriented spreadsheet client wants to value and calculate risk for a trade or set of trades. The valuation provider is an internal valuation service.

  • Market data may or may not be specified in the request.
  • Market data and pricing data is returned in the result.
  • A high-degree of control is required over pricing parameters.
  • No example is currently available for this.
10.1.2.5.1 Use Case 5A Description

Client submits a request, including:

  • The portfolio details – list of trade ids to report on
  • A specification of the required environment (curves to use)
  • A specification of the required results:
    • Characteristics of the response:
      • Base party for valuation (client)
      • Reporting Currency
      • Valuation Date
    • Requested values
      • Trade Value (NPV)
      • Sensitivity of NPV to yield curve
      • Sensitivity of NPV to vol surface
      • [How does the client specify that provider should return the market environment?]
  • No example is currently available for this.

Service returns a detailed valuation report, including:

  • Portfolio contents (i.e. list of matching trades)
  • Market environment used (curves, vol surfaces)
  • Valuation report, including
    • Characteristics of the valuation, e.g.
      • Valuation Date
      • Base Party
      • Reporting currency
      • Valuation scenario applied
    • For each trade,
      • Trade Value
      • Sensitivity definitions
      • List of sensitivities, linked to market inputs
  • No example is currently available for this.
10.1.2.6 Scenario 6 – Request Pricing Inputs

The use cases in this scenario are out of scope for this working draft, but are expected to be covered in an upcoming draft. This means that there is no schema support for these requests and responses, and there are no examples provided. The use case descriptions are provided as an indication of the functionality that is intended to be supported in the future.

A party is requesting a curve of a specific type (IR, Credit, Asset, etc.) Most likely this would be an internal request between applications within the same firm.

  • Market data and other pricing data may be required in the report.

Client submits a market input request, including:

  • Market environment characteristics to respond with
    • Environment Name
    • Currency
    • Input Type (yield curves, vol surfaces)
    • Valuation date
  • A specification of the required results:
    • Requested values
      • Definitions (e.g. curve definitions)
      • Input values
      • Output values (DFs, Zeros, etc.)
    • No example is currently available for this.

Service returns a market environment, including:

  • Market environment(s) including
    • Yield curves
    • Vol Surfaces
  • No example is currently available for this.

10.1.3 Notification Scenarios

In these scenarios a party, service or internal system sends out reports without being first solicited to do so. Parameters that should be agreed upon between the sending and receiving parties should include: counterparty, deal types, when the report is sent, supporting information such as FX rates, risk sensitivities, etc.. Parties should also agree what, if any acknowledgement of receipt should be sent by the receiving party.

10.1.3.1 Position Report

Supports the DSWG Position Report representation:

10.1.3.2 Use Case 7:

An internal middle or back office system needs a feed of valuation (and perhaps risk sensitivities) from a variety of systems, in the form of valuation reports.

  • No explicit valuation request
  • Market data and other pricing data may be required in the report.
10.1.3.3 Use Case 8:

A service or broker may provide a feed of valuation (and perhaps risk sensitivities) to their clients on a regularly scheduled basis.

  • No explicit valuation request
  • Market data and other pricing data may be required in the report.

Valid XHTML 1.1! Valid CSS!