public final class OvernightFutureSecurity extends Object implements RateIndexSecurity, org.joda.beans.ImmutableBean, Serializable
An Overnight rate future is a financial instrument that is based on the future value of an Overnight index interest rate. The profit or loss of an Overnight rate future is settled daily. This class represents the structure of a single futures contract.
For example, the widely traded "30-Day Federal Funds futures contract" has a notional of 5 million USD, is based on the US Federal Funds Effective Rate 'USD-FED-FUND', expiring the last business day of each month.
(100 - percentRate).
Strata uses decimal prices for Overnight rate futures in the trade model, pricers and market data. The decimal price is based on the decimal rate equivalent to the percentage. For example, a price of 99.32 implies an interest rate of 0.68% which is represented in Strata by 0.9932.
| Modifier and Type | Class and Description |
|---|---|
static class |
OvernightFutureSecurity.Builder
The bean-builder for
OvernightFutureSecurity. |
static class |
OvernightFutureSecurity.Meta
The meta-bean for
OvernightFutureSecurity. |
| Modifier and Type | Method and Description |
|---|---|
static OvernightFutureSecurity.Builder |
builder()
Returns a builder used to create an instance of the bean.
|
OvernightFuturePosition |
createPosition(PositionInfo positionInfo,
double longQuantity,
double shortQuantity,
ReferenceData refData)
Creates a position based on this security from a long and short quantity.
|
OvernightFuturePosition |
createPosition(PositionInfo positionInfo,
double quantity,
ReferenceData refData)
Creates a position based on this security from a net quantity.
|
OvernightFuture |
createProduct(ReferenceData refData)
Creates the product associated with this security.
|
OvernightFutureTrade |
createTrade(TradeInfo info,
double quantity,
double tradePrice,
ReferenceData refData)
Creates a trade based on this security.
|
boolean |
equals(Object obj) |
double |
getAccrualFactor()
Gets the accrual factor, defaulted from the index if not set.
|
OvernightAccrualMethod |
getAccrualMethod()
Gets the method of accruing Overnight interest.
|
Currency |
getCurrency()
Gets the currency that the security is traded in.
|
LocalDate |
getEndDate()
Gets the last date of the rate calculation period.
|
OvernightIndex |
getIndex()
Gets the underlying Overnight index.
|
SecurityInfo |
getInfo()
Gets the standard security information.
|
LocalDate |
getLastTradeDate()
Gets the last date of trading.
|
double |
getNotional()
Gets the notional amount.
|
Rounding |
getRounding()
Gets the definition of how to round the futures price, defaulted to no rounding.
|
LocalDate |
getStartDate()
Gets the first date of the rate calculation period.
|
ImmutableSet<SecurityId> |
getUnderlyingIds()
Gets the set of underlying security identifiers.
|
int |
hashCode() |
static OvernightFutureSecurity.Meta |
meta()
The meta-bean for
OvernightFutureSecurity. |
OvernightFutureSecurity.Meta |
metaBean() |
OvernightFutureSecurity.Builder |
toBuilder()
Returns a builder that allows this bean to be mutated.
|
String |
toString() |
OvernightFutureSecurity |
withInfo(SecurityInfo info)
Returns an instance with the specified info.
|
clone, finalize, getClass, notify, notifyAll, wait, wait, waitgetSecurityIdpublic Currency getCurrency()
SecuritygetCurrency in interface Securitypublic ImmutableSet<SecurityId> getUnderlyingIds()
SecurityThe set must contain all the security identifiers that this security directly refers to. For example, a bond future will return the identifiers of the underlying basket of bonds, but a bond future option will only return the identifier of the underlying future, not the basket.
getUnderlyingIds in interface Securitypublic OvernightFutureSecurity withInfo(SecurityInfo info)
SecuritywithInfo in interface RateIndexSecuritywithInfo in interface Securityinfo - the new infopublic OvernightFuture createProduct(ReferenceData refData)
SecurityThe product of a security is distinct from the security. The product includes the financial details from this security, but excludes the additional information. The product also includes the products of any underlying securities.
createProduct in interface SecurityrefData - the reference data used to find underlying securitiespublic OvernightFutureTrade createTrade(TradeInfo info, double quantity, double tradePrice, ReferenceData refData)
SecurityThis creates a trade of a suitable type for this security.
createTrade in interface Securityinfo - the trade informationquantity - the number of contracts in the tradetradePrice - the price agreed when the trade occurredrefData - the reference data used to find underlying securitiespublic OvernightFuturePosition createPosition(PositionInfo positionInfo, double quantity, ReferenceData refData)
SecurityThis creates a position of a suitable type for this security.
createPosition in interface SecuritypositionInfo - the position informationquantity - the number of contracts in the positionrefData - the reference data used to find underlying securitiespublic OvernightFuturePosition createPosition(PositionInfo positionInfo, double longQuantity, double shortQuantity, ReferenceData refData)
SecurityThis creates a position of a suitable type for this security.
The long quantity and short quantity must be zero or positive, not negative.
createPosition in interface SecuritypositionInfo - the position informationlongQuantity - the long quantity in the positionshortQuantity - the short quantity in the positionrefData - the reference data used to find underlying securitiespublic static OvernightFutureSecurity.Meta meta()
OvernightFutureSecurity.public static OvernightFutureSecurity.Builder builder()
public OvernightFutureSecurity.Meta metaBean()
metaBean in interface org.joda.beans.Beanpublic SecurityInfo getInfo()
This includes the security identifier.
public double getNotional()
This is the full notional of the deposit, such as 5 million dollars. The notional expressed here must be positive. The currency of the notional the same as the currency of the index.
public double getAccrualFactor()
This is the year fraction of the contract, typically 1/12 for a 30-day future. As such, it is often unrelated to the day count of the index. The year fraction must be positive.
public LocalDate getLastTradeDate()
This must be a valid business day on the fixing calendar of index.
For example, the last trade date is often the last business day of the month.
public LocalDate getStartDate()
This is not necessarily a valid business day on the fixing calendar of index.
However, it will be adjusted in OvernightRateComputation if needed.
public LocalDate getEndDate()
This is not necessarily a valid business day on the fixing calendar of index.
However, it will be adjusted in OvernightRateComputation if needed.
public OvernightIndex getIndex()
The future is based on this index. It will be a well known market index such as 'USD-FED-FUND'.
getIndex in interface RateIndexSecuritypublic OvernightAccrualMethod getAccrualMethod()
The average rate is calculated based on this method over the period between startDate and endDate.
public Rounding getRounding()
The price is represented in decimal form, not percentage form. As such, the decimal places expressed by the rounding refers to this decimal form. For example, the common market price of 99.7125 for a 0.2875% rate is represented as 0.997125 which has 6 decimal places.
public OvernightFutureSecurity.Builder toBuilder()
Copyright 2009-Present by OpenGamma Inc. and individual contributors
Apache v2 licensed
Additional documentation can be found at strata.opengamma.io.