FpML Financial product Markup Language
Working Draft 17 April 2002

FX Component Definitions

Version: 3.0

This version: http://www.fpml.org/spec/2002/wd-fpml-3-0-2002-04-17

Latest version: http://www.fpml.org/spec/fpml-3-0

Previous version: http://www.fpml.org/spec/2002/wd-fpml-3-0-2002-01-30





Copyright 1999 - 2002. All rights reserved.

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

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





DTD:wd-fpml-dtd-fx-3-0-2002-04-17.dtd

Entity Definitions

FpML_Address


Description:

An entity that represents a physical postal address


Figure:



Contents:


streetAddress (zero or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_StreetAddress)
city (zero or one occurrence; of type string)
state (zero or one occurrence; of type string)
country (zero or one occurrence; of type string, an enumerated domain value defined by countryScheme)
postalCode (zero or one occurrence; of type string)


Used by:


routingAddress


DTD Fragment:


<!ENTITY % FpML_Address "streetAddress* , city? , state? , country? , postalCode?">



FpML_CurrencyFlow


Description:

An entity that is based upon the FpML_Payment entity, this allows for settlement instructions to be included as well. This entity, which represents the payment of an amount of currency from one party to another, is one of the key ingredients used for representing a standard foreign exchange transaction.


Figure:



Contents:


inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_Payment)
settlementInformation (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_SettlementInformation)


Used by:


exchangedCurrency1
exchangedCurrency2


DTD Fragment:


<!ENTITY % FpML_CurrencyFlow "%FpML_Payment; , settlementInformation?">



FpML_ExpiryDateTime


Description:

An entity that describes the date and time in a location of the option expiry. In the case of American options this is the latest possible expiry date and time.


Figure:



Contents:


expiryDate (exactly one occurrence; of type date)
inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_BusinessCenterTime)
cutName (zero or one occurrence; of type string, an enumerated domain value defined by cutNameScheme)


Used by:


expiryDateTime


DTD Fragment:


<!ENTITY % FpML_ExpiryDateTime "expiryDate , %FpML_BusinessCenterTime; , cutName?">



FpML_FXAmericanTrigger


Description:

An entity that defines a particular type of payout in an FX OTC exotic option. An American trigger occurs if the trigger criteria are met at any time from the initiation to the maturity of the option.


Figure:



Contents:


touchCondition (exactly one occurrence; of type string, an enumerated domain value defined by touchConditionScheme)
quotedCurrencyPair (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_QuotedCurrencyPair)
triggerRate (exactly one occurrence; of type string)
informationSource (one or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_InformationSource)
observationStartDate (zero or one occurrence; of type date)
observationEndDate (zero or one occurrence; of type date)


Used by:


fxAmericanTrigger


DTD Fragment:


<!ENTITY % FpML_FXAmericanTrigger "touchCondition , quotedCurrencyPair , triggerRate , informationSource+ , observationStartDate? , observationEndDate?">



FpML_FXAverageRateObservationDate


Description:

An entity that, for average rate options, is used to describe each specific observation date, as opposed to a parametric frequency of rate observations.


Figure:



Contents:


observationDate (exactly one occurrence; of type date)
averageRateWeightingFactor (exactly one occurrence; of type string)


Used by:


averageRateObservationDate


DTD Fragment:


<!ENTITY % FpML_FXAverageRateObservationDate "observationDate , averageRateWeightingFactor">



FpML_FXAverageRateObservationSchedule


Description:

An entity that describes average rate options rate observations. This is used to describe a parametric frequency of rate observations against a particular rate. Typical frequencies might include daily, every Friday, etc.


Figure:



Contents:


observationStartDate (exactly one occurrence; of type date)
observationEndDate (exactly one occurrence; of type date)
calculationPeriodFrequency (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_CalculationPeriodFrequency)


Used by:


averageRateObservationSchedule


DTD Fragment:


<!ENTITY % FpML_FXAverageRateObservationSchedule "observationStartDate , observationEndDate , calculationPeriodFrequency">



FpML_FXAverageRateOption


Description:

An entity that is used for an option whose payout is based on the average of the price of the underlying over a specific period of time. The payout is the difference between the predetermined, fixed strike price and the average of spot rates observed and is used for hedging against prevailing spot rates over a given time period.


Figure:



Contents:


inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_Product)
buyerPartyReference (exactly one occurrence; an empty element containing an href attribute)
sellerPartyReference (exactly one occurrence; an empty element containing an href attribute)
expiryDateTime (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_ExpiryDateTime)
exerciseStyle (exactly one occurrence; of type string, an enumerated domain value defined by exerciseStyleScheme)
fxOptionPremium (zero or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXOptionPremium)
valueDate (exactly one occurrence; of type date)
putCurrencyAmount (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Money)
callCurrencyAmount (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Money)
fxStrikePrice (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXStrikePrice)
spotRate (zero or one occurrence; of type string)
payoutCurrency (exactly one occurrence; of type string, an enumerated domain value defined by currencyScheme)

  • The ISO code of the currency in which a payout (if any) is to be made when a trigger is hit on a digital or barrier option.


averageRateQuoteBasis (exactly one occurrence; of type string, an enumerated domain value defined by strikeQuoteBasisScheme)

  • The method by which the average rate that is being observed is quoted.


precision (zero or one occurrence; of type nonNegativeInteger)

  • Specifies the rounding precision in terms of a number of decimal places. Note how a percentage rate rounding of 5 decimal places is expressed as a rounding precision of 7 in the FpML document since the percentage is expressed as a decimal, e.g. 9.876543% (or 0.09876543) being rounded to the nearest 5 decimal places is 9.87654% (or 0.0987654).


payoutFormula (zero or one occurrence; of type string)

  • The description of the mathematical computation for how the payout is computed.


primaryRateSource (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_InformationSource)

  • The primary source for where the rate observation will occur. Will typically be either a page or a reference bank published rate.


secondaryRateSource (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_InformationSource)

  • An alternative, or secondary, source for where the rate observation will occur. Will typically be either a page or a reference bank published rate.


fixingTime (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_BusinessCenterTime)

  • The time at which the spot currency exchange rate will be observed. It is specified as a time in a specific business center, e.g. 11:00 am London time.


Either

    averageRateObservationSchedule (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXAverageRateObservationSchedule)

    • Parametric schedule of rate observations.


Or

    averageRateObservationDate (one or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXAverageRateObservationDate)

    • One of more specific rate observation dates.


observedRates (zero or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_ObservedRates)

  • Describes prior rate observations within average rate options. Periodically, an average rate option agreement will be struck whereby some rates have already been observed in the past but will become part of computation of the average rate of the option. This structure provides for these previously observed rates to be included in the description of the trade.


Used by:


fxAverageRateOption


DTD Fragment:


<!ENTITY % FpML_FXAverageRateOption "%FpML_Product; , buyerPartyReference , sellerPartyReference , expiryDateTime , exerciseStyle , fxOptionPremium* , valueDate , putCurrencyAmount , callCurrencyAmount , fxStrikePrice , spotRate? , payoutCurrency , averageRateQuoteBasis , precision? , payoutFormula? , primaryRateSource , secondaryRateSource? , fixingTime , (averageRateObservationSchedule | averageRateObservationDate+) , observedRates*">



FpML_FXBarrier


Description:

An entity that is used within the FX barrier option definition to define one or more barrier levels that determine whether the option will be knocked-in or knocked-out.


Figure:



Contents:


fxBarrierType (zero or one occurrence; of type string, an enumerated domain value defined by fxBarrierTypeScheme)
quotedCurrencyPair (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_QuotedCurrencyPair)
triggerRate (exactly one occurrence; of type string)
informationSource (one or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_InformationSource)
observationStartDate (zero or one occurrence; of type date)
observationEndDate (zero or one occurrence; of type date)


Used by:


fxBarrier


DTD Fragment:


<!ENTITY % FpML_FXBarrier "fxBarrierType? , quotedCurrencyPair , triggerRate , informationSource+ , observationStartDate? , observationEndDate?">



FpML_FXBarrierOption


Description:

An entity that describes an option with a put/call component, but also one or more associated barrier rates. If the market rate moves to reach a barrier rate a trigger event occurs. The trigger event may for example be necessary to enable the option, or may annul the option contract. [Since the barriers reduce the probability of exercise, the premium for an option with barriers is likely to be cheaper than one without].


Figure:



Contents:


inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_FXOptionLeg)
spotRate (zero or one occurrence; of type string)
fxBarrier (one or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXBarrier)
triggerPayout (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXOptionPayout)


Used by:


fxBarrierOption


DTD Fragment:


<!ENTITY % FpML_FXBarrierOption "%FpML_FXOptionLeg; , spotRate? , fxBarrier+ , triggerPayout?">



FpML_FXCashSettlement


Description:

An entity that is used for describing cash settlement of an option / non deliverable forward. It includes the currency to settle into together with the fixings required to calculate the currency amount.


Figure:



Contents:


settlementCurrency (exactly one occurrence; of type string, an enumerated domain value defined by currencyScheme)
fixing (one or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXFixing)


Used by:


cashSettlementTerms
nonDeliverableForward


DTD Fragment:


<!ENTITY % FpML_FXCashSettlement "settlementCurrency , fixing+">



FpML_FXDigitalOption


Description:

An entity that describes an option without a put/call component (and so no associated exercise), but with one or more trigger rates) Examples are "one-touch", "no-touch", and "double-no-touch" options. For a specified period the market rate is observed relative to the trigger rates, and on a trigger event a fixed payout may become due to the buyer of the option, or alternatively the option contract may be annulled.


Figure:



Contents:


inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_Product)
buyerPartyReference (exactly one occurrence; an empty element containing an href attribute)
sellerPartyReference (exactly one occurrence; an empty element containing an href attribute)
expiryDateTime (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_ExpiryDateTime)
fxOptionPremium (zero or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXOptionPremium)
valueDate (exactly one occurrence; of type date)
quotedCurrencyPair (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_QuotedCurrencyPair)
spotRate (zero or one occurrence; of type string)
Either
Or
triggerPayout (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXOptionPayout)


Used by:


fxDigitalOption


DTD Fragment:


<!ENTITY % FpML_FXDigitalOption "%FpML_Product; , buyerPartyReference , sellerPartyReference , expiryDateTime , fxOptionPremium* , valueDate , quotedCurrencyPair , spotRate? , (fxEuropeanTrigger+ | fxAmericanTrigger+) , triggerPayout">



FpML_FXEuropeanTrigger


Description:

An entity that defines a particular type of payout in an FX OTC exotic option. A European trigger occurs if the trigger criteria are met, but these are valid (and an observation is made) only at the maturity of the option.


Figure:



Contents:


triggerCondition (exactly one occurrence; of type string, an enumerated domain value defined by triggerConditionScheme)
quotedCurrencyPair (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_QuotedCurrencyPair)
triggerRate (exactly one occurrence; of type string)
informationSource (one or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_InformationSource)


Used by:


fxEuropeanTrigger


DTD Fragment:


<!ENTITY % FpML_FXEuropeanTrigger "triggerCondition , quotedCurrencyPair , triggerRate , informationSource+">



FpML_FXFixing


Description:

An entity that specifies the source for and timing of a fixing of an exchange rate. This is used in the agreement of non-deliverable forward trades as well as various types of FX OTC options that require observations against a particular rate.


Figure:



Contents:


quotedCurrencyPair (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_QuotedCurrencyPair)
primaryRateSource (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_InformationSource)
secondaryRateSource (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_InformationSource)
fixingDate (exactly one occurrence; of type date)
fixingTime (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_BusinessCenterTime)


Used by:


fixing


DTD Fragment:


<!ENTITY % FpML_FXFixing "quotedCurrencyPair , primaryRateSource , secondaryRateSource? , fixingDate , fixingTime">



FpML_FXLeg


Description:

An entity that represents a single exchange of one currency for another. This is used for representing FX spot, forward, and swap transactions.


Figure:



Contents:


inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_Product)
exchangedCurrency1 (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_CurrencyFlow)
exchangedCurrency2 (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_CurrencyFlow)
Either
Or
Or
exchangeRate (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXRate)
nonDeliverableForward (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXCashSettlement)
confirmationSenderPartyReference (zero or one occurrence; an empty element containing an href attribute)


Used by:


fxSingleLeg


DTD Fragment:


<!ENTITY % FpML_FXLeg "%FpML_Product; , exchangedCurrency1 , exchangedCurrency2 , (valueDate | (currency1ValueDate , currency2ValueDate)) , exchangeRate , nonDeliverableForward? , confirmationSenderPartyReference?">



FpML_FXOptionLeg


Description:

An entity that is used for describing a standard FX OTC option (European or American) which may be a complete trade in its own right or part of a trade strategy.


Figure:



Contents:


inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_Product)
buyerPartyReference (exactly one occurrence; an empty element containing an href attribute)
sellerPartyReference (exactly one occurrence; an empty element containing an href attribute)
expiryDateTime (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_ExpiryDateTime)
exerciseStyle (exactly one occurrence; of type string, an enumerated domain value defined by exerciseStyleScheme)
fxOptionPremium (zero or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXOptionPremium)
valueDate (exactly one occurrence; of type date)
cashSettlementTerms (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXCashSettlement)
putCurrencyAmount (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Money)
callCurrencyAmount (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Money)
fxStrikePrice (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXStrikePrice)
quotedAs (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_QuotedAs)


Used by:


FpML_FXBarrierOption
fxSimpleOption


DTD Fragment:


<!ENTITY % FpML_FXOptionLeg "%FpML_Product; , buyerPartyReference , sellerPartyReference , expiryDateTime , exerciseStyle , fxOptionPremium* , valueDate , cashSettlementTerms? , putCurrencyAmount , callCurrencyAmount , fxStrikePrice , quotedAs?">



FpML_FXOptionPayout


Description:

An entity that contains full details of a predefined fixed payout which may occur (or not) in a Barrier Option or Digital Option when a trigger event occurs (or not).


Figure:



Contents:


inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_Money)
payoutStyle (exactly one occurrence; of type string, an enumerated domain value defined by payoutScheme)
settlementInformation (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_SettlementInformation)


Used by:


triggerPayout


DTD Fragment:


<!ENTITY % FpML_FXOptionPayout "%FpML_Money; , payoutStyle , settlementInformation?">



FpML_FXOptionPremium


Description:

An entity that specifies the premium exchanged for a single option trade or option strategy.


Figure:



Contents:


payerPartyReference (exactly one occurrence; an empty element containing an href attribute)
receiverPartyReference (exactly one occurrence; an empty element containing an href attribute)
premiumAmount (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Money)
premiumSettlementDate (exactly one occurrence; of type date)
settlementInformation (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_SettlementInformation)
premiumQuote (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_PremiumQuote)


Used by:


fxOptionPremium


DTD Fragment:


<!ENTITY % FpML_FXOptionPremium "payerPartyReference , receiverPartyReference , premiumAmount , premiumSettlementDate , settlementInformation? , premiumQuote?">



FpML_FXRate


Description:

An entity that is used for describing the exchange rate for a particular transaction.


Figure:



Contents:


quotedCurrencyPair (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_QuotedCurrencyPair)
rate (exactly one occurrence; of type decimal)
spotRate (zero or one occurrence; of type string)
forwardPoints (zero or one occurrence; of type string)
sideRates (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_SideRates)


Used by:


exchangeRate


DTD Fragment:


<!ENTITY % FpML_FXRate "quotedCurrencyPair , rate , spotRate? , forwardPoints? , sideRates?">



FpML_FXStrikePrice


Description:

An entity that describes the rate of exchange at which the option has been struck.


Figure:



Contents:


rate (exactly one occurrence; of type decimal)
strikeQuoteBasis (exactly one occurrence; of type string, an enumerated domain value defined by strikeQuoteBasisScheme)


Used by:


fxStrikePrice


DTD Fragment:


<!ENTITY % FpML_FXStrikePrice "rate , strikeQuoteBasis">



FpML_FXSwap


Description:

An entity that describes an FX swap. This is similar to FpML_FXLeg, but contains multiple legs for a particular trade.


Figure:



Contents:


inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_Product)
fxSingleLeg (one or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_FXLeg)


Used by:


fxSwap


DTD Fragment:


<!ENTITY % FpML_FXSwap "%FpML_Product; , fxSingleLeg+">



FpML_IntermediaryInformation


Description:

An entity that describes the information to identify an intermediary through which payment will be made by the correspondent bank to the ultimate beneficiary of the funds.


Figure:



Contents:


intermediarySequenceNumber (exactly one occurrence; of type integer)
inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_Routing)


Used by:


intermediaryInformation


DTD Fragment:


<!ENTITY % FpML_IntermediaryInformation "intermediarySequenceNumber , %FpML_Routing;">



FpML_ObservedRates


Description:

An entity that describes prior rate observations within average rate options. Periodically, an average rate option agreement will be struck whereby some rates have already been observed in the past but will become part of computation of the average rate of the option. This structure provides for these previously observed rates to be included in the description of the trade.


Figure:



Contents:


observationDate (exactly one occurrence; of type date)
observedRate (exactly one occurrence; of type decimal)


Used by:


observedRates


DTD Fragment:


<!ENTITY % FpML_ObservedRates "observationDate , observedRate">



FpML_PaymentRouting


Description:

An entity that provides a structure for representing all the parties involved in routing a payment to an ultimate beneficiary. This can include the correspondent bank, any intermediary banks, and the beneficiary and beneficiary's bank.


Figure:



Contents:


correspondentInformation (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Routing)
intermediaryInformation (zero or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_IntermediaryInformation)
beneficiaryInformation (zero or one occurrence;


Used by:


DTD Fragment:


<!ENTITY % FpML_PaymentRouting "correspondentInformation? , intermediaryInformation* , beneficiaryInformation?">



FpML_PremiumQuote


Description:

An entity that describes the option premium as quoted.


Figure:



Contents:


premiumValue (exactly one occurrence; of type decimal)
premiumQuoteBasis (exactly one occurrence; of type string, an enumerated domain value defined by premiumQuoteBasisScheme)


Used by:


premiumQuote


DTD Fragment:


<!ENTITY % FpML_PremiumQuote "premiumValue , premiumQuoteBasis">



FpML_QuotedAs


Description:

An entity that describes how the option was quoted.


Figure:



Contents:


optionOnCurrency (exactly one occurrence; of type string, an enumerated domain value defined by currencyScheme)
faceOnCurrency (exactly one occurrence; of type string, an enumerated domain value defined by currencyScheme)

  • Either the callCurrencyAmount or the putCurrencyAmount defined elsewhere in the document.The currency reference denotes the face currency as the option was quoted (as opposed to the option currency).


quotedTenor (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Interval)

  • Code denoting the tenor of the option leg.


Used by:


quotedAs


DTD Fragment:


<!ENTITY % FpML_QuotedAs "optionOnCurrency , faceOnCurrency , quotedTenor?">



FpML_QuotedCurrencyPair


Description:

An entity that describes the composition of a rate that has been quoted or is to be quoted. This includes the two currencies and the quotation relationship between the two currencies and is used as a building block throughout the FX specification.


Figure:



Contents:


currency1 (exactly one occurrence; of type string, an enumerated domain value defined by currencyScheme)
currency2 (exactly one occurrence; of type string, an enumerated domain value defined by currencyScheme)

  • The second currency specified when a pair of currencies is to be evaluated.


quoteBasis (exactly one occurrence; of type string, an enumerated domain value defined by quoteBasisScheme)

  • The method by which the exchange rate is quoted.


Used by:


quotedCurrencyPair


DTD Fragment:


<!ENTITY % FpML_QuotedCurrencyPair "currency1 , currency2 , quoteBasis">



FpML_Routing


Description:

An entity that provides three alternative ways of identifying a party involved in the routing of a payment. The identification may use payment system identifiers only; actual name, address and other reference information; or a combination of both.


Figure:



Contents:


Either
Or
Or


Used by:


FpML_IntermediaryInformation
beneficiary
beneficiaryBank
correspondentInformation


DTD Fragment:


<!ENTITY % FpML_Routing "(routingIds | routingExplicitDetails | routingIdsAndExplicitDetails)">



FpML_RoutingExplicitDetails


Description:

An entity that models name, address and supplementary textual information for the purposes of identifying a party involved in the routing of a payment.


Figure:



Contents:


routingName (exactly one occurrence; of type string)
routingAddress (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Address)
routingAccountNumber (zero or one occurrence; of type string)
routingReferenceText (zero or more occurrences; of type string)


Used by:


FpML_RoutingIdsAndExplicitDetails
routingExplicitDetails


DTD Fragment:


<!ENTITY % FpML_RoutingExplicitDetails "routingName , routingAddress? , routingAccountNumber? , routingReferenceText*">



FpML_RoutingIds


Description:

An entity that provides for identifying a party involved in the routing of a payment by means of one or more standard identification codes. For example, both a SWIFT BIC code and a national bank identifier may be required.


Figure:



Contents:


routingId (one or more occurrences; of type string, an enumerated domain value defined by routingIdScheme)


Used by:


routingIds


DTD Fragment:


<!ENTITY % FpML_RoutingIds "routingId+">



FpML_RoutingIdsAndExplicitDetails


Description:

An entity that provides a combination of payment system identification codes with physical postal address details, for the purposes of identifying a party involved in the routing of a payment.


Figure:



Contents:


routingIds (one or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_RoutingIds)
inherited element(s) (this entity inherits the element(s) defined by exactly one occurrence of the entity FpML_RoutingExplicitDetails)


Used by:


routingIdsAndExplicitDetails


DTD Fragment:


<!ENTITY % FpML_RoutingIdsAndExplicitDetails "routingIds+ , %FpML_RoutingExplicitDetails;">



FpML_SettlementInformation


Description:

An entity that represents the choice of methods for settling a potential currency payment resulting from a trade: by means of a standard settlement instruction, by netting it out with other payments, or with an explicit settlement instruction.


Figure:



Contents:


Either
Or


Used by:


settlementInformation


DTD Fragment:


<!ENTITY % FpML_SettlementInformation "standardSettlementStyle | settlementInstruction">



FpML_SettlementInstruction


Description:

An entity that models a complete instruction for settling a currency payment, including the settlement method to be used, the correspondent bank, any intermediary banks and the ultimate beneficary.


Figure:



Contents:


settlementMethod (zero or one occurrence; of type string, an enumerated domain value defined by settlementMethodScheme)
correspondentInformation (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Routing)
intermediaryInformation (zero or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_IntermediaryInformation)
beneficiaryBank (zero or one occurrence; of type string)
beneficiary (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Routing)
splitSettlement (zero or more occurrences; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_SplitSettlement)


Used by:


settlementInstruction


DTD Fragment:


<!ENTITY % FpML_SettlementInstruction "settlementMethod? , correspondentInformation? , intermediaryInformation* , beneficiaryBank? , beneficiary , splitSettlement*">



FpML_SideRate


Description:

An entity that is used for describing a particular rate against base currency. Exists within FpML_SideRates.


Figure:



Contents:


currency (exactly one occurrence; of type string, an enumerated domain value defined by currencyScheme)
sideRateBasis (exactly one occurrence; of type string, an enumerated domain value defined by sideRateBasisScheme)

  • The method by which the exchange rate against base currency is quoted.


rate (exactly one occurrence; of type decimal)

  • The rate of exchange between the two currencies of the leg of a deal. Must be specified with a quote basis.


spotRate (zero or one occurrence; of type string)

  • An optional element used for FX forwards and certain types of FX OTC options. For deals consumated in the FX Forwards Market, this represents the current market rate for a particular currency pair. For barrier and digital/binary options, it can be useful to include the spot rate at the time the option was executed to make it easier to know whether the option needs to move "up" or "down" to be triggered.


forwardPoints (zero or one occurrence; of type string)

  • An optional element used for deals consumated in the FX Forwards market. Forward points represent the interest rate differential between the two currencies traded and are quoted as a preminum or a discount. Forward points are added to, or subtracted from, the spot rate to create the rate of the forward trade.


Used by:


currency1SideRate
currency2SideRate


DTD Fragment:


<!ENTITY % FpML_SideRate "currency , sideRateBasis , rate , spotRate? , forwardPoints?">



FpML_SideRates


Description:

An entity that is used for including rates against base currency for non-base currency FX contracts.


Figure:



Contents:


baseCurrency (exactly one occurrence; of type string)
currency1SideRate (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_SideRate)
currency2SideRate (zero or one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_SideRate)


Used by:


sideRates


DTD Fragment:


<!ENTITY % FpML_SideRates "baseCurrency , currency1SideRate? , currency2SideRate?">



FpML_SplitSettlement


Description:

An entity that supports the division of a gross settlement amount into a number of split settlements, each requiring its own settlement instruction.


Figure:



Contents:


splitSettlementAmount (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Money)
beneficiaryBank (zero or one occurrence; of type string)
beneficiary (exactly one occurrence; contains the sub-element(s) defined by exactly one occurrence of the entity FpML_Routing)


Used by:


splitSettlement


DTD Fragment:


<!ENTITY % FpML_SplitSettlement "splitSettlementAmount , beneficiaryBank? , beneficiary">



FpML_StreetAddress


Description:

An entity that describes the set of street and building number information that identifies a postal address within a city.


Figure:



Contents:


streetLine (one or more occurrences; of type string)


Used by:


streetAddress


DTD Fragment:


<!ENTITY % FpML_StreetAddress "streetLine+">