Files
quantconnect--lean/Common/Securities/MaintenanceMarginParameters.cs
2026-07-13 13:02:50 +08:00

118 lines
4.3 KiB
C#

/*
* 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
{
/// <summary>
/// Parameters for <see cref="IBuyingPowerModel.GetMaintenanceMargin"/>
/// </summary>
public class MaintenanceMarginParameters
{
/// <summary>
/// Gets the security
/// </summary>
public Security Security { get; }
/// <summary>
/// Gets the quantity of the security
/// </summary>
public decimal Quantity { get; }
/// <summary>
/// Gets the absolute quantity of the security
/// </summary>
public decimal AbsoluteQuantity => Math.Abs(Quantity);
/// <summary>
/// Gets the holdings cost of the security
/// </summary>
public decimal HoldingsCost { get; }
/// <summary>
/// Gets the absolute holdings cost of the security
/// </summary>
public decimal AbsoluteHoldingsCost => Math.Abs(HoldingsCost);
/// <summary>
/// Gets the holdings value of the security
/// </summary>
public decimal HoldingsValue { get; }
/// <summary>
/// Gets the absolute holdings value of the security
/// </summary>
public decimal AbsoluteHoldingsValue => Math.Abs(HoldingsValue);
/// <summary>
/// Initializes a new instance of the <see cref="MaintenanceMarginParameters"/> class
/// </summary>
/// <param name="security">The security</param>
/// <param name="quantity">The quantity</param>
/// <param name="holdingsCost">The holdings cost</param>
/// <param name="holdingsValue">The holdings value</param>
public MaintenanceMarginParameters(
Security security,
decimal quantity,
decimal holdingsCost,
decimal holdingsValue
)
{
Security = security;
Quantity = quantity;
HoldingsCost = holdingsCost;
HoldingsValue = holdingsValue;
}
/// <summary>
/// Creates a new instance of the <see cref="MaintenanceMarginParameters"/> class to compute the maintenance margin
/// required to support the algorithm's current holdings
/// </summary>
public static MaintenanceMarginParameters ForCurrentHoldings(Security security)
{
return new MaintenanceMarginParameters(security,
security.Holdings.Quantity,
security.Holdings.HoldingsCost,
security.Holdings.HoldingsValue
);
}
/// <summary>
/// Creates a new instance of the <see cref="MaintenanceMarginParameters"/> class to compute the maintenance margin
/// required to support the specified quantity of holdings at current market prices
/// </summary>
public static MaintenanceMarginParameters ForQuantityAtCurrentPrice(Security security, decimal quantity)
{
var value = security.Holdings.GetQuantityValue(quantity).InAccountCurrency;
return new MaintenanceMarginParameters(security, quantity, value, value);
}
/// <summary>
/// Creates a new instance of <see cref="MaintenanceMarginParameters"/> for the security's underlying
/// </summary>
public MaintenanceMarginParameters ForUnderlying(decimal quantity)
{
var derivative = Security as IDerivativeSecurity;
if (derivative == null)
{
throw new InvalidOperationException(Messages.MaintenanceMarginParameters.ForUnderlyingOnlyInvokableForIDerivativeSecurity);
}
return ForQuantityAtCurrentPrice(derivative.Underlying, quantity);
}
}
}