Contents

Introduction
Active Securities

Algorithm Reference

Securities and Portfolio

Securities and Portfolio

Demonstration Algorithm
AddRemoveSecurityRegressionAlgorithm.py Python AddRemoveSecurityRegressionAlgorithm.cs C#

Introduction

Algorithms have a Securities property that stores a Security object for each asset in your algorithm. Security objects hold the models (backtesting behaviors) and properties of an asset. Each security can be completely customized to behave as you'd like. Securities is a Dictionary<Symbol, Security> so you can access your Security objects with their ticker Securities["IBM"].Price. 

// Popular Securities Property Values:
Securities["IBM"].HasData           // Security has data
                 .Invested          // Have holdings
                 .LocalTime         // Time on the asset exchange
                 .Holdings          // Portfolio object
                 .Exchange          // Exchange information
                 .FeeModel;         // Fee model setter

// Popular Securities Property Values:
self.Securities["IBM"].HasData           # Security has data
                 .Invested          # Have holdings
                 .LocalTime         # Time on the asset exchange
                 .Holdings          # Portfolio object
                 .Exchange          # Exchange information
                 .FeeModel;         # Fee model setter

Security objects also carry all the models for creating realistic backtests. These models are set via the public security properties and then used in LEAN to improve your backtest realism.

The Portfolio property is a collection of SecurityHolding objects to provide easy access to the holding properties. This property also provides information about the whole portfolio state: 

// Popular Portfolio Property Values:
Portfolio.Invested                // Hold at least one stock
         .Cash                    // Sum of all currencies in account (only unsettled cash)
         .UnsettledCash           // Sum of all currencies in account (only settled cash)
         .TotalFees               // Fees incurred since backtest start
         .TotalHoldingsValue      // Absolute sum portfolio items
         .MarginRemaining         // Remaining margin on the account
         .TotalMarginUsed         // Sum of margin used across all securities
         .TotalPortfolioValue     // Portfolio equity
         .TotalProfit             // Sum of all gross profit
         .TotalUnrealizedProfit   // Holdings profit/loss

// Popular Portfolio Property Values:
self.Portfolio.Invested                # Hold at least one stock
              .Cash                    # Sum of all currencies in account (only settled cash)
              .UnsettledCash           # Sum of all currencies in account (only unsettled cash)
              .TotalFees               # Fees incurred since backtest start
              .TotalHoldingsValue      # Absolute sum portfolio items
              .MarginRemaining         # Remaining margin on the account
              .TotalMarginUsed         # Sum of margin used across all securities
              .TotalPortfolioValue     # Portfolio equity
              .TotalProfit             # Sum of all gross profit
              .TotalUnrealizedProfit   # Holdings profit/loss

The Portfolio class is a Dictionary<Symbol, SecurityHolding>, so it can be accessed via ticker index: Portfolio["IBM"].IsLong 

// Popular Portfolio Property Values:
Portfolio["IBM"].Invested
                .IsLong            // IsLong, IsShort Holdings.
                .Quantity          // Shares held.
                .UnrealizedProfit; // Holdings profit/loss
                .TotalFees         // Fees incurred since backtest start
                .Price;            // Asset price

// Popular Portfolio Property Values:
self.Portfolio["IBM"].Invested
                .IsLong            # IsLong, IsShort Holdings.
                .Quantity          # Shares held.
                .UnrealizedProfit; # Holdings profit/loss
                .TotalFees         # Fees incurred since backtest start
                .Price;            # Asset price

Detailed information on these classes can be found in the LEAN documentation. Check out the Security (Securities objects), SecurityPortfolioManager class, and SecurityHolding (Portfolio objects) classes. 

//Access to Security Objects with Securities:
Securities["IBM"].Price

//Security object properties:
class Security {
    Resolution Resolution;
    bool HasData;
    bool Invested;
    DateTime LocalTime;
    SecurityHolding Holdings;
    SecurityExchange Exchange;
    IFeeModel FeeModel;
    IFillModel FillModel;
    ISlippageModel SlippageModel;
    ISecurityPortfolioModel PortfolioModel;
    ISecurityMarginModel MarginModel;
    ISettlementModel SettlementModel;
    IVolatilityModel VolatilityModel;
    ISecurityDataFilter DataFilter;
}

#Access to Security Objects with Securities:
self.Securities["IBM"].Price

#Security object properties:
class Security {
    Resolution Resolution;
    bool HasData;
    bool Invested;
    DateTime LocalTime;
    SecurityHolding Holdings;
    SecurityExchange Exchange;
    IFeeModel FeeModel;
    IFillModel FillModel;
    ISlippageModel SlippageModel;
    ISecurityPortfolioModel PortfolioModel;
    ISecurityMarginModel MarginModel;
    ISettlementModel SettlementModel;
    IVolatilityModel VolatilityModel;
    ISecurityDataFilter DataFilter;
}

Active Securities

The ActiveSecurities lets you select the assets currently in your universe. This is useful for iterating over those securities from your universe selection. It has all the same properties as the Securities collection. 

// Securities currently in the universe:
ActiveSecurities["IBM"].HasData           // Security has data
                 .Invested          // Have holdings
                 .LocalTime         // Time on the asset exchange
                 .Holdings          // Portfolio object
                 .Exchange          // Exchange information
                 .FeeModel;         // Fee model setter

# Securities currently in the universe:
self.ActiveSecurities["IBM"].HasData           # Security has data
                 .Invested          # Have holdings
                 .LocalTime         # Time on the asset exchange
                 .Holdings          # Portfolio object
                 .Exchange          # Exchange information
                 .FeeModel;         # Fee model setter

You can also see our Tutorials and Videos. You can also get in touch with us via Discord.

Did you find this page helpful?

Contribute to the documentation: