Module Daml.Finance.Instrument.Swap.Asset.Instrument


template Instrument

This template models an asset swap. It pays an asset performance vs a fix interest rate at the end of every payment period. It can be used to model equity swaps, some types of commodity swaps (of the form performance vs rate) and swaps with the same payoff on other asset types. The asset leg is described by an observable containing either unadjusted or adjusted fixings (for a price return or a total return swap, respectively). The template calculates the performance for each payment period using this observable. For example: AAPL total return vs 2.5% fix.

Field Type Description
depository Party The depository of the instrument.
issuer Party The issuer of the instrument.
id Id An identifier of the instrument.
version Text The instrument’s version.
description Text A description of the instrument.
referenceAssetId Text The reference asset ID. For example, in case of "AAPL total return vs 2.5% fix" this should be a valid reference to the AAPL fixings to be used for the total return calculation (dividend-adjusted fixings).
ownerReceivesFix Bool Indicate whether a holding owner of this instrument receives the fix or the asset leg of the swap.
fixRate Decimal The interest rate of the fix leg. For example, in case of "AAPL total return vs 2.5% fix" this should be 0.025.
periodicSchedule PeriodicSchedule The schedule for the periodic swap payments.
holidayCalendarIds [Text] The identifiers of the holiday calendars to be used for the swap payment schedule.
calendarDataProvider Party The reference data provider to use for the holiday calendar.
dayCountConvention DayCountConventionEnum The day count convention used to calculate day count fractions. For example: Act360.
currency InstrumentKey The currency of the swap. For example, if the swap pays in USD this should be a USD cash instrument.
observers PartiesMap The observers of the instrument.
lastEventTimestamp Time (Market) time of the last recorded lifecycle event. If no event has occurred yet, the time of creation should be used.

Data Types

type T

= Instrument

Type synonym for Instrument.