fpml:commodityForward

Defines a commodity forward 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:valueDate [0..1]    Specifies the value date of the Commodity Forward Transaction. This is the day on which both the cash and the physical commodity settle.
  2. Choice [1..1]
     • fpml:fixedLeg    The fixed leg of a Commodity Forward Transaction.
     • fpml:averagePriceLeg    Specifies the calculated floating price leg of a Commodity Forward Transaction.
  3. Choice [1..1]
     from subst. group fpml:commodityForwardLeg
     fpml:bullionPhysicalLeg    The physical leg of a Commodity Forward Transaction for which the underlyer is Bullion.
     fpml:metalPhysicalLeg    Physically settled metal products leg.

Attributes

Used in

• Group fpml:CommodityPhysicalOption.model
• Type fpml:Strategy
• Type fpml:PhysicalSettlement (Element fpml:physicalSettlement)
• Type fpml:CommodityOption via reference to fpml:CommodityPhysicalOption.model (Element fpml:commodityOption)
• 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:commodityForward

Sample instance

<fpml:commodityForward>
   <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:valueDate>
      <fpml:adjustableDate>
         <fpml:unadjustedDate>2000-01-01</fpml:unadjustedDate>
      </fpml:adjustableDate>
   </fpml:valueDate>
   <fpml:fixedLeg>
      <fpml:fixedPrice>
         <fpml:price>1.0</fpml:price>
         <fpml:priceCurrency>normalizedString</fpml:priceCurrency>
         <fpml:priceUnit>normalizedString</fpml:priceUnit>
      </fpml:fixedPrice>
      <fpml:totalPrice>
         <fpml:currency>normalizedString</fpml:currency>
         <fpml:amount>1.0</fpml:amount>
      </fpml:totalPrice>
   </fpml:fixedLeg>
   <fpml:bullionPhysicalLeg>
      <fpml:bullionType>Gold</fpml:bullionType>
      <fpml:deliveryLocation>normalizedString</fpml:deliveryLocation>
      <fpml:totalPhysicalQuantity>
         <fpml:quantityUnit>normalizedString</fpml:quantityUnit>
         <fpml:quantity>1.0</fpml:quantity>
      </fpml:totalPhysicalQuantity>
      <fpml:settlementDate>
         <fpml:adjustableDate>...
         </fpml:adjustableDate>
      </fpml:settlementDate>
   </fpml:bullionPhysicalLeg>
</fpml:commodityForward>