/*
* QUANTCONNECT.COM - Democratizing Finance, Empowering Individuals.
* Lean Algorithmic Trading Engine v2.0. Copyright 2014 QuantConnect Corporation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
using System;
namespace QuantConnect.Securities
{
///
/// Parameters for
///
public class MaintenanceMarginParameters
{
///
/// Gets the security
///
public Security Security { get; }
///
/// Gets the quantity of the security
///
public decimal Quantity { get; }
///
/// Gets the absolute quantity of the security
///
public decimal AbsoluteQuantity => Math.Abs(Quantity);
///
/// Gets the holdings cost of the security
///
public decimal HoldingsCost { get; }
///
/// Gets the absolute holdings cost of the security
///
public decimal AbsoluteHoldingsCost => Math.Abs(HoldingsCost);
///
/// Gets the holdings value of the security
///
public decimal HoldingsValue { get; }
///
/// Gets the absolute holdings value of the security
///
public decimal AbsoluteHoldingsValue => Math.Abs(HoldingsValue);
///
/// Initializes a new instance of the class
///
/// The security
/// The quantity
/// The holdings cost
/// The holdings value
public MaintenanceMarginParameters(
Security security,
decimal quantity,
decimal holdingsCost,
decimal holdingsValue
)
{
Security = security;
Quantity = quantity;
HoldingsCost = holdingsCost;
HoldingsValue = holdingsValue;
}
///
/// Creates a new instance of the class to compute the maintenance margin
/// required to support the algorithm's current holdings
///
public static MaintenanceMarginParameters ForCurrentHoldings(Security security)
{
return new MaintenanceMarginParameters(security,
security.Holdings.Quantity,
security.Holdings.HoldingsCost,
security.Holdings.HoldingsValue
);
}
///
/// Creates a new instance of the class to compute the maintenance margin
/// required to support the specified quantity of holdings at current market prices
///
public static MaintenanceMarginParameters ForQuantityAtCurrentPrice(Security security, decimal quantity)
{
var value = security.Holdings.GetQuantityValue(quantity).InAccountCurrency;
return new MaintenanceMarginParameters(security, quantity, value, value);
}
///
/// Creates a new instance of for the security's underlying
///
public MaintenanceMarginParameters ForUnderlying(decimal quantity)
{
var derivative = Security as IDerivativeSecurity;
if (derivative == null)
{
throw new InvalidOperationException(Messages.MaintenanceMarginParameters.ForUnderlyingOnlyInvokableForIDerivativeSecurity);
}
return ForQuantityAtCurrentPrice(derivative.Underlying, quantity);
}
}
}