# XML Schema Documentation

### Element: fxAverageRateOption

#### [Table of contents]

This element can be used wherever the following element is referenced: product

Name | fxAverageRateOption
Type | FxAverageRateOption
Nillable | no
Abstract | no
Documentation | A component describing an FX Average Rate Option product.

Logical Diagram
XML Instance Representation
<fxAverageRateOption
id=" xsd:ID [0..1]">
<productType> ProductType </productType> [0..*]

'A classification of the type of product. FpML defines a simple product categorization using a coding scheme.'

<productId> ProductId </productId> [0..*]

'A product reference identifier allocated by a party. FpML does not define the domain values associated with this element. Note that the domain values for this element are not strictly an enumerated list.'

<buyerPartyReference> PartyOrTradeSideReference </buyerPartyReference> [1]

'A reference to the party that buys this instrument, ie. pays for this instrument and receives the rights defined by it. See 2000 ISDA definitions Article 11.1 (b). In the case of FRAs this the fixed rate payer.'

<sellerPartyReference> PartyOrTradeSideReference </sellerPartyReference> [1]

'A reference to the party that sells (\"writes\") this instrument, i.e. that grants the rights defined by this instrument and in return receives a payment for it. See 2000 ISDA definitions Article 11.1 (a). In the case of FRAs this is the floating rate payer.'

<expiryDateTime> ExpiryDateTime </expiryDateTime> [1]

'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.'

<exerciseStyle> ExerciseStyleEnum </exerciseStyle> [1]

'The manner in which the option can be exercised.'

<fxOptionPremium> FxOptionPremium </fxOptionPremium> [0..*]

'Premium amount or premium installment amount for an option.'

<valueDate> xsd:date </valueDate> [1]

'The date on which both currencies traded will settle.'

<putCurrencyAmount> Money </putCurrencyAmount> [1]

'The currency amount that the option gives the right to sell.'

<callCurrencyAmount> Money </callCurrencyAmount> [1]

'The currency amount that the option gives the right to buy.'

<fxStrikePrice> FxStrikePrice </fxStrikePrice> [1]

'TBA'

<spotRate> xsd:decimal </spotRate> [0..1]

'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.'

<payoutCurrency> Currency </payoutCurrency> [1]

'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> StrikeQuoteBasisEnum </averageRateQuoteBasis> [1]

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

<precision> xsd:nonNegativeInteger </precision> [0..1]

'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> xsd:string </payoutFormula> [0..1]

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

<primaryRateSource> InformationSource </primaryRateSource> [1]

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

<secondaryRateSource> InformationSource </secondaryRateSource> [0..1]

'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> BusinessCenterTime </fixingTime> [1]

'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:00am London time.'

Start Choice [1]
<averageRateObservationSchedule> FxAverageRateObservationSchedule </averageRateObservationSchedule> [1]

'Parametric schedule of rate observations.'

<averageRateObservationDate> FxAverageRateObservationDate </averageRateObservationDate> [1..*]

'One of more specific rate observation dates.'

End Choice
<observedRates> ObservedRates </observedRates> [0..*]

'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.'

</fxAverageRateOption>
Diagram
Schema Component Representation
<xsd:element name="fxAverageRateOption" type=" FxAverageRateOption " substitutionGroup="product"/>