## Class FxSingle

• All Implemented Interfaces:
Resolvable<ResolvedFxSingle>, FxProduct, Product, Serializable, org.joda.beans.Bean, org.joda.beans.ImmutableBean

public final class FxSingle
extends Object
implements FxProduct, Resolvable<ResolvedFxSingle>, org.joda.beans.ImmutableBean, Serializable
A single foreign exchange, such as an FX forward or FX spot.

An FX is a financial instrument that represents the exchange of an equivalent amount in two different currencies between counterparties on a specific date. For example, it might represent the payment of USD 1,000 and the receipt of EUR 932.

FX spot and FX forward are essentially equivalent, simply with a different way to obtain the payment date; they are both represented using this class.

Serialized Form
• ### Nested Class Summary

Nested Classes
Modifier and Type Class Description
static class  FxSingle.Meta
The meta-bean for FxSingle.
• ### Field Summary

Fields
Modifier and Type Field Description
static org.joda.beans.ser.SerDeserializer DESERIALIZER
The deserializer, for compatibility.
• ### Method Summary

All Methods
Modifier and Type Method Description
boolean equals​(Object obj)
CurrencyAmount getBaseCurrencyAmount()
Gets the amount in the base currency, positive if receiving, negative if paying.
Payment getBaseCurrencyPayment()
Gets the payment in the base currency, positive if receiving, negative if paying.
CurrencyAmount getCounterCurrencyAmount()
Gets the amount in the counter currency, positive if receiving, negative if paying.
Payment getCounterCurrencyPayment()
Gets the payment in the counter currency, positive if receiving, negative if paying.
CurrencyPair getCurrencyPair()
Gets currency pair of the base currency and counter currency.
CurrencyAmount getPayCurrencyAmount()
Gets the currency amount in which the amount is paid.
LocalDate getPaymentDate()
Gets the last payment date.
Optional<BusinessDayAdjustment> getPaymentDateAdjustment()
Gets the payment date adjustment, optional.
CurrencyAmount getReceiveCurrencyAmount()
Gets the currency amount in which the amount is received.
int hashCode()
static FxSingle.Meta meta()
The meta-bean for FxSingle.
FxSingle.Meta metaBean()
static FxSingle of​(CurrencyAmount amount1, CurrencyAmount amount2, LocalDate paymentDate)
Creates an FxSingle from two amounts and the value date.
static FxSingle of​(CurrencyAmount amount1, CurrencyAmount amount2, LocalDate paymentDate, BusinessDayAdjustment paymentDateAdjustment)
Creates an FxSingle from two amounts and the value date, specifying a date adjustment.
static FxSingle of​(CurrencyAmount amount, FxRate fxRate, LocalDate paymentDate)
Creates an FxSingle using a rate.
static FxSingle of​(CurrencyAmount amount, FxRate fxRate, LocalDate paymentDate, BusinessDayAdjustment paymentDateAdjustment)
Creates an FxSingle using a rate, specifying a date adjustment.
static FxSingle of​(Payment payment1, Payment payment2)
Creates an FxSingle from two payments.
static FxSingle of​(Payment payment1, Payment payment2, BusinessDayAdjustment paymentDateAdjustment)
Creates an FxSingle from two payments, specifying a date adjustment.
ResolvedFxSingle resolve​(ReferenceData refData)
Resolves this object using the specified reference data.
String toString()
• ### Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait
• ### Methods inherited from interface org.joda.beans.Bean

property, propertyNames
• ### Methods inherited from interface com.opengamma.strata.product.fx.FxProduct

allCurrencies, isCrossCurrency
• ### Methods inherited from interface com.opengamma.strata.product.Product

allPaymentCurrencies
• ### Field Detail

• #### DESERIALIZER

public static final org.joda.beans.ser.SerDeserializer DESERIALIZER
The deserializer, for compatibility.
• ### Method Detail

• #### of

public static FxSingle of​(Payment payment1,
Payment payment2)
Creates an FxSingle from two payments.

The payments must be of the correct type, one pay and one receive. The currencies of the payments must differ. The payment dates may differ.

This factory identifies the currency pair of the exchange and assigns the payments to match the base or counter currency of the standardized currency pair. For example, a EUR/USD exchange always has EUR as the base payment and USD as the counter payment.

Parameters:
payment1 - the payment in the first currency
payment2 - the payment in the second currency
Returns:
the FX
• #### of

public static FxSingle of​(Payment payment1,
Payment payment2,
BusinessDayAdjustment paymentDateAdjustment)
Creates an FxSingle from two payments, specifying a date adjustment.

The payments must be of the correct type, one pay and one receive. The currencies of the payments must differ. The payment dates may differ.

This factory identifies the currency pair of the exchange and assigns the payments to match the base or counter currency of the standardized currency pair. For example, a EUR/USD exchange always has EUR as the base payment and USD as the counter payment.

Parameters:
payment1 - the payment in the first currency
payment2 - the payment in the second currency
paymentDateAdjustment - the adjustment to apply to the payment date
Returns:
the FX
• #### of

public static FxSingle of​(CurrencyAmount amount1,
CurrencyAmount amount2,
LocalDate paymentDate)
Creates an FxSingle from two amounts and the value date.

The amounts must be of the correct type, one pay and one receive. The currencies of the payments must differ.

This factory identifies the currency pair of the exchange and assigns the payments to match the base or counter currency of the standardized currency pair. For example, a EUR/USD exchange always has EUR as the base payment and USD as the counter payment.

Parameters:
amount1 - the amount in the first currency
amount2 - the amount in the second currency
paymentDate - the date that the FX settles
Returns:
the FX
• #### of

public static FxSingle of​(CurrencyAmount amount1,
CurrencyAmount amount2,
LocalDate paymentDate,
BusinessDayAdjustment paymentDateAdjustment)
Creates an FxSingle from two amounts and the value date, specifying a date adjustment.

The amounts must be of the correct type, one pay and one receive. The currencies of the payments must differ.

This factory identifies the currency pair of the exchange and assigns the payments to match the base or counter currency of the standardized currency pair. For example, a EUR/USD exchange always has EUR as the base payment and USD as the counter payment.

Parameters:
amount1 - the amount in the first currency
amount2 - the amount in the second currency
paymentDate - the date that the FX settles
paymentDateAdjustment - the adjustment to apply to the payment date
Returns:
the FX
• #### of

public static FxSingle of​(CurrencyAmount amount,
FxRate fxRate,
LocalDate paymentDate)
Creates an FxSingle using a rate.

This creates a single foreign exchange specifying the amount, FX rate and value date. The amount must be specified using one of the currencies of the FX rate.

This factory identifies the currency pair of the exchange and assigns the payments to match the base or counter currency of the standardized currency pair. For example, a EUR/USD exchange always has EUR as the base payment and USD as the counter payment.

Parameters:
amount - the amount being exchanged, positive if being received, negative if being paid
fxRate - the FX rate
paymentDate - the date that the FX settles
Returns:
the FX
Throws:
IllegalArgumentException - if the FX rate and amount do not have a currency in common
• #### of

public static FxSingle of​(CurrencyAmount amount,
FxRate fxRate,
LocalDate paymentDate,
BusinessDayAdjustment paymentDateAdjustment)
Creates an FxSingle using a rate, specifying a date adjustment.

This creates a single foreign exchange specifying the amount, FX rate and value date. The amount must be specified using one of the currencies of the FX rate.

This factory identifies the currency pair of the exchange and assigns the payments to match the base or counter currency of the standardized currency pair. For example, a EUR/USD exchange always has EUR as the base payment and USD as the counter payment.

Parameters:
amount - the amount being exchanged, positive if being received, negative if being paid
fxRate - the FX rate
paymentDate - the date that the FX settles
paymentDateAdjustment - the adjustment to apply to the payment date
Returns:
the FX
Throws:
IllegalArgumentException - if the FX rate and amount do not have a currency in common
• #### getCurrencyPair

public CurrencyPair getCurrencyPair()
Gets currency pair of the base currency and counter currency.

This currency pair is conventional, thus indifferent to the direction of FX.

Specified by:
getCurrencyPair in interface FxProduct
Returns:
the currency pair
• #### getBaseCurrencyAmount

public CurrencyAmount getBaseCurrencyAmount()
Gets the amount in the base currency, positive if receiving, negative if paying.

The amount is signed. A positive amount indicates the payment is to be received. A negative amount indicates the payment is to be paid.

Returns:
the amount
• #### getCounterCurrencyAmount

public CurrencyAmount getCounterCurrencyAmount()
Gets the amount in the counter currency, positive if receiving, negative if paying.

The amount is signed. A positive amount indicates the payment is to be received. A negative amount indicates the payment is to be paid.

Returns:
the amount
• #### getPayCurrencyAmount

public CurrencyAmount getPayCurrencyAmount()
Gets the currency amount in which the amount is paid.

This returns the currency amount whose amount is negative or zero.

Returns:
the pay currency amount

public CurrencyAmount getReceiveCurrencyAmount()
Gets the currency amount in which the amount is received.

This returns the currency amount whose amount is non-negative. If both are zero, counterCurrencyAmount is returned.

Returns:
• #### getPaymentDate

public LocalDate getPaymentDate()
Gets the last payment date.

The payment date is normally the same for the base and counter currencies. If it differs, this method returns the latest of the two dates.

Returns:
the latest payment date
• #### resolve

public ResolvedFxSingle resolve​(ReferenceData refData)
Description copied from interface: Resolvable
Resolves this object using the specified reference data.

This converts the object implementing this interface to the equivalent resolved form. All ReferenceDataId identifiers in this instance will be resolved. The resolved form will typically be a type that is optimized for pricing.

Resolved objects may be bound to data that changes over time, such as holiday calendars. If the data changes, such as the addition of a new holiday, the resolved form will not be updated. Care must be taken when placing the resolved form in a cache or persistence layer.

Specified by:
resolve in interface Resolvable<ResolvedFxSingle>
Parameters:
refData - the reference data to use when resolving
Returns:
the resolved instance
• #### meta

public static FxSingle.Meta meta()
The meta-bean for FxSingle.
Returns:
the meta-bean, not null
• #### metaBean

public FxSingle.Meta metaBean()
Specified by:
metaBean in interface org.joda.beans.Bean
• #### getBaseCurrencyPayment

public Payment getBaseCurrencyPayment()
Gets the payment in the base currency, positive if receiving, negative if paying.

The amount is signed. A positive amount indicates the payment is to be received. A negative amount indicates the payment is to be paid.

The payment date is usually the same as counterCurrencyPayment. It is typically a valid business day, however the businessDayAdjustment property may be used to adjust it.

Returns:
the value of the property, not null
• #### getCounterCurrencyPayment

public Payment getCounterCurrencyPayment()
Gets the payment in the counter currency, positive if receiving, negative if paying.

The amount is signed. A positive amount indicates the payment is to be received. A negative amount indicates the payment is to be paid.

The payment date is usually the same as baseCurrencyPayment. It is typically a valid business day, however the businessDayAdjustment property may be used to adjust it.

Returns:
the value of the property, not null

public Optional<BusinessDayAdjustment> getPaymentDateAdjustment()
Gets the payment date adjustment, optional.

If present, the adjustment will be applied to the payment date.

Returns:
the optional value of the property, not null
• #### equals

public boolean equals​(Object obj)
Overrides:
equals in class Object
• #### hashCode

public int hashCode()
Overrides:
hashCode in class Object
• #### toString

public String toString()
Overrides:
toString in class Object