fpml:commoditySwaption

Defines a commodity swaption product

Element information

Content

• Sequence [1..1]
  from type fpml:Product
  from group fpml:Product.model
  Sequence [0..1]
  1. fpml:primaryAssetClass [0..1]    A classification of the most important risk class of the trade. FpML defines a simple asset class categorization using a coding scheme.
  2. fpml:secondaryAssetClass [0..*]    A classification of additional risk classes of the trade, if any. FpML defines a simple asset class categorization using a coding scheme.
  3. fpml:productType [0..*]    A classification of the type of product. FpML defines a simple product categorization using a coding scheme.
  4. fpml:productId [0..*]    A product reference identifier. The product ID is an identifier that describes the key economic characteristics of the trade type, with the exception of concepts such as size (notional, quantity, number of units) and price (fixed rate, strike, etc.) that are negotiated for each transaction. It can be used to hold identifiers such as the "UPI" (universal product identifier) required by certain regulatory reporting rules. It can also be used to hold identifiers of benchmark products or product temnplates used by certain trading systems or facilities. 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.
  5. fpml:embeddedOptionType [0..2]    Describes the type of any embedded optionality in the transaction that might not otherwise be apparent. Can be used to represent embedded optionality such as early termination provisions, extendible provisions, or cancelable provisions, etc., where applicable. If omitted, no embedded optionality is applicable.
  1. fpml:optionType [1..1]    The type of option transaction.
  2. fpml:commoditySwap [1..1]    The underlying commodity swap definiton.
  3. fpml:physicalExercise [1..1]    The parameters for defining how the commodity option can be exercised into a physical transaction.
  4. fpml:premium [1..1]    The option premium payable by the buyer to the seller.

Attributes

Used in

• Type fpml:Strategy
• Type fpml:PhysicalSettlement (Element fpml:physicalSettlement)
• Type fpml:Trade (Elements fpml:trade, fpml:originalTrade, fpml:resultingTrade, fpml:trade, fpml:originalTrade, fpml:oldTrade, fpml:trade, fpml:feeTrade, fpml:newTrade, fpml:oldTrade, fpml:trade, fpml:trade)

Substitution hierarchy

• fpml:product
  • can be substituted with fpml:commoditySwaption

Sample instance

<fpml:commoditySwaption>
   <fpml:primaryAssetClass>normalizedString</fpml:primaryAssetClass>
   <fpml:secondaryAssetClass>normalizedString</fpml:secondaryAssetClass>
   <fpml:productType>normalizedString</fpml:productType>
   <fpml:productId>normalizedString</fpml:productId>
   <fpml:embeddedOptionType>normalizedString</fpml:embeddedOptionType>
   <fpml:optionType>Put</fpml:optionType>
   <fpml:commoditySwap>
      <fpml:effectiveDate>
         <fpml:adjustableDate>...
         </fpml:adjustableDate>
      </fpml:effectiveDate>
      <fpml:terminationDate>
         <fpml:adjustableDate>...
         </fpml:adjustableDate>
      </fpml:terminationDate>
      <fpml:settlementCurrency>normalizedString</fpml:settlementCurrency>
      <fpml:coalPhysicalLeg>
         <fpml:coal>...
         </fpml:coal>
         <fpml:deliveryConditions>...
         </fpml:deliveryConditions>
         <fpml:deliveryQuantity>...
         </fpml:deliveryQuantity>
      </fpml:coalPhysicalLeg>
   </fpml:commoditySwap>
   <fpml:physicalExercise>
      <fpml:americanExercise>
         <fpml:commencementDates>...
         </fpml:commencementDates>
         <fpml:expirationDates>...
         </fpml:expirationDates>
      </fpml:americanExercise>
   </fpml:physicalExercise>
   <fpml:premium>
      <fpml:paymentAmount>
         <fpml:currency>normalizedString</fpml:currency>
         <fpml:amount>1.0</fpml:amount>
      </fpml:paymentAmount>
      <fpml:premiumPerUnit>
         <fpml:currency>normalizedString</fpml:currency>
         <fpml:amount>1.0</fpml:amount>
      </fpml:premiumPerUnit>
   </fpml:premium>
</fpml:commoditySwaption>