Writing Algorithms

API Reference

Introduction

QCAlgorithm

class QuantConnect.Algorithm.QCAlgorithm[source]

QC Algorithm Base Class - Handle the basic requirements of a trading algorithm, allowing user to focus on event methods. The QCAlgorithm class implements Portfolio, Securities, Transactions and Data Subscription Management.

Adding Data

Adding Data

add_cfd(ticker, resolution=None, market=None, fill_forward=True, leverage=0.0)[source]

Creates and adds a new Cfd security to the algorithm

Parameters:
  • ticker (str) — The currency pair
  • resolution (Resolution, optional)
  • market (str, optional)
  • fill_forward (bool, optional)
  • leverage (float, optional)
Returns:

The new Cfd security

Return type:

Cfd

add_crypto(ticker, resolution=None, market=None, fill_forward=True, leverage=0.0)[source]

Creates and adds a new Crypto security to the algorithm

Parameters:
  • ticker (str) — The currency pair
  • resolution (Resolution, optional)
  • market (str, optional)
  • fill_forward (bool, optional)
  • leverage (float, optional)
Returns:

The new Crypto security

Return type:

Crypto

add_crypto_future(ticker, resolution=None, market=None, fill_forward=True, leverage=0.0)[source]

Creates and adds a new CryptoFuture security to the algorithm

Parameters:
  • ticker (str) — The currency pair
  • resolution (Resolution, optional)
  • market (str, optional)
  • fill_forward (bool, optional)
  • leverage (float, optional)
Returns:

The new CryptoFuture security

Return type:

CryptoFuture

add_data(type, ticker, properties, exchange_hours, resolution, fill_forward, leverage=1.0)[source]

AddDataT a new user defined data source, requiring only the minimum config options. The data is added with a default time zone of NewYork (Eastern Daylight Savings Time)

Parameters:
  • type (PyObject) — Data source type
  • ticker (str) — KeyTicker for data
  • properties (SymbolProperties) — The properties of this new custom data
  • exchange_hours (SecurityExchangeHours) — The Exchange hours of this symbol
  • resolution (0, Culture=neutral, PublicKeyToken=null]]) — Resolution of the Data Required
  • fill_forward (bool) — When no data available on a tradebar, return the last data that was generated
  • leverage (float, optional) — Custom leverage per security
Returns:

The new Security

Return type:

Security

add_data(type, ticker, resolution, time_zone, fill_forward, leverage=1.0)[source]

AddDataT a new user defined data source, requiring only the minimum config options. The data is added with a default time zone of NewYork (Eastern Daylight Savings Time)

Parameters:
  • type (PyObject) — Data source type
  • ticker (str) — KeyTicker for data
  • resolution (0, Culture=neutral, PublicKeyToken=null]]) — Resolution of the Data Required
  • time_zone (datetimeZone) — Specifies the time zone of the raw data
  • fill_forward (bool) — When no data available on a tradebar, return the last data that was generated
  • leverage (float, optional) — Custom leverage per security
Returns:

The new Security

Return type:

Security

add_data(type, underlying, resolution, time_zone, fill_forward, leverage=1.0)[source]

AddDataT a new user defined data source, requiring only the minimum config options. The data is added with a default time zone of NewYork (Eastern Daylight Savings Time)

Parameters:
  • type (PyObject) — Data source type
  • underlying (Symbol) — The underlying symbol for the custom data
  • resolution (0, Culture=neutral, PublicKeyToken=null]]) — Resolution of the Data Required
  • time_zone (datetimeZone) — Specifies the time zone of the raw data
  • fill_forward (bool) — When no data available on a tradebar, return the last data that was generated
  • leverage (float, optional) — Custom leverage per security
Returns:

The new Security

Return type:

Security

add_data(data_type, ticker, resolution, time_zone, fill_forward, leverage=1.0)[source]

AddDataT a new user defined data source, requiring only the minimum config options. The data is added with a default time zone of NewYork (Eastern Daylight Savings Time)

Parameters:
  • data_type (Type) — Data source type
  • ticker (str) — KeyTicker for data
  • resolution (0, Culture=neutral, PublicKeyToken=null]]) — Resolution of the Data Required
  • time_zone (datetimeZone) — Specifies the time zone of the raw data
  • fill_forward (bool) — When no data available on a tradebar, return the last data that was generated
  • leverage (float, optional) — Custom leverage per security
Returns:

The new Security

Return type:

Security

add_data(data_type, underlying, resolution, time_zone, fill_forward, leverage=1.0)[source]

AddDataT a new user defined data source, requiring only the minimum config options. The data is added with a default time zone of NewYork (Eastern Daylight Savings Time)

Parameters:
  • data_type (Type) — Data source type
  • underlying (Symbol)
  • resolution (0, Culture=neutral, PublicKeyToken=null]]) — Resolution of the Data Required
  • time_zone (datetimeZone) — Specifies the time zone of the raw data
  • fill_forward (bool) — When no data available on a tradebar, return the last data that was generated
  • leverage (float, optional) — Custom leverage per security
Returns:

The new Security

Return type:

Security

add_equity(ticker, resolution=None, market=None, fill_forward=True, leverage=0.0, extended_market_hours=False, data_normalization_mode=None)[source]

Creates and adds a new Equity security to the algorithm

Parameters:
  • ticker (str) — The equity ticker symbol
  • resolution (Resolution, optional)
  • market (str, optional)
  • fill_forward (bool, optional)
  • leverage (float, optional)
  • extended_market_hours (bool, optional)
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the equity
Returns:

The new Equity security

Return type:

Equity

add_forex(ticker, resolution=None, market=None, fill_forward=True, leverage=0.0)[source]

Creates and adds a new Forex security to the algorithm

Parameters:
  • ticker (str) — The currency pair
  • resolution (Resolution, optional)
  • market (str, optional)
  • fill_forward (bool, optional)
  • leverage (float, optional)
Returns:

The new Forex security

Return type:

Forex

add_future(ticker, resolution=None, market=None, fill_forward=True, leverage=0.0, extended_market_hours=False, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=0)[source]

Creates and adds a new Future security to the algorithm

Parameters:
  • ticker (str) — The future ticker
  • resolution (Resolution, optional)
  • market (str, optional)
  • fill_forward (bool, optional)
  • leverage (float, optional)
  • extended_market_hours (bool, optional) — Use extended market hours data
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the continuous future contract
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the continuous future contract
  • contract_depth_offset (int, optional) — The continuous future contract desired offset from the current front month. For example, 0 (default) will use the front month, 1 will use the back month contract
Returns:

The new Future security

Return type:

Future

add_future_contract(symbol, resolution=None, fill_forward=True, leverage=0.0, extended_market_hours=False)[source]

Creates and adds a new single Future contract to the algorithm

Parameters:
  • symbol (Symbol) — The futures contract symbol
  • resolution (Resolution, optional)
  • fill_forward (bool, optional)
  • leverage (float, optional)
  • extended_market_hours (bool, optional) — Use extended market hours data
Returns:

The new Future security

Return type:

Future

add_future_option(future_symbol, option_filter)[source]

Creates and adds a new Future Option contract to the algorithm.

Parameters:
  • future_symbol (Symbol) — )
  • option_filter (PyObject) — Filter to apply to option contracts loaded as part of the universe
add_future_option(symbol, option_filter=None)[source]

Creates and adds a new Future Option contract to the algorithm.

Parameters:
  • symbol (Symbol) — )
  • option_filter (Callable[OptionFilterUniverse, OptionFilterUniverse], optional) — Filter to apply to option contracts loaded as part of the universe
add_future_option_contract(symbol, resolution=None, fill_forward=True, leverage=0.0, extended_market_hours=False)[source]

Adds a future option contract to the algorithm.

Parameters:
  • symbol (Symbol) — Option contract Symbol
  • resolution (Resolution, optional) — Resolution of the option contract, i.e. the granularity of the data
  • fill_forward (bool, optional) — If true, this will fill in missing data points with the previous data point
  • leverage (float, optional) — The leverage to apply to the option contract
  • extended_market_hours (bool, optional) — Use extended market hours data
Returns:

Option security

Return type:

Option

add_index(ticker, resolution=None, market=None, fill_forward=True)[source]

Creates and adds index options to the algorithm.

Parameters:
  • ticker (str) — The currency pair
  • resolution (Resolution, optional)
  • market (str, optional)
  • fill_forward (bool, optional)
Returns:

The new Index security

Return type:

Index

add_index_option(ticker, resolution=None, market=usa, fill_forward=True)[source]

Creates and adds index options to the algorithm.

Parameters:
  • ticker (str) — The ticker of the Index Option
  • resolution (Resolution, optional) — Resolution of the index option contracts, i.e. the granularity of the data
  • market (str, optional)
  • fill_forward (bool, optional) — If true, this will fill in missing data points with the previous data point
Returns:

Canonical Option security

Return type:

Option

add_index_option(symbol, target_option, resolution=None, fill_forward=True)[source]

Creates and adds index options to the algorithm.

Parameters:
  • symbol (Symbol)
  • target_option (str) — The target option ticker. This is useful when the option ticker does not match the underlying, e.g. SPX index and the SPXW weekly option. If null is provided will use underlying
  • resolution (Resolution, optional) — Resolution of the index option contracts, i.e. the granularity of the data
  • fill_forward (bool, optional) — If true, this will fill in missing data points with the previous data point
Returns:

Canonical Option security

Return type:

Option

add_index_option_contract(symbol, resolution=None, fill_forward=True)[source]

Adds an index option contract to the algorithm.

Parameters:
  • symbol (Symbol) — Symbol of the index option contract
  • resolution (Resolution, optional) — Resolution of the index option contract, i.e. the granularity of the data
  • fill_forward (bool, optional) — If true, this will fill in missing data points with the previous data point
Returns:

Index Option Contract

Return type:

Option

add_option(underlying, target_option, resolution=None, market=None, fill_forward=True, leverage=0.0)[source]

Creates and adds a new equity Option security to the algorithm

Parameters:
  • underlying (str | Symbol) — Underlying asset Symbol to use as the option's underlying
  • target_option (str) — The target option ticker. This is useful when the option ticker does not match the underlying, e.g. SPX index and the SPXW weekly option. If null is provided will use underlying
  • resolution (Resolution, optional)
  • market (str, optional)
  • fill_forward (bool, optional) — If true, data will be provided to the algorithm every Second, Minute, Hour, or Day, while the asset is open and depending on the Resolution this option was configured to use.
  • leverage (float, optional) — The requested leverage for the
Returns:

The new option security instance

Return type:

Option

add_option_contract(symbol, resolution=None, fill_forward=True, leverage=0.0, extended_market_hours=False)[source]

Creates and adds a new single Option contract to the algorithm

Parameters:
  • symbol (Symbol) — The option contract symbol
  • resolution (Resolution, optional)
  • fill_forward (bool, optional)
  • leverage (float, optional)
  • extended_market_hours (bool, optional) — Use extended market hours data
Returns:

The new Option security

Return type:

Option

add_security(security_type, ticker, resolution, market, fill_forward, leverage, extended_market_hours, data_mapping_mode=None, data_normalization_mode=None)[source]

Add specified data to our data subscriptions. QuantConnect will funnel this data to the handle data routine.

Parameters:
  • security_type (SecurityType) — MarketType Type: Equity, Commodity, Future, FOREX or Crypto
  • ticker (str) — The security ticker, e.g. AAPL
  • resolution (0, Culture=neutral, PublicKeyToken=null]]) — Resolution of the MarketType required: MarketData, Second or Minute
  • market (str) — The market the requested security belongs to, such as 'usa' or 'fxcm'
  • fill_forward (bool) — If true, returns the last available data even if none in that timeslice.
  • leverage (float) — leverage for this security
  • extended_market_hours (bool) — Use extended market hours data
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the security
Return type:

Security

add_security(symbol, resolution=None, fill_forward=True, leverage=0.0, extended_market_hours=False, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=0)[source]

Add specified data to our data subscriptions. QuantConnect will funnel this data to the handle data routine.

Parameters:
  • symbol (Symbol) — The security Symbol
  • resolution (Resolution, optional) — Resolution of the MarketType required: MarketData, Second or Minute
  • fill_forward (bool, optional) — If true, returns the last available data even if none in that timeslice.
  • leverage (float, optional) — leverage for this security
  • extended_market_hours (bool, optional) — Use extended market hours data
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the security
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 (default) will use the front month, 1 will use the back month contract
Returns:

The new Security that was added to the algorithm

Return type:

Security

download(address, headers, user_name, password)[source]

Downloads the requested resource as a String. The resource to download is specified as a String containing the URI.

Parameters:
  • address (str) — A string containing the URI to download
  • headers (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]) — Defines header values to add to the request
  • user_name (str) — The user name associated with the credentials
  • password (str) — The password for the user name associated with the credentials
Returns:

The requested resource as a string

Return type:

str

get_last_known_prices(security)[source]

Yields data to warmup a security for all it's subscribed data types

Parameters:
  • security (Security) — object for which to retrieve historical data
Returns:

Securities historical data

Return type:

List[BaseData]

get_last_known_prices(symbol)[source]

Yields data to warmup a security for all it's subscribed data types

Parameters:
  • symbol (Symbol) — The symbol we want to get seed data for
Returns:

Securities historical data

Return type:

List[BaseData]

on_securities_changed(changes)[source]

Event fired each time the we add/remove securities from the data feed

Parameters:
  • changes (SecurityChanges) — Security additionsremovals for this time step
remove_option_contract(symbol)[source]

Removes the security with the specified symbol. This will cancel all open orders and then liquidate any existing holdings

Parameters:
  • symbol (Symbol) — The symbol of the security to be removed
Return type:

bool

remove_security(symbol)[source]

Removes the security with the specified symbol. This will cancel all open orders and then liquidate any existing holdings

Parameters:
  • symbol (Symbol) — The symbol of the security to be removed
Return type:

bool

set_future_chain_provider(future_chain_provider)[source]

Sets the future chain provider, used to get the list of future contracts for an underlying symbol

Parameters:
  • future_chain_provider (IFutureChainProvider) — The future chain provider
set_option_chain_provider(option_chain_provider)[source]

Sets the option chain provider, used to get the list of option contracts for an underlying symbol

Parameters:
  • option_chain_provider (IOptionChainProvider) — The option chain provider
set_security_initializer(security_initializer)[source]

Sets the security initializer, used to initialize/configure securities after creation. The initializer will be applied to all universes and manually added securities.

Parameters:
  • security_initializer (0, Culture=neutral, PublicKeyToken=null]] | PyObject | ISecurityInitializer) — The security initializer function or class
symbol(ticker)[source]

Converts the string 'ticker' symbol into a full String) object This requires that the string 'ticker' has been added to the algorithm

Parameters:
  • ticker (str) — The ticker symbol. This should be the ticker symbol as it was added to the algorithm
Returns:

The symbol object mapped to the specified ticker

Return type:

Symbol

ticker(symbol)[source]

For the given symbol will resolve the ticker it used at the current algorithm date

Parameters:
  • symbol (Symbol) — The symbol to get the ticker for
Returns:

The mapped ticker for a symbol

Return type:

str

property future_chain_provider[source]

Gets the future chain provider, used to get the list of future contracts for an underlying symbol

Returns:

Gets the future chain provider, used to get the list of future contracts for an underlying symbol

Return type:

IFutureChainProvider

property option_chain_provider[source]

Gets the option chain provider, used to get the list of option contracts for an underlying symbol

Returns:

Gets the option chain provider, used to get the list of option contracts for an underlying symbol

Return type:

IOptionChainProvider

property security_initializer[source]

Gets an instance that is to be used to initialize newly created securities.

Returns:

Gets an instance that is to be used to initialize newly created securities.

Return type:

ISecurityInitializer

Algorithm Framework

Algorithm Framework

add_alpha(alpha)[source]

Adds a new alpha model

Parameters:
  • alpha (PyObject | IAlphaModel) — Model that generates alpha to add
add_risk_management(risk_management)[source]

Adds a new risk management model

Parameters:
  • risk_management (PyObject | IRiskManagementModel) — Model defining how risk is managed to add
add_universe_selection(universe_selection)[source]

Adds a new universe selection model

Parameters:
  • universe_selection (PyObject | IUniverseSelectionModel) — Model defining universes for the algorithm to add
emit_insights(insights)[source]

Manually emit insights from an algorithm. This is typically invoked before calls to submit orders in algorithms written against QCAlgorithm that have been ported into the algorithm framework.

Parameters:
  • insights (Insight) — The array of insights to be emitted
emit_insights(insight)[source]

Manually emit insights from an algorithm. This is typically invoked before calls to submit orders in algorithms written against QCAlgorithm that have been ported into the algorithm framework.

Parameters:
  • insight (Insight) — The insight to be emitted
framework_post_initialize()[source]

Called by setup handlers after Initialize and allows the algorithm a chance to organize the data gather in the Initialize method

get_locked()[source]

Gets whether or not this algorithm has been locked and fully initialized

Return type:

bool

initialize()[source]

Initialise the data and resolution required, as well as the cash and start-end dates for your algorithm. All algorithms must initialized.

on_framework_data(slice)[source]

Used to send data updates to algorithm framework models

Parameters:
  • slice (Slice) — The current data slice
on_framework_securities_changed(changes)[source]

Used to send security changes to algorithm framework models

Parameters:
  • changes (SecurityChanges) — Security additionsremovals for this time step
post_initialize()[source]

Called by setup handlers after Initialize and allows the algorithm a chance to organize the data gather in the Initialize method

set_alpha(alpha)[source]

Sets the alpha model

Parameters:
  • alpha (PyObject | IAlphaModel) — Model that generates alpha
set_execution(execution)[source]

Sets the execution model

Parameters:
  • execution (PyObject | IExecutionModel) — Model defining how to execute trades to reach a portfolio target
set_locked()[source]

Lock the algorithm initialization to avoid user modifiying cash and data stream subscriptions

set_portfolio_construction(portfolio_construction)[source]

Sets the portfolio construction model

Parameters:
  • portfolio_construction (PyObject | IPortfolioConstructionModel) — Model defining how to build a portfolio from insights
set_risk_management(risk_management)[source]

Sets the risk management model

Parameters:
  • risk_management (PyObject | IRiskManagementModel) — Model defining how risk is managed
set_universe_selection(universe_selection)[source]

Sets the universe selection model

Parameters:
  • universe_selection (PyObject | IUniverseSelectionModel) — Model defining universes for the algorithm
property alpha[source]

Gets or sets the alpha model

Returns:

Gets or sets the alpha model

Return type:

IAlphaModel

property execution[source]

Gets or sets the execution model

Returns:

Gets or sets the execution model

Return type:

IExecutionModel

property insights[source]

Gets the insight manager

Returns:

Gets the insight manager

Return type:

InsightManager

property portfolio_construction[source]

Gets or sets the portfolio construction model

Returns:

Gets or sets the portfolio construction model

Return type:

IPortfolioConstructionModel

property risk_management[source]

Gets or sets the risk management model

Returns:

Gets or sets the risk management model

Return type:

IRiskManagementModel

property universe_selection[source]

Gets or sets the universe selection model.

Returns:

Gets or sets the universe selection model.

Return type:

IUniverseSelectionModel

Charting

Charting

add_chart(chart)[source]

Add a Chart object to algorithm collection

Parameters:
  • chart (Chart) — Chart object to add to collection.
add_series(chart, series, series_type, unit=$)[source]

Add a series object for charting. This is useful when initializing charts with series other than type = line. If a series exists in the chart with the same name, then it is replaced.

Parameters:
  • chart (str) — The chart name
  • series (str) — The series name
  • series_type (SeriesType) — The type of series, i.e, Scatter
  • unit (str, optional) — The unit of the y axis, usually $
get_chart_updates(clear_chart_data=False)[source]

Get the chart updates by fetch the recent points added and return for dynamic Charting.

Parameters:
  • clear_chart_data (bool, optional)
Returns:

List of chart updates since the last request

Return type:

List[Chart]

plot(chart, series, open, high, low, close)[source]

Plot a chart using string series name, with value.

Parameters:
  • chart (str) — Chart name
  • series (str) — Series name
  • open (int | float) — The candlestick open value
  • high (int | float) — The candlestick high value
  • low (int | float) — The candlestick low value
  • close (int | float) — The candlestick close value
plot(chart, first, second=None, third=None, fourth=None)[source]

Plot a chart using string series name, with value.

Parameters:
plot(chart, series, value)[source]

Plot a chart using string series name, with value.

Parameters:
  • chart (str)
  • series (str)
  • value (int | float)
plot(chart, series, bar)[source]

Plot a chart using string series name, with value.

Parameters:
  • chart (str) — Chart name
  • series (str) — Name of the plot series
  • bar (TradeBar) — The trade bar to be plotted to the candlestick series
plot(series, py_object)[source]

Plot a chart using string series name, with value.

Parameters:
  • series (str) — Name of the plot series
  • py_object (PyObject) — PyObject with the value to plot
plot(chart, indicators)[source]

Plot a chart using string series name, with value.

Parameters:
  • chart (str) — The chart's name
  • indicators (IndicatorBase) — The indicators to plot
plot_indicator(chart, wait_for_ready, first, second=None, third=None, fourth=None)[source]

Automatically plots each indicator when a new value is available

Parameters:
  • chart (str)
  • wait_for_ready (bool)
  • first (PyObject)
  • second (PyObject, optional)
  • third (PyObject, optional)
  • fourth (PyObject, optional)
plot_indicator(chart, wait_for_ready, indicators)[source]

Automatically plots each indicator when a new value is available

Parameters:
record(series, value)[source]

Plot a chart using string series name, with int value. Alias of Plot();

Parameters:
  • series (str)
  • value (int | float)
set_runtime_statistic(name, value)[source]

Set a runtime statistic for the algorithm. Runtime statistics are shown in the top banner of a live algorithm GUI.

Parameters:
  • name (str) — Name of your runtime statistic
  • value (str | int | float) — String value of your runtime statistic
property runtime_statistics[source]

Access to the runtime statistics property. User provided statistics.

Returns:

Access to the runtime statistics property. User provided statistics.

Return type:

ConcurrentDict[str, str]

Consolidating Data

Consolidating Data

consolidate(symbol, period, tick_type, handler)[source]

Registers the handler to receive consolidated data for the specified symbol

Parameters:
  • symbol (Symbol) — The symbol who's data is to be consolidated
  • period (Resolution | timedelta) — The symbol who's data is to be consolidated
  • tick_type (TickType) — The consolidation period
  • handler (PyObject | None | 0, Culture=neutral, PublicKeyToken=null]]) — The tick type of subscription used as data source for consolidator. Specify null to use first subscription found.
Returns:

A new consolidator matching the requested parameters with the handler already registered

Return type:

IDataConsolidator

consolidate(symbol, calendar, tick_type, handler)[source]

Registers the handler to receive consolidated data for the specified symbol

Parameters:
  • symbol (Symbol) — The symbol who's data is to be consolidated
  • calendar (Callable[datetime, CalendarInfo]) — The symbol who's data is to be consolidated
  • tick_type (TickType) — The consolidation calendar
  • handler (PyObject | None | 0, Culture=neutral, PublicKeyToken=null]]) — The tick type of subscription used as data source for consolidator. Specify null to use first subscription found.
Returns:

A new consolidator matching the requested parameters with the handler already registered

Return type:

IDataConsolidator

deregister_indicator(indicator)[source]

Will deregister an indicator and it's associated consolidator instance so they stop receiving data updates

Parameters:
  • indicator (IndicatorBase) — The indicator instance to deregister
resolve_consolidator(symbol, resolution, data_type=None)[source]

Gets the default consolidator for the specified symbol and resolution

Parameters:
  • symbol (Symbol) — The symbol whose data is to be consolidated
  • resolution (Resolution) — The resolution for the consolidator, if null, uses the resolution from subscription
  • data_type (Type, optional) — The data type for this consolidator, if null, uses TradeBar over QuoteBar if present
Returns:

The new default consolidator

Return type:

IDataConsolidator

resolve_consolidator(symbol, time_span, data_type=None)[source]

Gets the default consolidator for the specified symbol and resolution

Parameters:
  • symbol (Symbol) — The symbol whose data is to be consolidated
  • time_span (timedelta) — The requested time span for the consolidator, if null, uses the resolution from subscription
  • data_type (Type, optional) — The data type for this consolidator, if null, uses TradeBar over QuoteBar if present
Returns:

The new default consolidator

Return type:

IDataConsolidator

unregister_indicator(indicator)[source]

Will unregister an indicator and it's associated consolidator instance so they stop receiving data updates

Parameters:
  • indicator (IndicatorBase) — The indicator instance to unregister

Handling Data

Handling Data

cik(cik, trading_date=None)[source]

Converts a CIK identifier into String) array

Parameters:
  • cik (int) — The CIK identifier of an asset
  • trading_date (datetime, optional) — The date that the stock being looked up iswas traded at. The date is used to create a Symbol with the ticker set to the ticker the asset traded under on the trading date.
Returns:

Symbols corresponding to the CIK. If no Symbol with a matching CIK was found, returns empty array.

Return type:

Symbol

cik(symbol)[source]

Converts a CIK identifier into String) array

Parameters:
Returns:

CIK corresponding to the Symbol. If no matching CIK is found, returns null.

Return type:

int

composite_figi(composite_figi, trading_date=None)[source]

Converts a composite FIGI identifier into a String)

Parameters:
  • composite_figi (str) — The composite Financial Instrument Global Identifier (FIGI) of an asset
  • trading_date (datetime, optional) — The date that the stock being looked up iswas traded at. The date is used to create a Symbol with the ticker set to the ticker the asset traded under on the trading date.
Returns:

Symbol corresponding to the composite FIGI. If no Symbol with a matching composite FIGI was found, returns null.

Return type:

Symbol

composite_figi(symbol)[source]

Converts a composite FIGI identifier into a String)

Parameters:
Returns:

Composite FIGI corresponding to the Symbol. If no matching composite FIGI is found, returns null.

Return type:

str

cusip(cusip, trading_date=None)[source]

Converts a CUSIP identifier into a String)

Parameters:
  • cusip (str) — The CUSIP number of an asset
  • trading_date (datetime, optional) — The date that the stock being looked up iswas traded at. The date is used to create a Symbol with the ticker set to the ticker the asset traded under on the trading date.
Returns:

Symbol corresponding to the CUSIP. If no Symbol with a matching CUSIP was found, returns null.

Return type:

Symbol

cusip(symbol)[source]

Converts a CUSIP identifier into a String)

Parameters:
Returns:

CUSIP corresponding to the Symbol. If no matching CUSIP is found, returns null.

Return type:

str

fundamentals(symbol)[source]

Get the fundamental data for the requested symbol at the current time

Parameters:
Returns:

The fundamental data for the Symbol

Return type:

Fundamental

fundamentals(symbols)[source]

Get the fundamental data for the requested symbol at the current time

Parameters:
  • symbols (List[Symbol])
Returns:

The fundamental data for the symbols

Return type:

List[Fundamental]

isin(isin, trading_date=None)[source]

Converts an ISIN identifier into a String)

Parameters:
  • isin (str) — The International Securities Identification Number (ISIN) of an asset
  • trading_date (datetime, optional) — The date that the stock being looked up iswas traded at. The date is used to create a Symbol with the ticker set to the ticker the asset traded under on the trading date.
Returns:

Symbol corresponding to the ISIN. If no Symbol with a matching ISIN was found, returns null.

Return type:

Symbol

isin(symbol)[source]

Converts an ISIN identifier into a String)

Parameters:
Returns:

ISIN corresponding to the Symbol. If no matching ISIN is found, returns null.

Return type:

str

on_data(slice)[source]

Event - v3.0 DATA EVENT HANDLER: (Pattern) Basic template for user to override for receiving all subscription data in a single event

Parameters:
  • slice (Slice) — The current slice of data keyed by symbol string
on_delistings(delistings)[source]

Event handler to be called when there's been a delistings event

Parameters:
  • delistings (Delistings) — The current time slice delistings
on_dividends(dividends)[source]

Event handler to be called when there's been a dividend event

Parameters:
  • dividends (Dividends) — The current time slice dividends
on_end_of_algorithm()[source]

End of algorithm run event handler. This method is called at the end of a backtest or live trading operation. Intended for closing out logs.

on_end_of_day(symbol)[source]

End of a trading day event handler. This method is called at the end of the algorithm day (or multiple times if trading multiple assets).

Parameters:
  • symbol (str | Symbol) — Asset symbol for this end of day event. Forex and equities have different closing hours.
on_end_of_time_step()[source]

Invoked at the end of every time step. This allows the algorithm to process events before advancing to the next time step.

on_splits(splits)[source]

Event handler to be called when there's been a split event

Parameters:
  • splits (Splits) — The current time slice splits
on_symbol_changed_events(symbols_changed)[source]

Event handler to be called when there's been a symbol changed event

Parameters:
on_warmup_finished()[source]

Called when the algorithm has completed initialization and warm up.

sedol(sedol, trading_date=None)[source]

Converts a SEDOL identifier into a String)

Parameters:
  • sedol (str) — The SEDOL identifier of an asset
  • trading_date (datetime, optional) — The date that the stock being looked up iswas traded at. The date is used to create a Symbol with the ticker set to the ticker the asset traded under on the trading date.
Returns:

Symbol corresponding to the SEDOL. If no Symbol with a matching SEDOL was found, returns null.

Return type:

Symbol

sedol(symbol)[source]

Converts a SEDOL identifier into a String)

Parameters:
Returns:

SEDOL corresponding to the Symbol. If no matching SEDOL is found, returns null.

Return type:

str

set_algorithm_id(algorithm_id)[source]

Set the algorithm id (backtestId or live deployId for the algorithm).

Parameters:
  • algorithm_id (str) — String Algorithm Id
set_api(api)[source]

Provide the API for the algorithm.

Parameters:
  • api (IApi) — Initiated API
set_available_data_types(available_data_types)[source]

Set the available data feeds in the SecurityManager

Parameters:
  • available_data_types (Dict[SecurityType, List[TickType]]) — supports
set_current_slice(slice)[source]

Sets the current slice

Parameters:
  • slice (Slice) — The Slice object
set_date_time(frontier)[source]

Update the internal algorithm time frontier.

Parameters:
  • frontier (datetime) — Current utc datetime.
set_end_date(year, month, day)[source]

Set the end date for a backtest run

Parameters:
  • year (int) — Int end date 1-30
  • month (int) — Int month end date
  • day (int) — Int year end date
set_end_date(end)[source]

Set the end date for a backtest run

Parameters:
  • end (datetime) — Datetime value for end date
set_object_store(object_store)[source]

Sets the object store

Parameters:
  • object_store (IObjectStore) — The object store
set_run_time_error(exception)[source]

Set the runtime error

Parameters:
  • exception (Exception) — Represents error that occur during execution
set_start_date(year, month, day)[source]

Set the start date for backtest.

Parameters:
  • year (int) — Int starting date 1-30
  • month (int) — Int month starting date
  • day (int) — Int year starting date
set_start_date(start)[source]

Set the start date for backtest.

Parameters:
  • start (datetime) — Datetime Start date for backtest
set_time_zone(time_zone)[source]

Sets the time zone of the Time property in the algorithm

Parameters:
  • time_zone (datetimeZone | str) — The desired time zone
property algorithm_id[source]

Algorithm Id for this backtest or live algorithm.

Returns:

Algorithm Id for this backtest or live algorithm.

Return type:

str

property current_slice[source]

Returns the current Slice object

Returns:

Returns the current Slice object

Return type:

Slice

property end_date[source]

Value of the user set start-date from the backtest. Controls the period of the backtest.

Returns:

Value of the user set start-date from the backtest. Controls the period of the backtest.

Return type:

datetime

property name[source]

Public name for the algorithm as automatically generated by the IDE. Intended for helping distinguish logs by noting the algorithm-id.

Returns:

Public name for the algorithm as automatically generated by the IDE. Intended for helping distinguish logs by noting the algorithm-id.

Return type:

str

property object_store[source]

Gets the object store, used for persistence

Returns:

Gets the object store, used for persistence

Return type:

ObjectStore

property settings[source]

Gets the user settings for the algorithm

Returns:

Gets the user settings for the algorithm

Return type:

IAlgorithmSettings

property start_date[source]

Value of the user set start-date from the backtest.

Returns:

Value of the user set start-date from the backtest.

Return type:

datetime

property status[source]

Gets or sets the current status of the algorithm

Returns:

Gets or sets the current status of the algorithm

Return type:

AlgorithmStatus

property subscription_manager[source]

Generic Data Manager - Required for compiling all data feeds in order, and passing them into algorithm event methods. The subscription manager contains a list of the data feed's we're subscribed to and properties of each data feed.

Returns:

Generic Data Manager - Required for compiling all data feeds in order, and passing them into algorithm event methods. The subscription manager contains a list of the data feed's we're subscribed to and properties of each data feed.

Return type:

SubscriptionManager

property tags[source]

A list of tags associated with the algorithm or the backtest, useful for categorization

Returns:

A list of tags associated with the algorithm or the backtest, useful for categorization

Return type:

HashSet[str]

property time[source]

Read-only value for current time frontier of the algorithm in terms of the TimeZone

Returns:

Read-only value for current time frontier of the algorithm in terms of the TimeZone

Return type:

datetime

property time_zone[source]

Gets the time zone used for the Time property. The default value is

Returns:

Gets the time zone used for the Time property. The default value is

Return type:

datetimeZone

property utc_time[source]

Current date/time in UTC.

Returns:

Current date/time in UTC.

Return type:

datetime

Historical Data

Historical Data

history(type, tickers, start, end, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • type (PyObject) — The data type of the symbols
  • tickers (PyObject) — The symbols to retrieve historical data for
  • start (datetime) — The start time in the algorithm's time zone
  • end (datetime) — The end time in the algorithm's time zone
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

pandas.DataFrame containing the requested historical data

Return type:

PyObject

history(type, symbol, start, end, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • type (PyObject) — The data type of the symbols
  • symbol (Symbol) — The symbol to retrieve historical data for
  • start (datetime) — The start time in the algorithm's time zone
  • end (datetime) — The end time in the algorithm's time zone
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

pandas.DataFrame containing the requested historical data

Return type:

PyObject

history(type, tickers, periods, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • type (PyObject) — The data type of the symbols
  • tickers (PyObject) — The symbols to retrieve historical data for
  • periods (int) — The number of bars to request
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

pandas.DataFrame containing the requested historical data

Return type:

PyObject

history(type, tickers, span, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • type (PyObject) — The data type of the symbols
  • tickers (PyObject) — The symbols to retrieve historical data for
  • span (timedelta) — The span over which to retrieve recent historical data
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

pandas.DataFrame containing the requested historical data

Return type:

PyObject

history(type, symbol, periods, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • type (PyObject) — The data type of the symbols
  • symbol (Symbol) — The symbol to retrieve historical data for
  • periods (int) — The number of bars to request
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

pandas.DataFrame containing the requested historical data

Return type:

PyObject

history(type, symbol, span, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • type (PyObject) — The data type of the symbols
  • symbol (Symbol) — The symbol to retrieve historical data for
  • span (timedelta) — The span over which to retrieve recent historical data
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

pandas.DataFrame containing the requested historical data

Return type:

PyObject

history(symbols, start, end, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • symbols (List[Symbol]) — The symbols to retrieve historical data for
  • start (datetime) — The start time in the algorithm's time zone
  • end (datetime) — The end time in the algorithm's time zone
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

An enumerable of slice containing the requested historical data

Return type:

List[Slice]

history(universe, start, end, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • universe (Universe) — The universe to fetch the data for
  • start (datetime) — The start time in the algorithm's time zone
  • end (datetime) — The end time in the algorithm's time zone
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

An enumerable of slice containing the requested historical data

Return type:

List[BaseDataCollection]

history(symbols, span, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • symbols (List[Symbol]) — The symbols to retrieve historical data for
  • span (timedelta) — The span over which to retrieve recent historical data
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

An enumerable of slice containing the requested historical data

Return type:

List[Slice]

history(symbols, periods, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • symbols (List[Symbol]) — The symbols to retrieve historical data for
  • periods (int) — The number of bars to request
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

An enumerable of slice containing the requested historical data

Return type:

List[Slice]

history(universe, periods, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • universe (Universe) — The universe to fetch the data for
  • periods (int) — The number of bars to request
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

An enumerable of slice containing data over the most recent span for all configured securities

Return type:

List[BaseDataCollection]

history(universe, span, resolution=None, fill_forward=None, extended_market_hours=None, data_mapping_mode=None, data_normalization_mode=None, contract_depth_offset=None)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • universe (Universe) — The universe to fetch the data for
  • span (timedelta) — The span over which to request data. This is a calendar span, so take into consideration weekends and such
  • resolution (Resolution, optional) — The resolution to request
  • fill_forward (bool, optional) — True to fill forward missing data, false otherwise
  • extended_market_hours (bool, optional) — True to include extended market hours data, false otherwise
  • data_mapping_mode (DataMappingMode, optional) — The contract mapping mode to use for the security history request
  • data_normalization_mode (DataNormalizationMode, optional) — The price scaling mode to use for the securities history
  • contract_depth_offset (int, optional) — The continuous contract desired offset from the current front month. For example, 0 will use the front month, 1 will use the back month contract
Returns:

An enumerable of slice containing the requested historical data

Return type:

List[BaseDataCollection]

history(request)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
Returns:

An enumerable of slice satisfying the specified history request

Return type:

List[Slice]

history(requests)[source]

Get the history for all configured securities over the requested span. This will use the resolution and other subscription settings for each security. The symbols must exist in the Securities collection.

Parameters:
  • requests (List[HistoryRequest]) — the history requests to execute
Returns:

An enumerable of slice satisfying the specified history request

Return type:

List[Slice]

set_finished_warming_up()[source]

Sets IsWarmingUp to false to indicate this algorithm has finished its warm up

set_history_provider(history_provider)[source]

Set the historical data provider

Parameters:
  • history_provider (IHistoryProvider) — Historical data provider
set_warm_up(time_span, resolution)[source]

Sets the warm up period to the specified value

Parameters:
  • time_span (timedelta) — The amount of time to warm up, this does not take into account market hoursweekends
  • resolution (Resolution) — The resolution to request
set_warm_up(bar_count, resolution)[source]

Sets the warm up period to the specified value

Parameters:
  • bar_count (int) — The number of data points requested for warm up
  • resolution (Resolution) — The resolution to request
set_warmup(time_span, resolution)[source]

Sets the warm up period to the specified value

Parameters:
  • time_span (timedelta) — The amount of time to warm up, this does not take into account market hoursweekends
  • resolution (Resolution) — The resolution to request
set_warmup(bar_count, resolution)[source]

Sets the warm up period to the specified value

Parameters:
  • bar_count (int) — The number of data points requested for warm up
  • resolution (Resolution) — The resolution to request
warm_up_indicator(symbol, indicator, period, selector=None)[source]

Warms up a given indicator with historical data

Parameters:
  • symbol (Symbol) — The symbol whose indicator we want
  • indicator (None | 0, Culture=neutral, PublicKeyToken=null]]) — The indicator we want to warm up
  • period (timedelta) — The necessary period to warm up the indicator
  • selector (0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]] | None, optional) — x.Value)
property is_warming_up[source]

Gets whether or not this algorithm is still warming up

Returns:

Gets whether or not this algorithm is still warming up

Return type:

bool

Indicators

Indicators

a(target, reference, alpha_period=1, beta_period=252, resolution=None, risk_free_rate=None, selector=None)[source]

Adds a tag to the algorithm

Parameters:
  • target (Symbol) — The target symbol whose Alpha value we want
  • reference (Symbol) — The reference symbol to compare with the target symbol
  • alpha_period (int, optional) — The period of the Alpha indicator
  • beta_period (int, optional) — The period of the Beta indicator
  • resolution (Resolution, optional) — The resolution
  • risk_free_rate (float, optional) — The risk free rate
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Alpha indicator for the given parameters

Return type:

Alpha

abands(symbol, period, width=4.0, moving_average_type=0, resolution=None, selector=None)[source]

Creates a new Acceleration Bands indicator.

Parameters:
  • symbol (Symbol) — The symbol whose Acceleration Bands we want.
  • period (int) — The period of the three moving average (middle, upper and lower band).
  • width (float, optional) — A coefficient specifying the distance between the middle band and upper or lower bands.
  • moving_average_type (MovingAverageType, optional) — Type of the moving average.
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar.
Return type:

AccelerationBands

ad(symbol, resolution=None, selector=None)[source]

Creates a new AccumulationDistribution indicator.

Parameters:
  • symbol (Symbol) — The symbol whose AD we want
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — x.Value)
Returns:

The AccumulationDistribution indicator for the requested symbol over the specified period

Return type:

AccumulationDistribution

addiff(symbols, resolution=None, selector=None)[source]

Creates a new Advance/Decline Difference indicator

Parameters:
  • symbols (List[Symbol]) — The symbols whose AD Difference we want
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The AdvanceDecline Difference indicator for the requested symbol over the specified period

Return type:

AdvanceDeclineDifference

adosc(symbol, fast_period, slow_period, resolution=None, selector=None)[source]

Creates a new AccumulationDistributionOscillator indicator.

Parameters:
  • symbol (Symbol) — The symbol whose ADOSC we want
  • fast_period (int) — The fast moving average period
  • slow_period (int) — The slow moving average period
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — x.Value)
Returns:

The AccumulationDistributionOscillator indicator for the requested symbol over the specified period

Return type:

AccumulationDistributionOscillator

adr(symbols, resolution=None, selector=None)[source]

Creates a new Advance/Decline Ratio indicator

Parameters:
  • symbols (List[Symbol]) — The symbols whose AD Ratio we want
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The AdvanceDecline Ratio indicator for the requested symbol over the specified period

Return type:

AdvanceDeclineRatio

advr(symbols, resolution=None, selector=None)[source]

Creates a new Advance/Decline Volume Ratio indicator

Parameters:
  • symbols (List[Symbol]) — The symbol whose AD Volume Rate we want
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The AdvanceDecline Volume Ratio indicator for the requested symbol over the specified period

Return type:

AdvanceDeclineVolumeRatio

adx(symbol, period, resolution=None, selector=None)[source]

Creates a new Average Directional Index indicator. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose Average Directional Index we seek
  • period (int) — The resolution.
  • resolution (Resolution, optional) — The period over which to compute the Average Directional Index
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Average Directional Index indicator for the requested symbol.

Return type:

AverageDirectionalIndex

adxr(symbol, period, resolution=None, selector=None)[source]

Creates a new AverageDirectionalMovementIndexRating indicator.

Parameters:
  • symbol (Symbol) — The symbol whose ADXR we want
  • period (int) — The period over which to compute the ADXR
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, IBaseDataBar], optional) — x.Value)
Returns:

The AverageDirectionalMovementIndexRating indicator for the requested symbol over the specified period

Return type:

AverageDirectionalMovementIndexRating

alma(symbol, period, sigma=6, offset=0.85, resolution=None, selector=None)[source]

Creates a new ArnaudLegouxMovingAverage indicator.

Parameters:
  • symbol (Symbol) — The symbol whose ALMA we want
  • period (int) — int - the number of periods to calculate the ALMA
  • sigma (int, optional) — int - this parameter is responsible for the shape of the curve coefficients.
  • offset (float, optional) — decimal - This parameter allows regulating the smoothness and high sensitivity of the Moving Average. The range for this parameter is [0, 1].
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The ArnaudLegouxMovingAverage indicator for the requested symbol over the specified period

Return type:

ArnaudLegouxMovingAverage

ao(symbol, slow_period, fast_period, type, resolution=None, selector=None)[source]

Creates a new Awesome Oscillator from the specified periods.

Parameters:
  • symbol (Symbol) — The symbol whose Awesome Oscillator we seek
  • slow_period (int) — The resolution.
  • fast_period (int) — The period of the fast moving average associated with the AO
  • type (MovingAverageType) — The period of the slow moving average associated with the AO
  • resolution (Resolution, optional) — The type of moving average used when computing the fast and slow term. Defaults to simple moving average.
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Return type:

AwesomeOscillator

apo(symbol, fast_period, slow_period, moving_average_type, resolution=None, selector=None)[source]

Creates a new AbsolutePriceOscillator indicator.

Parameters:
  • symbol (Symbol) — The symbol whose APO we want
  • fast_period (int) — The fast moving average period
  • slow_period (int) — The slow moving average period
  • moving_average_type (MovingAverageType) — The type of moving average to use
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The AbsolutePriceOscillator indicator for the requested symbol over the specified period

Return type:

AbsolutePriceOscillator

aps(symbol, period=3, resolution=None, selector=None)[source]

Creates an AugenPriceSpike indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose APS we want
  • period (int, optional) — The period of the APS
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The AugenPriceSpike indicator for the given parameters

Return type:

AugenPriceSpike

arima(symbol, ar_order, diff_order, ma_order, period, resolution=None, selector=None)[source]

Creates a new ARIMA indicator.

Parameters:
  • symbol (Symbol) — The symbol whose ARIMA indicator we want
  • ar_order (int) — AR order (p) -- defines the number of past values to consider in the AR component of the model.
  • diff_order (int) — Difference order (d) -- defines how many times to difference the model before fitting parameters.
  • ma_order (int) — MA order (q) -- defines the number of past values to consider in the MA component of the model.
  • period (int) — Size of the rolling series to fit onto
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The ARIMA indicator for the requested symbol over the specified period

Return type:

AutoRegressiveIntegratedMovingAverage

aroon(symbol, up_period, down_period, resolution=None, selector=None)[source]

Creates a new AroonOscillator indicator which will compute the AroonUp and AroonDown (as well as the delta)

Parameters:
  • symbol (Symbol) — The symbol whose Aroon we seek
  • up_period (int) — The look back period for computing number of periods since maximum
  • down_period (int) — The look back period for computing number of periods since minimum
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

An AroonOscillator configured with the specified periods

Return type:

AroonOscillator

aroon(symbol, period, resolution=None, selector=None)[source]

Creates a new AroonOscillator indicator which will compute the AroonUp and AroonDown (as well as the delta)

Parameters:
  • symbol (Symbol) — The symbol whose Aroon we seek
  • period (int) — The look back period for computing number of periods since maximum and minimum
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

An AroonOscillator configured with the specified periods

Return type:

AroonOscillator

asi(symbol, limit_move, resolution=4, selector=None)[source]

Creates a Wilder Accumulative Swing Index (ASI) indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose ASI we want
  • limit_move (float) — The maximum daily change in price for the ASI
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The WilderAccumulativeSwingIndex for the given parameters

Return type:

WilderAccumulativeSwingIndex

atr(symbol, period, type=0, resolution=None, selector=None)[source]

Creates a new AverageTrueRange indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose ATR we want
  • period (int) — The smoothing period used to smooth the computed TrueRange values
  • type (MovingAverageType, optional) — The type of smoothing to use
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

A new AverageTrueRange indicator with the specified smoothing type and period

Return type:

AverageTrueRange

b(target, reference, period, resolution=None, selector=None)[source]

Creates a new BollingerBands indicator which will compute the MiddleBand, UpperBand, LowerBand, and StandardDeviation

Parameters:
  • target (Symbol) — The target symbol whose Beta value we want
  • reference (Symbol) — The reference symbol to compare with the target symbol
  • period (int) — The period of the Beta indicator
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Beta indicator for the given parameters

Return type:

Beta

bb(symbol, period, k, moving_average_type=0, resolution=None, selector=None)[source]

Creates a new BollingerBands indicator which will compute the MiddleBand, UpperBand, LowerBand, and StandardDeviation

Parameters:
  • symbol (Symbol) — The symbol whose BollingerBands we seek
  • period (int) — The period of the standard deviation and moving average (middle band)
  • k (float) — The number of standard deviations specifying the distance between the middle band and upper or lower bands
  • moving_average_type (MovingAverageType, optional) — The type of moving average to be used
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

A BollingerBands configured with the specified period

Return type:

BollingerBands

bop(symbol, resolution=None, selector=None)[source]

Creates a new Balance Of Power indicator. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose Balance Of Power we seek
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Balance Of Power indicator for the requested symbol.

Return type:

BalanceOfPower

c(target, reference, period, correlation_type=0, resolution=None, selector=None)[source]

Converts a composite FIGI identifier into a String)

Parameters:
  • target (Symbol) — The target symbol of this indicator
  • reference (Symbol) — The reference symbol of this indicator
  • period (int) — The period of this indicator
  • correlation_type (CorrelationType, optional) — Correlation type
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Correlation indicator for the given parameters

Return type:

Correlation

cc(symbol, short_roc_period=11, long_roc_period=14, lwma_period=10, resolution=None, selector=None)[source]

Initializes a new instance of the CoppockCurve indicator

Parameters:
  • symbol (Symbol) — The symbol whose Coppock Curve we want
  • short_roc_period (int, optional) — The period for the short ROC
  • long_roc_period (int, optional) — The period for the long ROC
  • lwma_period (int, optional) — The period for the LWMA
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Coppock Curve indicator for the requested symbol over the specified period

Return type:

CoppockCurve

cci(symbol, period, moving_average_type=0, resolution=None, selector=None)[source]

Creates a new CommodityChannelIndex indicator. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose CCI we want
  • period (int) — The period over which to compute the CCI
  • moving_average_type (MovingAverageType, optional) — The type of moving average to use in computing the typical price average
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The CommodityChannelIndex indicator for the requested symbol over the specified period

Return type:

CommodityChannelIndex

cmf(symbol, period, resolution=None, selector=None)[source]

Creates a new ChaikinMoneyFlow indicator.

Parameters:
  • symbol (Symbol) — The symbol whose CMF we want
  • period (int) — The period over which to compute the CMF
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The ChaikinMoneyFlow indicator for the requested symbol over the specified period

Return type:

ChaikinMoneyFlow

cmo(symbol, period, resolution=None, selector=None)[source]

Creates a new ChandeMomentumOscillator indicator.

Parameters:
  • symbol (Symbol) — The symbol whose CMO we want
  • period (int) — The period over which to compute the CMO
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The ChandeMomentumOscillator indicator for the requested symbol over the specified period

Return type:

ChandeMomentumOscillator

create_indicator_name(symbol, type, resolution)[source]

Creates a new name for an indicator created with the convenience functions (SMA, EMA, ect...)

Parameters:
  • symbol (Symbol) — The symbol this indicator is registered to
  • type (Formattablestr | str) — The indicator type, for example, 'SMA(5)'
  • resolution (Resolution) — The resolution requested
Returns:

A unique for the given parameters

Return type:

str

d(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, iv_model=None, resolution=None)[source]

Send a debug message to the web console:

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option for parity calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate Delta
  • iv_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new Delta indicator for the specified symbol

Return type:

Delta

dch(symbol, upper_period, lower_period, resolution=None, selector=None)[source]

Creates a new Donchian Channel indicator which will compute the Upper Band and Lower Band. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose Donchian Channel we seek.
  • upper_period (int) — The period over which to compute the upper Donchian Channel.
  • lower_period (int) — The period over which to compute the lower Donchian Channel.
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Donchian Channel indicator for the requested symbol.

Return type:

DonchianChannel

dch(symbol, period, resolution=None, selector=None)[source]

Creates a new Donchian Channel indicator which will compute the Upper Band and Lower Band. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose Donchian Channel we seek.
  • period (int) — The period over which to compute the Donchian Channel.
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Donchian Channel indicator for the requested symbol.

Return type:

DonchianChannel

dem(symbol, period, type, resolution=None, selector=None)[source]

Creates a new DeMarker Indicator (DEM), an oscillator-type indicator measuring changes in terms of an asset's High and Low tradebar values.

Parameters:
  • symbol (Symbol) — The symbol whose DEM we seek.
  • period (int) — The period of the moving average implemented
  • type (MovingAverageType) — Specifies the type of moving average to be used
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The DeMarker indicator for the requested symbol.

Return type:

DeMarkerIndicator

dema(symbol, period, resolution=None, selector=None)[source]

Creates a new DoubleExponentialMovingAverage indicator.

Parameters:
  • symbol (Symbol) — The symbol whose DEMA we want
  • period (int) — The period over which to compute the DEMA
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The DoubleExponentialMovingAverage indicator for the requested symbol over the specified period

Return type:

floatExponentialMovingAverage

do(symbol, rsi_period, smoothing_rsi_period, double_smoothing_rsi_period, signal_line_period, resolution=None, selector=None)[source]

Creates a new DerivativeOscillator indicator.

Parameters:
  • symbol (Symbol) — The symbol whose DO we want
  • rsi_period (int) — The period over which to compute the RSI
  • smoothing_rsi_period (int) — The period over which to compute the smoothing RSI
  • double_smoothing_rsi_period (int) — The period over which to compute the double smoothing RSI
  • signal_line_period (int) — The period over which to compute the signal line
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to the Value property of BaseData (x => x.Value)
Returns:

The DerivativeOscillator indicator for the requested symbol over the specified period

Return type:

DerivativeOscillator

dpo(symbol, period, resolution=None, selector=None)[source]

Creates a new DetrendedPriceOscillator indicator.

Parameters:
  • symbol (Symbol) — The symbol whose DPO we want
  • period (int) — The period over which to compute the DPO
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

A new registered DetrendedPriceOscillator indicator for the requested symbol over the specified period

Return type:

DetrendedPriceOscillator

ema(symbol, period, smoothing_factor, resolution=None, selector=None)[source]

Creates an ExponentialMovingAverage indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose EMA we want
  • period (int) — The period of the EMA
  • smoothing_factor (float) — The percentage of data from the previous value to be carried into the next value
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The ExponentialMovingAverage for the given parameters

Return type:

ExponentialMovingAverage

emv(symbol, period=1, scale=10000, resolution=None, selector=None)[source]

Creates an EaseOfMovementValue indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose EMV we want
  • period (int, optional) — The period of the EMV
  • scale (int, optional) — The length of the outputed value
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The EaseOfMovementValue indicator for the given parameters

Return type:

EaseOfMovementValue

filtered_identity(symbol, resolution, selector=None, filter=None, field_name=None)[source]

Creates a new FilteredIdentity indicator for the symbol The indicator will be automatically updated on the symbol's subscription resolution

Parameters:
  • symbol (Symbol) — The symbol whose values we want as an indicator
  • resolution (Resolution | timedelta) — The desired resolution of the data
  • selector (PyObject | 0, Culture=neutral, PublicKeyToken=null]], optional) — x.Value)
  • filter (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]], optional) — true) which means no filter
  • field_name (str, optional) — The name of the field being selected
Returns:

A new FilteredIdentity indicator for the specified symbol and selector

Return type:

FilteredIdentity

fish(symbol, period, resolution=None, selector=None)[source]

Creates an FisherTransform indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose FisherTransform we want
  • period (int) — The period of the FisherTransform
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The FisherTransform for the given parameters

Return type:

FisherTransform

frama(symbol, period, long_period=198, resolution=None, selector=None)[source]

Creates an FractalAdaptiveMovingAverage (FRAMA) indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose FRAMA we want
  • period (int) — The period of the FRAMA
  • long_period (int, optional) — The long period of the FRAMA
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The FRAMA for the given parameters

Return type:

FractalAdaptiveMovingAverage

g(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, iv_model=None, resolution=None)[source]

Gets the parameter with the specified name. If a parameter with the specified name does not exist, the given default value is returned if any, else null

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option for parity calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate Gamma
  • iv_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new Gamma indicator for the specified symbol

Return type:

Gamma

heikin_ashi(symbol, resolution=None, selector=None)[source]

Creates a new Heikin-Ashi indicator.

Parameters:
  • symbol (Symbol) — The symbol whose Heikin-Ashi we want
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Heikin-Ashi indicator for the requested symbol over the specified period

Return type:

HeikinAshi

hma(symbol, period, resolution=None, selector=None)[source]

Creates a new HullMovingAverage indicator. The Hull moving average is a series of nested weighted moving averages, is fast and smooth.

Parameters:
  • symbol (Symbol) — The symbol whose Hull moving average we want
  • period (int) — The period over which to compute the Hull moving average
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Return type:

HullMovingAverage

ht(symbol, length, in_phase_multiplication_factor, quadrature_multiplication_factor, resolution=None, selector=None)[source]

Creates a new Hilbert Transform indicator

Parameters:
  • symbol (Symbol) — The symbol whose Hilbert transform we want
  • length (int) — The length of the FIR filter used in the calculation of the Hilbert Transform. This parameter determines the number of filter coefficients in the FIR filter.
  • in_phase_multiplication_factor (float) — The multiplication factor used in the calculation of the in-phase component of the Hilbert Transform. This parameter adjusts the sensitivity and responsiveness of the transform to changes in the input signal.
  • quadrature_multiplication_factor (float) — The multiplication factor used in the calculation of the quadrature component of the Hilbert Transform. This parameter also adjusts the sensitivity and responsiveness of the transform to changes in the input signal.
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Return type:

HilbertTransform

ichimoku(symbol, tenkan_period, kijun_period, senkou_a_period, senkou_b_period, senkou_a_delay_period, senkou_b_delay_period, resolution=None, selector=None)[source]

Creates a new IchimokuKinkoHyo indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose ICHIMOKU we want
  • tenkan_period (int) — The period to calculate the Tenkan-sen period
  • kijun_period (int) — The period to calculate the Kijun-sen period
  • senkou_a_period (int) — The period to calculate the Tenkan-sen period
  • senkou_b_period (int) — The period to calculate the Tenkan-sen period
  • senkou_a_delay_period (int) — The period to calculate the Tenkan-sen period
  • senkou_b_delay_period (int) — The period to calculate the Tenkan-sen period
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

A new IchimokuKinkoHyo indicator with the specified periods and delays

Return type:

IchimokuKinkoHyo

identity(symbol, resolution, selector=None, field_name=None)[source]

Creates a new Identity indicator for the symbol The indicator will be automatically updated on the symbol's subscription resolution

Parameters:
  • symbol (Symbol) — The symbol whose values we want as an indicator
  • resolution (Resolution | timedelta) — The desired resolution of the data
  • selector (Callable[IBaseData, float], optional) — x.Value)
  • field_name (str, optional) — The name of the field being selected
Returns:

A new Identity indicator for the specified symbol and selector

Return type:

Identity

iv(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, period=252, resolution=None)[source]

Creates a new ImpliedVolatility indicator for the symbol The indicator will be automatically updated on the symbol's subscription resolution

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option contract used for parity type calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • period (int, optional) — The lookback period of historical volatility
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new ImpliedVolatility indicator for the specified symbol

Return type:

ImpliedVolatility

kama(symbol, period, fast_ema_period, slow_ema_period, resolution=None, selector=None)[source]

Creates a new KaufmanAdaptiveMovingAverage indicator.

Parameters:
  • symbol (Symbol) — The symbol whose KAMA we want
  • period (int) — The period of the Efficiency Ratio (ER)
  • fast_ema_period (int) — The period of the fast EMA used to calculate the Smoothing Constant (SC)
  • slow_ema_period (int) — The period of the slow EMA used to calculate the Smoothing Constant (SC)
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The KaufmanAdaptiveMovingAverage indicator for the requested symbol over the specified period

Return type:

KaufmanAdaptiveMovingAverage

kch(symbol, period, k, moving_average_type=0, resolution=None, selector=None)[source]

Creates a new Keltner Channels indicator. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose Keltner Channel we seek
  • period (int) — The period over which to compute the Keltner Channels
  • k (float) — from the middle band of the Keltner Channels
  • moving_average_type (MovingAverageType, optional) — Specifies the type of moving average to be used as the middle line of the Keltner Channel
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Keltner Channel indicator for the requested symbol.

Return type:

KeltnerChannels

ker(symbol, period=2, resolution=None, selector=None)[source]

Creates an KaufmanEfficiencyRatio indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose EF we want
  • period (int, optional) — The period of the EF
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The KaufmanEfficiencyRatio indicator for the given parameters

Return type:

KaufmanEfficiencyRatio

logr(symbol, period, resolution=None, selector=None)[source]

Creates a new LogReturn indicator.

Parameters:
  • symbol (Symbol) — The symbol whose log return we seek
  • period (int) — The period of the log return.
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, float], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar.
Returns:

log return indicator for the requested symbol.

Return type:

LogReturn

lsma(symbol, period, resolution=None, selector=None)[source]

Creates and registers a new Least Squares Moving Average instance.

Parameters:
  • symbol (Symbol) — The symbol whose LSMA we seek.
  • period (int) — The LSMA period. Normally 14.
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, float], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar.
Returns:

A LeastSquaredMovingAverage configured with the specified period

Return type:

LeastSquaresMovingAverage

lwma(symbol, period, resolution=None, selector=None)[source]

Creates a new LinearWeightedMovingAverage indicator. This indicator will linearly distribute the weights across the periods.

Parameters:
  • symbol (Symbol) — The symbol whose LWMA we want
  • period (int) — The period over which to compute the LWMA
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Return type:

LinearWeightedMovingAverage

macd(symbol, fast_period, slow_period, signal_period, type=1, resolution=None, selector=None)[source]

Creates a MACD indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose MACD we want
  • fast_period (int) — The period for the fast moving average
  • slow_period (int) — The period for the slow moving average
  • signal_period (int) — The period for the signal moving average
  • type (MovingAverageType, optional) — The type of moving average to use for the MACD
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The moving average convergence divergence between the fast and slow averages

Return type:

MovingAverageConvergenceDivergence

mad(symbol, period, resolution=None, selector=None)[source]

Creates a new MeanAbsoluteDeviation indicator.

Parameters:
  • symbol (Symbol) — The symbol whose MeanAbsoluteDeviation we want
  • period (int) — The period over which to compute the MeanAbsoluteDeviation
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The MeanAbsoluteDeviation indicator for the requested symbol over the specified period

Return type:

MeanAbsoluteDeviation

mass(symbol, ema_period=9, sum_period=25, resolution=None, selector=None)[source]

Creates a new Mass Index indicator. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose Mass Index we want.
  • ema_period (int, optional) — The period used by both EMA.
  • sum_period (int, optional) — The sum period.
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Mass Index indicator for the requested symbol over the specified period

Return type:

MassIndex

max(symbol, period, resolution=None, selector=None)[source]

Creates a new Maximum indicator to compute the maximum value

Parameters:
  • symbol (Symbol) — The symbol whose max we want
  • period (int) — The look back period over which to compute the max value
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

A Maximum indicator that compute the max value and the periods since the max value

Return type:

Maximum

mfi(symbol, period, resolution=None, selector=None)[source]

Creates a new MoneyFlowIndex indicator. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose MFI we want
  • period (int) — The period over which to compute the MFI
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The MoneyFlowIndex indicator for the requested symbol over the specified period

Return type:

MoneyFlowIndex

midpoint(symbol, period, resolution=None, selector=None)[source]

Creates a new MidPoint indicator.

Parameters:
  • symbol (Symbol) — The symbol whose MIDPOINT we want
  • period (int) — The period over which to compute the MIDPOINT
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The MidPoint indicator for the requested symbol over the specified period

Return type:

MidPoint

midprice(symbol, period, resolution=None, selector=None)[source]

Creates a new MidPrice indicator.

Parameters:
  • symbol (Symbol) — The symbol whose MIDPRICE we want
  • period (int) — The period over which to compute the MIDPRICE
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The MidPrice indicator for the requested symbol over the specified period

Return type:

MidPrice

min(symbol, period, resolution=None, selector=None)[source]

Creates a new Minimum indicator to compute the minimum value

Parameters:
  • symbol (Symbol) — The symbol whose min we want
  • period (int) — The look back period over which to compute the min value
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

A Minimum indicator that compute the in value and the periods since the min value

Return type:

Minimum

mom(symbol, period, resolution=None, selector=None)[source]

Creates a new Momentum indicator. This will compute the absolute n-period change in the security. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose momentum we want
  • period (int) — The period over which to compute the momentum
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The momentum indicator for the requested symbol over the specified period

Return type:

Momentum

momersion(symbol, min_period, full_period, resolution=None, selector=None)[source]

Creates a new Momersion indicator.

Parameters:
  • symbol (Symbol) — The symbol whose Momersion we want
  • min_period (int) — The minimum period over which to compute the Momersion. Must be greater than 3. If null, only full period will be used in computations.
  • full_period (int) — The full period over which to compute the Momersion
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The Momersion indicator for the requested symbol over the specified period

Return type:

MomersionIndicator

momp(symbol, period, resolution=None, selector=None)[source]

Creates a new MomentumPercent indicator. This will compute the n-period percent change in the security. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose momentum we want
  • period (int) — The period over which to compute the momentum
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The momentum indicator for the requested symbol over the specified period

Return type:

MomentumPercent

mosc(symbols, fast_period=19, slow_period=39, resolution=None, selector=None)[source]

Creates a new McClellan Oscillator indicator

Parameters:
  • symbols (0, Culture=neutral, PublicKeyToken=null]] | Symbol) — The symbols whose McClellan Oscillator we want
  • fast_period (int, optional) — Fast period EMA of advance decline difference
  • slow_period (int, optional) — Slow period EMA of advance decline difference
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The McClellan Oscillator indicator for the requested symbol over the specified period

Return type:

McClellanOscillator

msi(symbols, fast_period=19, slow_period=39, resolution=None, selector=None)[source]

Creates a new McClellan Summation Index indicator

Parameters:
  • symbols (0, Culture=neutral, PublicKeyToken=null]] | Symbol) — The symbols whose McClellan Summation Index we want
  • fast_period (int, optional) — Fast period EMA of advance decline difference
  • slow_period (int, optional) — Slow period EMA of advance decline difference
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The McClellan Summation Index indicator for the requested symbol over the specified period

Return type:

McClellanSummationIndex

natr(symbol, period, resolution=None, selector=None)[source]

Creates a new NormalizedAverageTrueRange indicator.

Parameters:
  • symbol (Symbol) — The symbol whose NATR we want
  • period (int) — The period over which to compute the NATR
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The NormalizedAverageTrueRange indicator for the requested symbol over the specified period

Return type:

NormalizedAverageTrueRange

obv(symbol, resolution=None, selector=None)[source]

Creates a new On Balance Volume indicator. This will compute the cumulative total volume based on whether the close price being higher or lower than the previous period. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose On Balance Volume we seek
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The On Balance Volume indicator for the requested symbol.

Return type:

OnBalanceVolume

pphl(symbol, length_high, length_low, last_stored_values=100, resolution=None, selector=None)[source]

Creates a new PivotPointsHighLow indicator

Parameters:
  • symbol (Symbol) — The symbol whose PPHL we seek
  • length_high (int) — The number of surrounding bars whose high values should be less than the current bar's for the bar high to be marked as high pivot point
  • length_low (int) — The number of surrounding bars whose low values should be more than the current bar's for the bar low to be marked as low pivot point
  • last_stored_values (int, optional) — The number of last stored indicator values
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The PivotPointsHighLow indicator for the requested symbol.

Return type:

PivotPointsHighLow

ppo(symbol, fast_period, slow_period, moving_average_type, resolution=None, selector=None)[source]

Creates a new PercentagePriceOscillator indicator.

Parameters:
  • symbol (Symbol) — The symbol whose PPO we want
  • fast_period (int) — The fast moving average period
  • slow_period (int) — The slow moving average period
  • moving_average_type (MovingAverageType) — The type of moving average to use
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The PercentagePriceOscillator indicator for the requested symbol over the specified period

Return type:

PercentagePriceOscillator

psar(symbol, af_start=0.02, af_increment=0.02, af_max=0.2, resolution=None, selector=None)[source]

Creates a new Parabolic SAR indicator

Parameters:
  • symbol (Symbol) — The symbol whose PSAR we seek
  • af_start (float, optional) — Acceleration factor start value. Normally 0.02
  • af_increment (float, optional) — Acceleration factor increment value. Normally 0.02
  • af_max (float, optional) — Acceleration factor max value. Normally 0.2
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

A ParabolicStopAndReverse configured with the specified periods

Return type:

ParabolicStopAndReverse

r(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, iv_model=None, resolution=None)[source]

Removes the security with the specified symbol. This will cancel all open orders and then liquidate any existing holdings

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option for parity calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate Rho
  • iv_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new Rho indicator for the specified symbol

Return type:

Rho

rc(symbol, period, k, resolution=None, selector=None)[source]

Creates a new RegressionChannel indicator which will compute the LinearRegression, UpperChannel and LowerChannel lines, the intercept and slope

Parameters:
  • symbol (Symbol) — The symbol whose RegressionChannel we seek
  • period (int) — The period of the standard deviation and least square moving average (linear regression line)
  • k (float) — The number of standard deviations specifying the distance between the linear regression and upper or lower channel lines
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

A Regression Channel configured with the specified period and number of standard deviation

Return type:

RegressionChannel

rdv(symbol, period=2, resolution=4, selector=None)[source]

Creates an RelativeDailyVolume indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose RDV we want
  • period (int, optional) — The period of the RDV
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Relative Volume indicator for the given parameters

Return type:

RelativeDailyVolume

register_indicator(symbol, indicator, resolution, selector)[source]

Creates and registers a new consolidator to receive automatic updates at the specified resolution as well as configures the indicator to receive updates from the consolidator.

Parameters:
  • symbol (Symbol) — The symbol to register against
  • indicator (PyObject | None | 0, Culture=neutral, PublicKeyToken=null]]) — The indicator to receive data from the consolidator
  • resolution (0, Culture=neutral, PublicKeyToken=null]] | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]) — The resolution at which to send data to the indicator, null to use the same resolution as the subscription
  • selector (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]] | None) — (T)x)
register_indicator(symbol, indicator, py_object, selector=None)[source]

Creates and registers a new consolidator to receive automatic updates at the specified resolution as well as configures the indicator to receive updates from the consolidator.

Parameters:
  • symbol (Symbol) — The symbol to register against
  • indicator (PyObject) — The indicator to receive data from the consolidator
  • py_object (PyObject) — The python object that it is trying to register with, could be consolidator or a timespan
  • selector (PyObject, optional) — (T)x)
register_indicator(symbol, indicator, consolidator, selector=None)[source]

Creates and registers a new consolidator to receive automatic updates at the specified resolution as well as configures the indicator to receive updates from the consolidator.

Parameters:
  • symbol (Symbol) — The symbol to register against
  • indicator (PyObject | None | 0, Culture=neutral, PublicKeyToken=null]]) — The indicator to receive data from the consolidator
  • consolidator (IDataConsolidator) — The consolidator to receive raw subscription data
  • selector (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]] | None, optional) — (T)x)
rma(symbol, period, resolution=None, selector=None)[source]

Creates a new Relative Moving Average indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose relative moving average we seek
  • period (int) — The period of the relative moving average
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

A relative moving average configured with the specified period and number of standard deviation

Return type:

RelativeMovingAverage

roc(symbol, period, resolution=None, selector=None)[source]

Creates a new RateOfChange indicator. This will compute the n-period rate of change in the security. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose RateOfChange we want
  • period (int) — The period over which to compute the RateOfChange
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The RateOfChange indicator for the requested symbol over the specified period

Return type:

RateOfChange

rocp(symbol, period, resolution=None, selector=None)[source]

Creates a new RateOfChangePercent indicator. This will compute the n-period percentage rate of change in the security. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose RateOfChangePercent we want
  • period (int) — The period over which to compute the RateOfChangePercent
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The RateOfChangePercent indicator for the requested symbol over the specified period

Return type:

RateOfChangePercent

rocr(symbol, period, resolution=None, selector=None)[source]

Creates a new RateOfChangeRatio indicator.

Parameters:
  • symbol (Symbol) — The symbol whose ROCR we want
  • period (int) — The period over which to compute the ROCR
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The RateOfChangeRatio indicator for the requested symbol over the specified period

Return type:

RateOfChangeRatio

rsi(symbol, period, moving_average_type=2, resolution=None, selector=None)[source]

Creates a new RelativeStrengthIndex indicator. This will produce an oscillator that ranges from 0 to 100 based on the ratio of average gains to average losses over the specified period.

Parameters:
  • symbol (Symbol) — The symbol whose RSI we want
  • period (int) — The period over which to compute the RSI
  • moving_average_type (MovingAverageType, optional) — The type of moving average to use in computing the average gainloss values
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The RelativeStrengthIndex indicator for the requested symbol over the specified period

Return type:

RelativeStrengthIndex

rvi(symbol, period, moving_average_type=0, resolution=None, selector=None)[source]

Creates a new RelativeVigorIndex indicator.

Parameters:
  • symbol (Symbol) — The symbol whose RVI we want
  • period (int) — The period over which to compute the RVI
  • moving_average_type (MovingAverageType, optional) — The type of moving average to use
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The RelativeVigorIndex indicator for the requested symbol over the specified period

Return type:

RelativeVigorIndex

si(symbol, limit_move, resolution=4, selector=None)[source]

Creates a Wilder Swing Index (SI) indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose SI we want
  • limit_move (float) — The maximum daily change in price for the SI
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The WilderSwingIndex for the given parameters

Return type:

WilderSwingIndex

sma(symbol, period, resolution=None, selector=None)[source]

Creates an SimpleMovingAverage indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose SMA we want
  • period (int) — The period of the SMA
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The SimpleMovingAverage for the given parameters

Return type:

SimpleMovingAverage

sortino(symbol, sortino_period, minimum_acceptable_return=0.0, resolution=None, selector=None)[source]

Creates a new Sortino indicator.

Parameters:
  • symbol (Symbol) — The symbol whose Sortino we want
  • sortino_period (int) — Period of historical observation for Sortino ratio calculation
  • minimum_acceptable_return (float, optional) — Minimum acceptable return (eg risk-free rate) for the Sortino ratio calculation
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The SortinoRatio indicator for the requested symbol over the specified period

Return type:

SortinoRatio

sr(symbol, sharpe_period, risk_free_rate=None, resolution=None, selector=None)[source]

Creates a new SharpeRatio indicator.

Parameters:
  • symbol (Symbol) — The symbol whose RSR we want
  • sharpe_period (int) — Period of historical observation for sharpe ratio calculation
  • risk_free_rate (float, optional) —
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The SharpeRatio indicator for the requested symbol over the specified period

Return type:

SharpeRatio

stc(symbol, cycle_period, fast_period, slow_period, moving_average_type=1, resolution=None, selector=None)[source]

Creates a new Schaff Trend Cycle indicator

Parameters:
  • symbol (Symbol) — The symbol for the indicator to track
  • cycle_period (int) — The fast moving average period
  • fast_period (int) — The slow moving average period
  • slow_period (int) — The signal period
  • moving_average_type (MovingAverageType, optional) — The type of moving average to use
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The SchaffTrendCycle indicator for the requested symbol over the specified period

Return type:

SchaffTrendCycle

std(symbol, period, resolution=None, selector=None)[source]

Creates a new StandardDeviation indicator. This will return the population standard deviation of samples over the specified period.

Parameters:
  • symbol (Symbol) — The symbol whose STD we want
  • period (int) — The period over which to compute the STD
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The StandardDeviation indicator for the requested symbol over the specified period

Return type:

StandardDeviation

sto(symbol, period, k_period, d_period, resolution=None, selector=None)[source]

Creates a new Stochastic indicator.

Parameters:
  • symbol (Symbol) — The symbol whose stochastic we seek
  • period (int) — The period of the stochastic. Normally 14
  • k_period (int) — The sum period of the stochastic. Normally 14
  • d_period (int) — The sum period of the stochastic. Normally 3
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

Stochastic indicator for the requested symbol.

Return type:

Stochastic

str(symbol, period, multiplier, moving_average_type=2, resolution=None, selector=None)[source]

Creates a new SuperTrend indicator.

Parameters:
  • symbol (Symbol) — The symbol whose SuperTrend indicator we want.
  • period (int) — The smoothing period for average true range.
  • multiplier (float) — Multiplier to calculate basic upper and lower bands width.
  • moving_average_type (MovingAverageType, optional) — Smoother type for average true range, defaults to Wilders.
  • resolution (Resolution, optional) — The resolution.
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Return type:

SuperTrend

sum(symbol, period, resolution=None, selector=None)[source]

Creates a new Sum indicator.

Parameters:
  • symbol (Symbol) — The symbol whose Sum we want
  • period (int) — The period over which to compute the Sum
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The Sum indicator for the requested symbol over the specified period

Return type:

Sum

swiss(symbol, period, delta, tool, resolution=None, selector=None)[source]

Creates Swiss Army Knife transformation for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol to use for calculations
  • period (int) — The period of the calculation
  • delta (float) — The delta scale of the BandStop or BandPass
  • tool (SwissArmyKnifeTool) — The tool os the Swiss Army Knife
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The calculation using the given tool

Return type:

SwissArmyKnife

t(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, iv_model=None, resolution=None)[source]

For the given symbol will resolve the ticker it used at the current algorithm date

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option for parity calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate Theta
  • iv_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new Theta indicator for the specified symbol

Return type:

Theta

t_3(symbol, period, volume_factor=0.7, resolution=None, selector=None)[source]

Creates a new T3MovingAverage indicator.

Parameters:
  • symbol (Symbol) — The symbol whose T3 we want
  • period (int) — The period over which to compute the T3
  • volume_factor (float, optional) — The volume factor to be used for the T3 (value must be in the [0,1] range, defaults to 0.7)
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The T3MovingAverage indicator for the requested symbol over the specified period

Return type:

T3MovingAverage

tdd(symbol, period, minimum_acceptable_return=0.0, resolution=None, selector=None)[source]

Creates a new TargetDownsideDeviation indicator. The target downside deviation is defined as the root-mean-square, or RMS, of the deviations of the realized return’s underperformance from the target return where all returns above the target return are treated as underperformance of 0.

Parameters:
  • symbol (Symbol) — The symbol whose TDD we want
  • period (int) — The period over which to compute the TDD
  • minimum_acceptable_return (float, optional) — The resolution
  • resolution (Resolution, optional) — Minimum acceptable return (MAR) for the target downside deviation calculation
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The TargetDownsideDeviation indicator for the requested symbol over the specified period

Return type:

TargetDownsideDeviation

tema(symbol, period, resolution=None, selector=None)[source]

Creates a new TripleExponentialMovingAverage indicator.

Parameters:
  • symbol (Symbol) — The symbol whose TEMA we want
  • period (int) — The period over which to compute the TEMA
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The TripleExponentialMovingAverage indicator for the requested symbol over the specified period

Return type:

TripleExponentialMovingAverage

tp(symbol, period=2, value_area_volume_percentage=0.7, price_range_round_off=0.05, resolution=4, selector=None)[source]

Creates an Market Profile indicator for the symbol with Time Price Opportunity (TPO) mode. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose TP we want
  • period (int, optional) — The period of the TP
  • value_area_volume_percentage (float, optional) — The percentage of volume contained in the value area
  • price_range_round_off (float, optional) — How many digits you want to round and the precision. i.e 0.01 round to two digits exactly.
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Time Profile indicator for the given parameters

Return type:

TimeProfile

tr(symbol, resolution=None, selector=None)[source]

Creates a new TrueRange indicator.

Parameters:
  • symbol (Symbol) — The symbol whose TR we want
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The TrueRange indicator for the requested symbol.

Return type:

TrueRange

trima(symbol, period, resolution=None, selector=None)[source]

Creates a new TriangularMovingAverage indicator.

Parameters:
  • symbol (Symbol) — The symbol whose TRIMA we want
  • period (int) — The period over which to compute the TRIMA
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The TriangularMovingAverage indicator for the requested symbol over the specified period

Return type:

TriangularMovingAverage

trin(symbols, resolution=None, selector=None)[source]

Creates a new Arms Index indicator

Parameters:
  • symbols (0, Culture=neutral, PublicKeyToken=null]] | Symbol) — The symbols whose Arms Index we want
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Arms Index indicator for the requested symbol over the specified period

Return type:

ArmsIndex

trix(symbol, period, resolution=None, selector=None)[source]

Creates a new Trix indicator.

Parameters:
  • symbol (Symbol) — The symbol whose TRIX we want
  • period (int) — The period over which to compute the TRIX
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The Trix indicator for the requested symbol over the specified period

Return type:

Trix

tsf(symbol, period, resolution=None, selector=None)[source]

Creates a new Time Series Forecast indicator

Parameters:
  • symbol (Symbol) — The symbol whose TSF we want
  • period (int) — The period of the TSF
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The TimeSeriesForecast indicator for the requested symbol over the specified period

Return type:

TimeSeriesForecast

tsi(symbol, long_term_period=25, short_term_period=13, signal_period=7, signal_type=1, resolution=None, selector=None)[source]

Creates a TrueStrengthIndex indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose TSI we want
  • long_term_period (int, optional) — Period used for the first price change smoothing
  • short_term_period (int, optional) — Period used for the second (double) price change smoothing
  • signal_period (int, optional) — The signal period
  • signal_type (MovingAverageType, optional) — The type of moving average to use for the signal
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The TrueStrengthIndex indicator for the given parameters

Return type:

TrueStrengthIndex

ultosc(symbol, period_1, period_2, period_3, resolution=None, selector=None)[source]

Creates a new UltimateOscillator indicator.

Parameters:
  • symbol (Symbol) — The symbol whose ULTOSC we want
  • period_1 (int) — The first period over which to compute the ULTOSC
  • period_2 (int) — The second period over which to compute the ULTOSC
  • period_3 (int) — The third period over which to compute the ULTOSC
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The UltimateOscillator indicator for the requested symbol over the specified period

Return type:

UltimateOscillator

v(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, iv_model=None, resolution=None)[source]

Creates an Market Profile indicator for the symbol with Volume Profile (VOL) mode. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option for parity calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate Vega
  • iv_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new Vega indicator for the specified symbol

Return type:

Vega

v(symbol, period, resolution=None, selector=None)[source]

Creates an Market Profile indicator for the symbol with Volume Profile (VOL) mode. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose variance we want
  • period (int) — The period over which to compute the variance
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The Variance indicator for the requested symbol over the specified period

Return type:

Variance

vidya(symbol, period, resolution=None, selector=None)[source]

Creates a new Chande's Variable Index Dynamic Average indicator.

Parameters:
  • symbol (Symbol) — The symbol whose VIDYA we want
  • period (int) — The period over which to compute the VIDYA
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The VariableIndexDynamicAverage indicator for the requested symbol over the specified period

Return type:

VariableIndexDynamicAverage

vp(symbol, period=2, value_area_volume_percentage=0.7, price_range_round_off=0.05, resolution=4, selector=None)[source]

Creates an Market Profile indicator for the symbol with Volume Profile (VOL) mode. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose VP we want
  • period (int, optional) — The period of the VP
  • value_area_volume_percentage (float, optional) — The percentage of volume contained in the value area
  • price_range_round_off (float, optional) — How many digits you want to round and the precision. i.e 0.01 round to two digits exactly.
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Volume Profile indicator for the given parameters

Return type:

VolumeProfile

vwap(symbol, period, resolution=None, selector=None)[source]

Creates an VolumeWeightedAveragePrice (VWAP) indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose VWAP we want
  • period (int) — The period of the VWAP
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, TradeBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The VolumeWeightedAveragePrice for the given parameters

Return type:

VolumeWeightedAveragePriceIndicator

warm_up_indicator(symbol, indicator, resolution=None, selector=None)[source]

Warms up a given indicator with historical data

Parameters:
  • symbol (Symbol) — The symbol whose indicator we want
  • indicator (PyObject | None | 0, Culture=neutral, PublicKeyToken=null]]) — The indicator we want to warm up
  • resolution (Resolution, optional) — The resolution
  • selector (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]] | None, optional) — (T)x)
wilr(symbol, period, resolution=None, selector=None)[source]

Creates a new Williams %R indicator. This will compute the percentage change of the current closing price in relation to the high and low of the past N periods. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose Williams %R we want
  • period (int) — The period over which to compute the Williams %R
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, IBaseDataBar], optional) — Selects a value from the BaseData to send into the indicator, if null defaults to casting the input value to a TradeBar
Returns:

The Williams %R indicator for the requested symbol over the specified period

Return type:

WilliamsPercentR

wwma(symbol, period, resolution=None, selector=None)[source]

Creates a WilderMovingAverage indicator for the symbol. The indicator will be automatically updated on the given resolution.

Parameters:
  • symbol (Symbol) — The symbol whose WMA we want
  • period (int) — The period of the WMA
  • resolution (Resolution, optional) — The resolution
  • selector (Callable[IBaseData, float], optional) — x.Value)
Returns:

The WilderMovingAverage for the given parameters

Return type:

WilderMovingAverage

γ(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, iv_model=None, resolution=None)[source]

Creates a new Gamma indicator for the symbol The indicator will be automatically updated on the symbol's subscription resolution

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option for parity calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate Gamma
  • iv_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new Gamma indicator for the specified symbol

Return type:

Gamma

δ(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, iv_model=None, resolution=None)[source]

Creates a new Delta indicator for the symbol The indicator will be automatically updated on the symbol's subscription resolution

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option for parity calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate Delta
  • iv_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new Delta indicator for the specified symbol

Return type:

Delta

θ(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, iv_model=None, resolution=None)[source]

Creates a new Theta indicator for the symbol The indicator will be automatically updated on the symbol's subscription resolution

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option for parity calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate Theta
  • iv_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new Theta indicator for the specified symbol

Return type:

Theta

ρ(symbol, mirror_option=None, risk_free_rate=None, dividend_yield=None, option_model=0, iv_model=None, resolution=None)[source]

Creates a new Rho indicator for the symbol The indicator will be automatically updated on the symbol's subscription resolution

Parameters:
  • symbol (Symbol) — The option symbol whose values we want as an indicator
  • mirror_option (Symbol, optional) — The mirror option for parity calculation
  • risk_free_rate (float, optional) — The risk free rate
  • dividend_yield (float, optional) — The dividend yield
  • option_model (OptionPricingModelType, optional) — The option pricing model used to estimate Rho
  • iv_model (OptionPricingModelType, optional) — The option pricing model used to estimate IV
  • resolution (Resolution, optional) — The desired resolution of the data
Returns:

A new Rho indicator for the specified symbol

Return type:

Rho

property candlestick_patterns[source]

Gets an instance to access the candlestick pattern helper methods

Returns:

Gets an instance to access the candlestick pattern helper methods

Return type:

CandlestickPatterns

property enable_automatic_indicator_warm_up[source]

Gets whether or not WarmUpIndicator is allowed to warm up indicators/>

Returns:

Gets whether or not WarmUpIndicator is allowed to warm up indicators/>

Return type:

bool

Live Trading

Live Trading

on_brokerage_disconnect()[source]

Brokerage disconnected event handler. This method is called when the brokerage connection is lost.

on_brokerage_message(message_event)[source]

Brokerage message event handler. This method is called for all types of brokerage messages.

Parameters:
on_brokerage_reconnect()[source]

Brokerage reconnected event handler. This method is called when the brokerage connection is restored after a disconnection.

set_live_mode(live)[source]

Set live mode state of the algorithm run: Public setter for the algorithm property LiveMode.

Parameters:
  • live (bool)
set_status(status)[source]

Set the state of a live deployment

Parameters:
property live_mode[source]

Boolean property indicating the algorithm is currently running in live mode.

Returns:

Boolean property indicating the algorithm is currently running in live mode.

Return type:

bool

property notify[source]

Notification Manager for Sending Live Runtime Notifications to users about important events.

Returns:

Notification Manager for Sending Live Runtime Notifications to users about important events.

Return type:

NotificationManager

Logging

Logging

debug(message)[source]

Send a debug message to the web console:

Parameters:
  • message (PyObject | str | int | float) — Message to send to debug console
error(message)[source]

Send a string error message to the Console.

Parameters:
  • message (PyObject | str | int | float) — Message to display in errors grid
error(error)[source]

Send a string error message to the Console.

Parameters:
  • error (Exception) — Exception object captured from a try catch loop
log(message)[source]

Added another method for logging if user guessed.

Parameters:
  • message (PyObject | str | int | float) — String message to log.
quit(message)[source]

Terminate the algorithm after processing the current event handler.

Parameters:
  • message (PyObject | str) — Exit message to display on quitting
set_quit(quit)[source]

Set the Quit flag property of the algorithm.

Parameters:
  • quit (bool) — Boolean quit state
property debug_messages[source]

Storage for debugging messages before the event handler has passed control back to the Lean Engine.

Returns:

Storage for debugging messages before the event handler has passed control back to the Lean Engine.

Return type:

ConcurrentQueue[str]

property debug_mode[source]

Enables additional logging of framework models including: All insights, portfolio targets, order events, and any risk management altered targets

Returns:

Enables additional logging of framework models including: All insights, portfolio targets, order events, and any risk management altered targets

Return type:

bool

property error_messages[source]

List of error messages generated by the user's code calling the "Error" function.

Returns:

List of error messages generated by the user's code calling the "Error" function.

Return type:

ConcurrentQueue[str]

property log_messages[source]

Storage for log messages before the event handlers have passed control back to the Lean Engine.

Returns:

Storage for log messages before the event handlers have passed control back to the Lean Engine.

Return type:

ConcurrentQueue[str]

property run_time_error[source]

Gets the run time error from the algorithm, or null if none was encountered.

Returns:

Gets the run time error from the algorithm, or null if none was encountered.

Return type:

Exception

Machine Learning

Machine Learning

train(date_rule, time_rule, training_code)[source]

Schedules the provided training code to execute immediately

Parameters:
  • date_rule (IDateRule) — Specifies what dates the event should run
  • time_rule (ITimeRule) — Specifies the times on those dates the event should run
  • training_code (Action | PyObject) — The training code to be invoked
Return type:

ScheduledEvent

Modeling

Modeling

on_margin_call(requests)[source]

Margin call event handler. This method is called right before the margin call orders are placed in the market.

Parameters:
  • requests (List[SubmitOrderRequest]) — The orders to be executed to bring this algorithm within margin limits
on_margin_call_warning()[source]

Margin call warning event handler. This method is called when Portfolio.MarginRemaining is under 5% of your Portfolio.TotalPortfolioValue

set_brokerage_message_handler(handler)[source]

Sets the implementation used to handle messages from the brokerage. The default implementation will forward messages to debug or error and when a Error occurs, the algorithm is stopped.

Parameters:
  • handler (PyObject | IBrokerageMessageHandler) — The message handler to use
set_brokerage_model(brokerage, account_type=0)[source]

Sets the brokerage to emulate in backtesting or paper trading. This can be used for brokerages that have been implemented in LEAN

Parameters:
  • brokerage (BrokerageName) — The brokerage to emulate
  • account_type (AccountType, optional) — The account type (Cash or Margin)
set_brokerage_model(model)[source]

Sets the brokerage to emulate in backtesting or paper trading. This can be used for brokerages that have been implemented in LEAN

Parameters:
  • model (PyObject | IBrokerageModel) — The brokerage model to use
set_risk_free_interest_rate_model(model)[source]

Sets the risk free interest rate model to be used in the algorithm

Parameters:
  • model (PyObject | IRiskFreeInterestRateModel) — The risk free interest rate model to use
property brokerage_message_handler[source]

Gets the brokerage message handler used to decide what to do with each message sent from the brokerage

Returns:

Gets the brokerage message handler used to decide what to do with each message sent from the brokerage

Return type:

IBrokerageMessageHandler

property brokerage_model[source]

Gets the brokerage model - used to model interactions with specific brokerages.

Returns:

Gets the brokerage model - used to model interactions with specific brokerages.

Return type:

IBrokerageModel

property brokerage_name[source]

Gets the brokerage name.

Returns:

Gets the brokerage name.

Return type:

BrokerageName

property risk_free_interest_rate_model[source]

Gets the risk free interest rate model used to get the interest rates

Returns:

Gets the risk free interest rate model used to get the interest rates

Return type:

IRiskFreeInterestRateModel

Parameter and Optimization

Parameter and Optimization

get_parameter(name, default_value)[source]

Gets the parameter with the specified name. If a parameter with the specified name does not exist, the given default value is returned if any, else null

Parameters:
  • name (str) — The name of the parameter to get
  • default_value (str | int | float) — The default value to return
Returns:

The value of the specified parameter, or defaultValue if not found or null if there's no default value

Return type:

str

get_parameters()[source]

Gets a read-only dictionary with all current parameters

Return type:

IReadOnlyDict[str, str]

set_parameters(parameters)[source]

Sets the parameters from the dictionary

Parameters:
  • parameters (Dict[str, str]) — Dictionary containing the parameter names to values

Scheduled Events

Scheduled Events

property date_rules[source]

Gets the date rules helper object to make specifying dates for events easier

Returns:

Gets the date rules helper object to make specifying dates for events easier

Return type:

DateRules

property schedule[source]

Gets schedule manager for adding/removing scheduled events

Returns:

Gets schedule manager for adding/removing scheduled events

Return type:

ScheduleManager

property time_rules[source]

Gets the time rules helper object to make specifying times for events easier

Returns:

Gets the time rules helper object to make specifying times for events easier

Return type:

TimeRules

property trading_calendar[source]

Gets trading calendar populated with trading events

Returns:

Gets trading calendar populated with trading events

Return type:

TradingCalendar

Securities and Portfolio

Securities and Portfolio

set_account_currency(account_currency, starting_cash=None)[source]

Sets the account currency cash symbol this algorithm is to manage, as well as the starting cash in this currency if given

Parameters:
  • account_currency (str) — The account currency cash symbol to set
  • starting_cash (float, optional) — The account currency starting cash to set
set_cash(symbol, starting_cash, conversion_rate=0.0)[source]

Set initial cash for the strategy while backtesting. During live mode this value is ignored and replaced with the actual cash of your brokerage account.

Parameters:
  • symbol (str) — The cash symbol to set
  • starting_cash (int | float) — Decimal cash value of portfolio
  • conversion_rate (float, optional) — The current conversion rate for the
property account_currency[source]

Gets the account currency

Returns:

Gets the account currency

Return type:

str

property active_securities[source]

Read-only dictionary containing all active securities. An active security is a security that is currently selected by the universe or has holdings or open orders.

Returns:

Read-only dictionary containing all active securities. An active security is a security that is currently selected by the universe or has holdings or open orders.

Return type:

IReadOnlyDict[Symbol, Security]

property portfolio[source]

Portfolio object provieds easy access to the underlying security-holding properties; summed together in a way to make them useful. This saves the user time by providing common portfolio requests in a single

Returns:

Portfolio object provieds easy access to the underlying security-holding properties; summed together in a way to make them useful. This saves the user time by providing common portfolio requests in a single

Return type:

SecurityPortfolioManager

property securities[source]

Security collection is an array of the security objects such as Equities and FOREX. Securities data manages the properties of tradeable assets such as price, open and close time and holdings information.

Returns:

Security collection is an array of the security objects such as Equities and FOREX. Securities data manages the properties of tradeable assets such as price, open and close time and holdings information.

Return type:

SecurityManager

property signal_export[source]

SignalExport - Allows sending export signals to different 3rd party API's. For example, it allows to send signals to Collective2, CrunchDAO and Numerai API's

Returns:

SignalExport - Allows sending export signals to different 3rd party API's. For example, it allows to send signals to Collective2, CrunchDAO and Numerai API's

Return type:

SignalExportManager

Statistics

Statistics

set_summary_statistic(name, value)[source]

Set a custom summary statistic for the algorithm.

Parameters:
  • name (str) — Name of the custom summary statistic
  • value (str | int | float) — Value of the custom summary statistic
property statistics[source]

The current statistics for the running algorithm.

Returns:

The current statistics for the running algorithm.

Return type:

StatisticsResults

Trading and Orders

Trading and Orders

buy(strategy, quantity, asynchronous=False, tag=, order_properties=None)[source]

Buy Stock (Alias of Order)

Parameters:
  • strategy (OptionStrategy) — Specification of the strategy to trade
  • quantity (int) — Quantity of the strategy to trade
  • asynchronous (bool, optional) — Send the order asynchronously (false). Otherwise we'll block until it fills
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

Sequence of order tickets

Return type:

List[OrderTicket]

buy(symbol, quantity)[source]

Buy Stock (Alias of Order)

Parameters:
  • symbol (Symbol) — string Symbol of the asset to trade
  • quantity (int | float) — int Quantity of the asset to trade
Returns:

The order ticket instance.

Return type:

OrderTicket

calculate_order_quantity(symbol, target)[source]

Calculate the order quantity to achieve target-percent holdings.

Parameters:
  • symbol (Symbol) — Security object we're asking for
  • target (float) — Target percentage holdings
Returns:

Order quantity to achieve this percentage

Return type:

float

combo_leg_limit_order(legs, quantity, tag=, order_properties=None)[source]

Issue a combo leg limit order/trade for multiple assets, each having its own limit price.

Parameters:
  • legs (List[Leg]) — The list of legs the order consists of
  • quantity (int) — The total quantity for the order
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

Sequence of order tickets, one for each leg

Return type:

List[OrderTicket]

combo_limit_order(legs, quantity, limit_price, tag=, order_properties=None)[source]

Issue a combo limit order/trade for multiple assets. A single limit price is defined for the combo order and will fill only if the sum of the assets price compares properly to the limit price, depending on the direction.

Parameters:
  • legs (List[Leg]) — The list of legs the order consists of
  • quantity (int) — The total quantity for the order
  • limit_price (float) — The compound limit price to use for a ComboLimit order. This limit price will compared to the sum of the assets price in order to fill the order.
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

Sequence of order tickets, one for each leg

Return type:

List[OrderTicket]

combo_market_order(legs, quantity, asynchronous=False, tag=, order_properties=None)[source]

Issue a combo market order/trade for multiple assets

Parameters:
  • legs (List[Leg]) — The list of legs the order consists of
  • quantity (int) — The total quantity for the order
  • asynchronous (bool, optional) — Send the order asynchronously (false). Otherwise we'll block until it fills
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

Sequence of order tickets, one for each leg

Return type:

List[OrderTicket]

exercise_option(option_symbol, quantity, asynchronous=False, tag=, order_properties=None)[source]

Send an exercise order to the transaction handler

Parameters:
  • option_symbol (Symbol) — String symbol for the option position
  • quantity (int) — Quantity of options contracts
  • asynchronous (bool, optional) — Send the order asynchronously (false). Otherwise we'll block until it fills
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

is_market_open(symbol)[source]

Determines if the exchange for the specified symbol is open at the current time.

Parameters:
  • symbol (Symbol) — The symbol
Returns:

True if the exchange is considered open at the current time, false otherwise

Return type:

bool

limit_if_touched_order(symbol, quantity, trigger_price, limit_price, tag=, order_properties=None)[source]

Send a limit if touched order to the transaction handler:

Parameters:
  • symbol (Symbol) — String symbol for the asset
  • quantity (int | float) — Quantity of shares for limit order
  • trigger_price (float) — Trigger price for this order
  • limit_price (float) — Limit price to fill this order
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

limit_order(symbol, quantity, limit_price, tag=, order_properties=None)[source]

Send a limit order to the transaction handler:

Parameters:
  • symbol (Symbol) — String symbol for the asset
  • quantity (int | float) — Quantity of shares for limit order
  • limit_price (float) — Limit price to fill this order
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

liquidate(symbol_to_liquidate=None, tag=Liquidated)[source]

Liquidate all holdings and cancel open orders. Called at the end of day for tick-strategies.

Parameters:
  • symbol_to_liquidate (Symbol, optional) — Symbols we wish to liquidate
  • tag (str, optional) — Custom tag to know who is calling this.
Returns:

Array of order ids for liquidated symbols

Return type:

List[int]

market_on_close_order(symbol, quantity, tag=, order_properties=None)[source]

Market on close order implementation: Send a market order when the exchange closes

Parameters:
  • symbol (Symbol) — The symbol to be ordered
  • quantity (int | float) — The number of shares to required
  • tag (str, optional) — Place a custom order property or tag (e.g. indicator data).
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

market_on_open_order(symbol, quantity, tag=, order_properties=None)[source]

Market on open order implementation: Send a market order when the exchange opens

Parameters:
  • symbol (Symbol) — The symbol to be ordered
  • quantity (int | float) — The number of shares to required
  • tag (str, optional) — Place a custom order property or tag (e.g. indicator data).
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

market_order(symbol, quantity, asynchronous=False, tag=, order_properties=None)[source]

Market order implementation: Send a market order and wait for it to be filled.

Parameters:
  • symbol (Symbol) — Symbol of the MarketType Required.
  • quantity (int | float) — Number of shares to request.
  • asynchronous (bool, optional) — Send the order asynchronously (false). Otherwise we'll block until it fills
  • tag (str, optional) — Place a custom order property or tag (e.g. indicator data).
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

market_order(security, quantity, asynchronous=False, tag=, order_properties=None)[source]

Market order implementation: Send a market order and wait for it to be filled.

Parameters:
  • security (Security) — Symbol of the MarketType Required.
  • quantity (float) — Number of shares to request.
  • asynchronous (bool, optional) — Send the order asynchronously (false). Otherwise we'll block until it fills
  • tag (str, optional) — Place a custom order property or tag (e.g. indicator data).
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

on_assignment_order_event(assignment_event)[source]

Option assignment event handler. On an option assignment event for short legs the resulting information is passed to this method.

Parameters:
  • assignment_event (OrderEvent) — Option exercise event details containing details of the assignment
on_order_event(order_event)[source]

Order fill event handler. On an order fill update the resulting information is passed to this method.

Parameters:
  • order_event (OrderEvent) — Order event details containing details of the events
order(strategy, quantity, asynchronous=False, tag=, order_properties=None)[source]

Issue an order/trade for asset: Alias wrapper for Order(string, int);

Parameters:
  • strategy (OptionStrategy) — Specification of the strategy to trade
  • quantity (int) — Quantity of the strategy to trade
  • asynchronous (bool, optional) — Send the order asynchronously (false). Otherwise we'll block until it fills
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

Sequence of order tickets

Return type:

List[OrderTicket]

order(symbol, quantity, asynchronous=False, tag=, order_properties=None)[source]

Issue an order/trade for asset: Alias wrapper for Order(string, int);

Parameters:
  • symbol (Symbol) — Symbol of the MarketType Required.
  • quantity (int | float) — Number of shares to request.
  • asynchronous (bool, optional) — Send the order asynchronously (false). Otherwise we'll block until it fills
  • tag (str, optional) — Place a custom order property or tag (e.g. indicator data).
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

sell(strategy, quantity, asynchronous=False, tag=, order_properties=None)[source]

Sell stock (alias of Order)

Parameters:
  • strategy (OptionStrategy) — Specification of the strategy to trade
  • quantity (int) — Quantity of the strategy to trade
  • asynchronous (bool, optional) — Send the order asynchronously (false). Otherwise we'll block until it fills
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

Sequence of order tickets

Return type:

List[OrderTicket]

sell(symbol, quantity)[source]

Sell stock (alias of Order)

Parameters:
  • symbol (Symbol) — string Symbol of the asset to trade
  • quantity (int | float) — int Quantity of the asset to trade
Returns:

The order ticket instance.

Return type:

OrderTicket

set_benchmark(benchmark)[source]

Sets the benchmark used for computing statistics of the algorithm to the specified symbol

Parameters:
  • benchmark (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]) — The benchmark producing function
set_benchmark(ticker)[source]

Sets the benchmark used for computing statistics of the algorithm to the specified symbol

Parameters:
  • ticker (str) — Ticker to use as the benchmark
set_benchmark(symbol)[source]

Sets the benchmark used for computing statistics of the algorithm to the specified symbol

Parameters:
  • symbol (Symbol) — symbol to use as the benchmark
set_holdings(symbol, percentage, liquidate_existing_holdings=False, tag=, order_properties=None)[source]

Sets holdings for a collection of targets. The implementation will order the provided targets executing first those that reduce a position, freeing margin.

Parameters:
  • symbol (Symbol) — string symbol we wish to hold
  • percentage (int | float) — double percentage of holdings desired
  • liquidate_existing_holdings (bool, optional) — liquidate existing holdings if necessary to hold this stock
  • tag (str, optional) — Tag the order with a short string.
  • order_properties (IOrderProperties, optional)
set_holdings(targets, liquidate_existing_holdings=False, tag=, order_properties=None)[source]

Sets holdings for a collection of targets. The implementation will order the provided targets executing first those that reduce a position, freeing margin.

Parameters:
  • targets (List[PortfolioTarget]) — The portfolio desired quantities as percentages
  • liquidate_existing_holdings (bool, optional) — True will liquidate existing holdings
  • tag (str, optional) — Tag the order with a short string.
  • order_properties (IOrderProperties, optional)
set_maximum_orders(max)[source]

Maximum number of orders for the algorithm

Parameters:
  • max (int)
set_trade_builder(trade_builder)[source]

Set the ITradeBuilder implementation to generate trades from executions and market price updates

Parameters:
  • trade_builder (ITradeBuilder)
shortable(symbol, short_quantity, update_order_id=None)[source]

Determines if the Symbol is shortable at the brokerage

Parameters:
  • symbol (Symbol) — Symbol to check if shortable
  • short_quantity (float) — Order's quantity to check if it is currently shortable, taking into account current holdings and open orders
  • update_order_id (int, optional) — Optionally the id of the order being updated. When updating an order we want to ignore it's submitted short quantity and use the new provided quantity to determine if we can perform the update
Returns:

True if the symbol can be shorted by the requested quantity

Return type:

bool

shortable_quantity(symbol)[source]

Gets the quantity shortable for the given asset

Parameters:
Returns:

Quantity shortable for the given asset. Zero if not shortable, or a number greater than zero if shortable.

Return type:

int

stop_limit_order(symbol, quantity, stop_price, limit_price, tag=, order_properties=None)[source]

Send a stop limit order to the transaction handler:

Parameters:
  • symbol (Symbol) — String symbol for the asset
  • quantity (int | float) — Quantity of shares for limit order
  • stop_price (float) — Stop price for this order
  • limit_price (float) — Limit price to fill this order
  • tag (str, optional) — String tag for the order (optional)
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

stop_market_order(symbol, quantity, stop_price, tag=, order_properties=None)[source]

Create a stop market order and return the newly created order id; or negative if the order is invalid

Parameters:
  • symbol (Symbol) — String symbol for the asset we're trading
  • quantity (int | float) — Quantity to be traded
  • stop_price (float) — Price to fill the stop order
  • tag (str, optional) — Optional string data tag for the order
  • order_properties (IOrderProperties, optional)
Returns:

The order ticket instance.

Return type:

OrderTicket

submit_order_request(request)[source]

Will submit an order request to the algorithm

Parameters:
Returns:

The order ticket

Return type:

OrderTicket

trailing_stop_order(symbol, quantity, stop_price, trailing_amount, trailing_as_percentage, tag=, order_properties=None)[source]

Create a trailing stop order and return the newly created order id; or negative if the order is invalid. It will calculate the stop price using the trailing amount and the current market price.

Parameters:
  • symbol (Symbol) — Trading asset symbol
  • quantity (int | float) — Quantity to be traded
  • stop_price (float) — Initial stop price at which the order should be triggered
  • trailing_amount (float) — The trailing amount to be used to update the stop price
  • trailing_as_percentage (bool) — is a percentage or an absolute currency value
  • tag (str, optional) — is a percentage or an absolute currency value
  • order_properties (IOrderProperties, optional) — Optional string data tag for the order
Returns:

The order ticket instance.

Return type:

OrderTicket

property benchmark[source]

Benchmark

Returns:

Benchmark

Return type:

IBenchmark

property default_order_properties[source]

Gets the default order properties

Returns:

Gets the default order properties

Return type:

IOrderProperties

property trade_builder[source]

Gets the Trade Builder to generate trades from executions

Returns:

Gets the Trade Builder to generate trades from executions

Return type:

ITradeBuilder

property transactions[source]

Transaction Manager - Process transaction fills and order management.

Returns:

Transaction Manager - Process transaction fills and order management.

Return type:

SecurityTransactionManager

Universes

Universes

add_universe(t, security_type, name, resolution, market, universe_settings, selector)[source]

Adds a new universe selection model

Parameters:
  • t (PyObject) — The data type
  • security_type (SecurityType) — The security type the universe produces
  • name (str) — A unique name for this universe
  • resolution (0, Culture=neutral, PublicKeyToken=null]] | Resolution) — The expected resolution of the universe data
  • market (str) — The market for selected symbols
  • universe_settings (UniverseSettings) — The subscription settings to use for newly created subscriptions
  • selector (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]) — Function delegate that performs selection on the universe data
Return type:

Universe

add_universe(data_type, security_type, name, resolution, market, universe_settings, py_selector)[source]

Adds a new universe selection model

Parameters:
  • data_type (Type) — The data type
  • security_type (0, Culture=neutral, PublicKeyToken=null]] | SecurityType) — The security type the universe produces
  • name (str) — A unique name for this universe
  • resolution (0, Culture=neutral, PublicKeyToken=null]] | Resolution) — The expected resolution of the universe data
  • market (str) — The market for selected symbols
  • universe_settings (UniverseSettings) — The subscription settings to use for newly created subscriptions
  • py_selector (PyObject) — Function delegate that performs selection on the universe data
Return type:

Universe

add_universe(date_rule, selector)[source]

Adds a new universe selection model

Parameters:
  • date_rule (IDateRule)
  • selector (0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]) — Defines an initial coarse selection
Return type:

Universe

add_universe(coarse_selector, fine_selector)[source]

Adds a new universe selection model

Parameters:
  • coarse_selector (Callable[List[CoarseFundamental], List[Symbol]]) — Defines an initial coarse selection
  • fine_selector (Callable[List[FineFundamental], List[Symbol]]) — Defines a more detailed selection with access to more data
Return type:

Universe

add_universe(universe, fine_selector)[source]

Adds a new universe selection model

Parameters:
  • universe (Universe) — The universe to be filtered with fine fundamental selection
  • fine_selector (Callable[List[Fundamental], List[Symbol]]) — Defines a more detailed selection with access to more data
Return type:

Universe

add_universe(py_object, pyfine)[source]

Adds a new universe selection model

Parameters:
  • py_object (PyObject) — Defines an initial coarse selection or a universe
  • pyfine (PyObject) — Defines a more detailed selection with access to more data
Return type:

Universe

add_universe_options(underlying_symbol, option_filter)[source]

Creates a new universe selection model and adds it to the algorithm. This universe selection model will chain to the security changes of a given Universe selection output and create a new for each of them

Parameters:
  • underlying_symbol (Symbol) — Underlying Symbol to add as an option. For Futures, the option chain constructed will be per-contract, as long as a canonical Symbol is provided.
  • option_filter (Callable[OptionFilterUniverse, OptionFilterUniverse]) — User-defined filter used to select the options we want out of the option chain provided.
add_universe_options(universe, option_filter)[source]

Creates a new universe selection model and adds it to the algorithm. This universe selection model will chain to the security changes of a given Universe selection output and create a new for each of them

Parameters:
  • universe (PyObject | Universe) — The universe we want to chain an option universe selection model too
  • option_filter (0, Culture=neutral, PublicKeyToken=null]] | PyObject) — The option filter universe to use
property universe[source]

Gets a helper that provides pre-defined universe definitions, such as top dollar volume

Returns:

Gets a helper that provides pre-defined universe definitions, such as top dollar volume

Return type:

UniverseDefinitions

property universe_manager[source]

Gets universe manager which holds universes keyed by their symbol

Returns:

Gets universe manager which holds universes keyed by their symbol

Return type:

UniverseManager

property universe_settings[source]

Gets the universe settings to be used when adding securities via universe selection

Returns:

Gets the universe settings to be used when adding securities via universe selection

Return type:

UniverseSettings

Types

AccountType

enum QuantConnect.AccountType[source]

Account type: margin or cash

field CASH

Cash account type (1)

Returns:

Cash account type (1)

Return type:

AccountType

field MARGIN

Margin account type (0)

Returns:

Margin account type (0)

Return type:

AccountType

AlgorithmMode

enum QuantConnect.AlgorithmMode[source]

Represents the deployment modes of an algorithm

field BACKTESTING

Backtesting (2)

Returns:

Backtesting (2)

Return type:

AlgorithmMode

field LIVE

Live (0)

Returns:

Live (0)

Return type:

AlgorithmMode

field OPTIMIZATION

Optimization (1)

Returns:

Optimization (1)

Return type:

AlgorithmMode

field RESEARCH

Research (3)

Returns:

Research (3)

Return type:

AlgorithmMode

AlgorithmStatus

enum QuantConnect.AlgorithmStatus[source]

States of a live deployment.

field COMPLETED

Algorithm completed running (6)

Returns:

Algorithm completed running (6)

Return type:

AlgorithmStatus

field DELETED

Algorithm has been deleted (5)

Returns:

Algorithm has been deleted (5)

Return type:

AlgorithmStatus

field DEPLOY_ERROR

Error compiling algorithm at start (0)

Returns:

Error compiling algorithm at start (0)

Return type:

AlgorithmStatus

field HISTORY

History status update (11)

Returns:

History status update (11)

Return type:

AlgorithmStatus

field INITIALIZING

The algorithm is initializing (10)

Returns:

The algorithm is initializing (10)

Return type:

AlgorithmStatus

field INVALID

Error in the algorithm id (not used) (8)

Returns:

Error in the algorithm id (not used) (8)

Return type:

AlgorithmStatus

field IN_QUEUE

Waiting for a server (1)

Returns:

Waiting for a server (1)

Return type:

AlgorithmStatus

field LIQUIDATED

Liquidated algorithm (4)

Returns:

Liquidated algorithm (4)

Return type:

AlgorithmStatus

field LOGGING_IN

The algorithm is logging into the brokerage (9)

Returns:

The algorithm is logging into the brokerage (9)

Return type:

AlgorithmStatus

field RUNNING

Running algorithm (2)

Returns:

Running algorithm (2)

Return type:

AlgorithmStatus

field RUNTIME_ERROR

Runtime Error Stoped Algorithm (7)

Returns:

Runtime Error Stoped Algorithm (7)

Return type:

AlgorithmStatus

field STOPPED

Stopped algorithm or exited with runtime errors (3)

Returns:

Stopped algorithm or exited with runtime errors (3)

Return type:

AlgorithmStatus

BrokerageMessageEvent

class QuantConnect.Brokerages.BrokerageMessageEvent[source]

Represents a message received from a brokerage

property code

Gets the brokerage specific code for this message, zero if no code was specified

Returns:

Gets the brokerage specific code for this message, zero if no code was specified

Return type:

str

property message

Gets the message text received from the brokerage

Returns:

Gets the message text received from the brokerage

Return type:

str

property type

Gets the type of brokerage message

Returns:

Gets the type of brokerage message

Return type:

BrokerageMessageType

BrokerageName

enum QuantConnect.Brokerages.BrokerageName[source]

Specifices what transaction model and submit/execution rules to use

field ALPACA

Transaction and submit/execution rules will use alpaca models

Returns:

Transaction and submit/execution rules will use alpaca models

Return type:

BrokerageName

field ALPHA_STREAMS

Transaction and submit/execution rules will use AlphaStream models

Returns:

Transaction and submit/execution rules will use AlphaStream models

Return type:

BrokerageName

field ATREYU

Transaction and submit/execution rules will use atreyu models

Returns:

Transaction and submit/execution rules will use atreyu models

Return type:

BrokerageName

field AXOS

Transaction and submit/execution rules will use Axos models

Returns:

Transaction and submit/execution rules will use Axos models

Return type:

BrokerageName

field BINANCE

Transaction and submit/execution rules will use binance models

Returns:

Transaction and submit/execution rules will use binance models

Return type:

BrokerageName

field BINANCE_COIN_FUTURES

Binance Futures COIN-Margined contracts are settled and collateralized in their based cryptocurrency.

Returns:

Binance Futures COIN-Margined contracts are settled and collateralized in their based cryptocurrency.

Return type:

BrokerageName

field BINANCE_FUTURES

Binance Futures USDⓈ-Margined contracts are settled and collateralized in their quote cryptocurrency, USDT or BUSD

Returns:

Binance Futures USDⓈ-Margined contracts are settled and collateralized in their quote cryptocurrency, USDT or BUSD

Return type:

BrokerageName

field BINANCE_US

Transaction and submit/execution rules will use Binance.US models

Returns:

Transaction and submit/execution rules will use Binance.US models

Return type:

BrokerageName

field BITFINEX

Transaction and submit/execution rules will use bitfinex models

Returns:

Transaction and submit/execution rules will use bitfinex models

Return type:

BrokerageName

field BYBIT

Transaction and submit/execution rules will use Bybit models

Returns:

Transaction and submit/execution rules will use Bybit models

Return type:

BrokerageName

field COINBASE

Transaction and submit/execution rules will use Coinbase broker's model

Returns:

Transaction and submit/execution rules will use Coinbase broker's model

Return type:

BrokerageName

field DEFAULT

Transaction and submit/execution rules will be the default as initialized

Returns:

Transaction and submit/execution rules will be the default as initialized

Return type:

BrokerageName

field EXANTE

Transaction and submit/execution rules will use Exante models

Returns:

Transaction and submit/execution rules will use Exante models

Return type:

BrokerageName

field EZE

Transaction and submit/execution rules will use Eze models

Returns:

Transaction and submit/execution rules will use Eze models

Return type:

BrokerageName

field FTX

Transaction and submit/execution rules will use ftx models

Returns:

Transaction and submit/execution rules will use ftx models

Return type:

BrokerageName

field FTXUS

Transaction and submit/execution rules will use ftx us models

Returns:

Transaction and submit/execution rules will use ftx us models

Return type:

BrokerageName

field FXCM_BROKERAGE

Transaction and submit/execution rules will use fxcm models

Returns:

Transaction and submit/execution rules will use fxcm models

Return type:

BrokerageName

field INTERACTIVE_BROKERS_BROKERAGE

Transaction and submit/execution rules will use interactive brokers models

Returns:

Transaction and submit/execution rules will use interactive brokers models

Return type:

BrokerageName

field KRAKEN

Transaction and submit/execution rules will use Kraken models

Returns:

Transaction and submit/execution rules will use Kraken models

Return type:

BrokerageName

field OANDA_BROKERAGE

Transaction and submit/execution rules will use oanda models

Returns:

Transaction and submit/execution rules will use oanda models

Return type:

BrokerageName

field QUANT_CONNECT_BROKERAGE

Transaction and submit/execution rules will be the default as initialized Alternate naming for default brokerage

Returns:

Transaction and submit/execution rules will be the default as initialized Alternate naming for default brokerage

Return type:

BrokerageName

field RBI

Transaction and submit/execution rules will use RBI models

Returns:

Transaction and submit/execution rules will use RBI models

Return type:

BrokerageName

field SAMCO

Transaction and submit/execution rules will use Samco models

Returns:

Transaction and submit/execution rules will use Samco models

Return type:

BrokerageName

field TD_AMERITRADE

Transaction and submit/execution rules will use TDameritrade models

Returns:

Transaction and submit/execution rules will use TDameritrade models

Return type:

BrokerageName

field TRADIER_BROKERAGE

Transaction and submit/execution rules will use tradier models

Returns:

Transaction and submit/execution rules will use tradier models

Return type:

BrokerageName

field TRADING_TECHNOLOGIES

Transaction and submit/execution rules will use TradingTechnologies models

Returns:

Transaction and submit/execution rules will use TradingTechnologies models

Return type:

BrokerageName

field WOLVERINE

Transaction and submit/execution rules will use Wolverine models

Returns:

Transaction and submit/execution rules will use Wolverine models

Return type:

BrokerageName

field ZERODHA

Transaction and submit/execution rules will use Zerodha models

Returns:

Transaction and submit/execution rules will use Zerodha models

Return type:

BrokerageName

Cfd

class QuantConnect.Securities.Cfd.Cfd[source]

CFD Security Object Implementation for CFD Assets

clear()

Removes every custom property that had been set.

get_last_data()

Get the last price update set to the security if any else null

Return type:

BaseData

refresh_data_normalization_mode_property()

This method will refresh the value of the DataNormalizationMode property. This is required for backward-compatibility. TODO: to be deleted with the DataNormalizationMode property

set_buying_power_model(buying_power_model)

Sets the buying power model

Parameters:
  • buying_power_model (IBuyingPowerModel)
set_buying_power_model(py_object)

Sets the buying power model

Parameters:
  • py_object (PyObject)
set_data_filter(py_object)

Set Security Data Filter

Parameters:
  • py_object (PyObject)
set_data_filter(data_filter)

Set Security Data Filter

Parameters:
  • data_filter (ISecurityDataFilter)
set_fee_model(feel_model)

Sets the fee model

Parameters:
  • feel_model (IFeeModel | PyObject)
set_fill_model(fill_model)

Sets the fill model

Parameters:
  • fill_model (PyObject | IFillModel)
set_leverage(leverage)

Set the leverage parameter for this security

Parameters:
  • leverage (float)
set_local_time_keeper(local_time_keeper)

Sets the LocalTimeKeeper to be used for this . This is the source of this instance's time.

Parameters:
  • local_time_keeper (LocalTimeKeeper)
set_margin_interest_rate_model(margin_interest_rate_model)

Sets the margin interests rate model

Parameters:
  • margin_interest_rate_model (IMarginInterestRateModel)
set_margin_interest_rate_model(py_object)

Sets the margin interests rate model

Parameters:
  • py_object (PyObject)
set_margin_model(py_object)

Sets the margin model

Parameters:
  • py_object (PyObject)
set_margin_model(margin_model)

Sets the margin model

Parameters:
  • margin_model (IBuyingPowerModel)
set_market_price(data)

Update any security properties based on the latest market data and time

Parameters:
  • data (BaseData)
set_settlement_model(settlement_model)

Sets the settlement model

Parameters:
  • settlement_model (PyObject | ISettlementModel)
set_shortable_provider(py_object)

Set Python Shortable Provider for this Security

Parameters:
  • py_object (PyObject)
set_shortable_provider(shortable_provider)

Set Python Shortable Provider for this Security

Parameters:
  • shortable_provider (IintableProvider)
set_slippage_model(slippage_model)

Sets the slippage model

Parameters:
  • slippage_model (PyObject | ISlippageModel)
set_volatility_model(volatility_model)

Sets the volatility model

Parameters:
  • volatility_model (PyObject | IVolatilityModel)
update(data, data_type, contains_fill_forward_data=None)

Updates all of the security properties, such as price/OHLCV/bid/ask based on the data provided. Data is also stored into the security's data cache

Parameters:
  • data (IReadOnlyList[BaseData])
  • data_type (Type)
  • contains_fill_forward_data (bool, optional)
property ask_price

Gets the most recent ask price if available

Returns:

Gets the most recent ask price if available

Return type:

float

property ask_size

Gets the most recent ask size if available

Returns:

Gets the most recent ask size if available

Return type:

float

property bid_price

Gets the most recent bid price if available

Returns:

Gets the most recent bid price if available

Return type:

float

property bid_size

Gets the most recent bid size if available

Returns:

Gets the most recent bid size if available

Return type:

float

property buying_power_model

Gets the buying power model used for this security

Returns:

Gets the buying power model used for this security

Return type:

IBuyingPowerModel

property cache

Data cache for the security to store previous price information.

Returns:

Data cache for the security to store previous price information.

Return type:

SecurityCache

property close

If this uses tradebar data, return the most recent close.

Returns:

If this uses tradebar data, return the most recent close.

Return type:

float

property contract_multiplier

Gets the contract multiplier for this CFD security

Returns:

Gets the contract multiplier for this CFD security

Return type:

float

property data

Provides dynamic access to data in the cache

Returns:

Provides dynamic access to data in the cache

Return type:

object

property data_filter

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Returns:

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Return type:

ISecurityDataFilter

property exchange

Exchange class contains the market opening hours, along with pre-post market hours.

Returns:

Exchange class contains the market opening hours, along with pre-post market hours.

Return type:

SecurityExchange

property fee_model

Fee model used to compute order fees for this security

Returns:

Fee model used to compute order fees for this security

Return type:

IFeeModel

property fill_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IFillModel

property fundamentals

Gets the fundamental data associated with the security if there is any, otherwise null.

Returns:

Gets the fundamental data associated with the security if there is any, otherwise null.

Return type:

Fundamental

property has_data

There has been at least one datapoint since our algorithm started running for us to determine price.

Returns:

There has been at least one datapoint since our algorithm started running for us to determine price.

Return type:

bool

property high

If this uses tradebar data, return the most recent high.

Returns:

If this uses tradebar data, return the most recent high.

Return type:

float

property hold_stock

Read only property that checks if we currently own stock in the company.

Returns:

Read only property that checks if we currently own stock in the company.

Return type:

bool

property holdings

Holdings class contains the portfolio, cash and processes order fills.

Returns:

Holdings class contains the portfolio, cash and processes order fills.

Return type:

SecurityHolding

property invested

Alias for HoldStock - Do we have any of this security

Returns:

Alias for HoldStock - Do we have any of this security

Return type:

bool

property is_delisted

True if the security has been delisted from exchanges and is no longer tradable

Returns:

True if the security has been delisted from exchanges and is no longer tradable

Return type:

bool

property is_tradable

Gets or sets whether or not this security should be considered tradable

Returns:

Gets or sets whether or not this security should be considered tradable

Return type:

bool

property item

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Returns:

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Return type:

object

property leverage

Leverage for this Security.

Returns:

Leverage for this Security.

Return type:

float

property local_time

Local time for this market

Returns:

Local time for this market

Return type:

datetime

property low

If this uses tradebar data, return the most recent low.

Returns:

If this uses tradebar data, return the most recent low.

Return type:

float

property margin_interest_rate_model

Gets or sets the margin interest rate model

Returns:

Gets or sets the margin interest rate model

Return type:

IMarginInterestRateModel

property margin_model

Gets the buying power model used for this security, an alias for BuyingPowerModel

Returns:

Gets the buying power model used for this security, an alias for BuyingPowerModel

Return type:

IBuyingPowerModel

property minimum_price_variation

Gets the minimum price variation for this CFD security

Returns:

Gets the minimum price variation for this CFD security

Return type:

float

property open

If this uses tradebar data, return the most recent open.

Returns:

If this uses tradebar data, return the most recent open.

Return type:

float

property open_interest

Access to the open interest of the security today

Returns:

Access to the open interest of the security today

Return type:

int

property portfolio_model

Gets the portfolio model used by this security

Returns:

Gets the portfolio model used by this security

Return type:

ISecurityPortfolioModel

property price

Get the current value of the security.

Returns:

Get the current value of the security.

Return type:

float

property price_variation_model

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Returns:

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Return type:

IPriceVariationModel

property quote_currency

Gets the Cash object used for converting the quote currency to the account currency

Returns:

Gets the Cash object used for converting the quote currency to the account currency

Return type:

Cash

property settlement_model

Gets the settlement model used for this security

Returns:

Gets the settlement model used for this security

Return type:

ISettlementModel

property shortable_provider

This securities IShortableProvider

Returns:

This securities IShortableProvider

Return type:

IintableProvider

property slippage_model

Slippage model use to compute slippage of market orders

Returns:

Slippage model use to compute slippage of market orders

Return type:

ISlippageModel

property subscriptions

Gets all the subscriptions for this security

Returns:

Gets all the subscriptions for this security

Return type:

List[SubscriptionDataConfig]

property symbol

Symbol for the asset.

Returns:

Symbol for the asset.

Return type:

Symbol

property symbol_properties

Gets the symbol properties for this security

Returns:

Gets the symbol properties for this security

Return type:

SymbolProperties

property type

Type of the security.

Returns:

Type of the security.

Return type:

SecurityType

property volatility_model

Gets the volatility model used for this security

Returns:

Gets the volatility model used for this security

Return type:

IVolatilityModel

property volume

Access to the volume of the equity today

Returns:

Access to the volume of the equity today

Return type:

float

Chart

class QuantConnect.Chart[source]

Single Parent Chart Object for Custom Charting

add_series(series)

Add a reference to this chart series:

Parameters:
  • series (BaseSeries)
clone()

Return a new instance clone of this object

Return type:

Chart

clone_empty()

Return a new empty instance clone of this object

Return type:

Chart

get_updates()

Fetch a chart with only the updates since the last request, Underlying series will save the index position.

Return type:

Chart

try_add_and_get_series(name, type, index, unit, color, symbol, force_add_new=False)

Gets Series if already present in chart, else will add a new series and return it

Parameters:
  • name (str)
  • type (SeriesType)
  • index (int)
  • unit (str)
  • color (Color)
  • symbol (ScatterMarkerSymbol)
  • force_add_new (bool, optional)
Return type:

Series

try_add_and_get_series(name, template_series, force_add_new=False)

Gets Series if already present in chart, else will add a new series and return it

Parameters:
  • name (str)
  • template_series (BaseSeries)
  • force_add_new (bool, optional)
Return type:

BaseSeries

property legend_disabled

True to hide this series legend from the chart

Returns:

True to hide this series legend from the chart

Return type:

bool

property symbol

Associated symbol if any, making this an asset plot

Returns:

Associated symbol if any, making this an asset plot

Return type:

Symbol

field name

Name of the Chart:

Returns:

Name of the Chart:

Return type:

str

field series

List of Series Objects for this Chart:

Returns:

List of Series Objects for this Chart:

Return type:

Dict[str, BaseSeries]

Crypto

class QuantConnect.Securities.Crypto.Crypto[source]

Crypto Security Object Implementation for Crypto Assets

clear()

Removes every custom property that had been set.

get_last_data()

Get the last price update set to the security if any else null

Return type:

BaseData

refresh_data_normalization_mode_property()

This method will refresh the value of the DataNormalizationMode property. This is required for backward-compatibility. TODO: to be deleted with the DataNormalizationMode property

set_buying_power_model(buying_power_model)

Sets the buying power model

Parameters:
  • buying_power_model (IBuyingPowerModel)
set_buying_power_model(py_object)

Sets the buying power model

Parameters:
  • py_object (PyObject)
set_data_filter(py_object)

Set Security Data Filter

Parameters:
  • py_object (PyObject)
set_data_filter(data_filter)

Set Security Data Filter

Parameters:
  • data_filter (ISecurityDataFilter)
set_fee_model(feel_model)

Sets the fee model

Parameters:
  • feel_model (IFeeModel | PyObject)
set_fill_model(fill_model)

Sets the fill model

Parameters:
  • fill_model (PyObject | IFillModel)
set_leverage(leverage)

Set the leverage parameter for this security

Parameters:
  • leverage (float)
set_local_time_keeper(local_time_keeper)

Sets the LocalTimeKeeper to be used for this . This is the source of this instance's time.

Parameters:
  • local_time_keeper (LocalTimeKeeper)
set_margin_interest_rate_model(margin_interest_rate_model)

Sets the margin interests rate model

Parameters:
  • margin_interest_rate_model (IMarginInterestRateModel)
set_margin_interest_rate_model(py_object)

Sets the margin interests rate model

Parameters:
  • py_object (PyObject)
set_margin_model(py_object)

Sets the margin model

Parameters:
  • py_object (PyObject)
set_margin_model(margin_model)

Sets the margin model

Parameters:
  • margin_model (IBuyingPowerModel)
set_market_price(data)

Update any security properties based on the latest market data and time

Parameters:
  • data (BaseData)
set_settlement_model(settlement_model)

Sets the settlement model

Parameters:
  • settlement_model (PyObject | ISettlementModel)
set_shortable_provider(py_object)

Set Python Shortable Provider for this Security

Parameters:
  • py_object (PyObject)
set_shortable_provider(shortable_provider)

Set Python Shortable Provider for this Security

Parameters:
  • shortable_provider (IintableProvider)
set_slippage_model(slippage_model)

Sets the slippage model

Parameters:
  • slippage_model (PyObject | ISlippageModel)
set_volatility_model(volatility_model)

Sets the volatility model

Parameters:
  • volatility_model (PyObject | IVolatilityModel)
update(data, data_type, contains_fill_forward_data=None)

Updates all of the security properties, such as price/OHLCV/bid/ask based on the data provided. Data is also stored into the security's data cache

Parameters:
  • data (IReadOnlyList[BaseData])
  • data_type (Type)
  • contains_fill_forward_data (bool, optional)
property ask_price

Gets the most recent ask price if available

Returns:

Gets the most recent ask price if available

Return type:

float

property ask_size

Gets the most recent ask size if available

Returns:

Gets the most recent ask size if available

Return type:

float

property base_currency

Gets the currency acquired by going long this currency pair

Returns:

Gets the currency acquired by going long this currency pair

Return type:

Cash

property bid_price

Gets the most recent bid price if available

Returns:

Gets the most recent bid price if available

Return type:

float

property bid_size

Gets the most recent bid size if available

Returns:

Gets the most recent bid size if available

Return type:

float

property buying_power_model

Gets the buying power model used for this security

Returns:

Gets the buying power model used for this security

Return type:

IBuyingPowerModel

property cache

Data cache for the security to store previous price information.

Returns:

Data cache for the security to store previous price information.

Return type:

SecurityCache

property close

If this uses tradebar data, return the most recent close.

Returns:

If this uses tradebar data, return the most recent close.

Return type:

float

property data

Provides dynamic access to data in the cache

Returns:

Provides dynamic access to data in the cache

Return type:

object

property data_filter

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Returns:

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Return type:

ISecurityDataFilter

property exchange

Exchange class contains the market opening hours, along with pre-post market hours.

Returns:

Exchange class contains the market opening hours, along with pre-post market hours.

Return type:

SecurityExchange

property fee_model

Fee model used to compute order fees for this security

Returns:

Fee model used to compute order fees for this security

Return type:

IFeeModel

property fill_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IFillModel

property fundamentals

Gets the fundamental data associated with the security if there is any, otherwise null.

Returns:

Gets the fundamental data associated with the security if there is any, otherwise null.

Return type:

Fundamental

property has_data

There has been at least one datapoint since our algorithm started running for us to determine price.

Returns:

There has been at least one datapoint since our algorithm started running for us to determine price.

Return type:

bool

property high

If this uses tradebar data, return the most recent high.

Returns:

If this uses tradebar data, return the most recent high.

Return type:

float

property hold_stock

Read only property that checks if we currently own stock in the company.

Returns:

Read only property that checks if we currently own stock in the company.

Return type:

bool

property holdings

Holdings class contains the portfolio, cash and processes order fills.

Returns:

Holdings class contains the portfolio, cash and processes order fills.

Return type:

SecurityHolding

property invested

Alias for HoldStock - Do we have any of this security

Returns:

Alias for HoldStock - Do we have any of this security

Return type:

bool

property is_delisted

True if the security has been delisted from exchanges and is no longer tradable

Returns:

True if the security has been delisted from exchanges and is no longer tradable

Return type:

bool

property is_tradable

Gets or sets whether or not this security should be considered tradable

Returns:

Gets or sets whether or not this security should be considered tradable

Return type:

bool

property item

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Returns:

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Return type:

object

property leverage

Leverage for this Security.

Returns:

Leverage for this Security.

Return type:

float

property local_time

Local time for this market

Returns:

Local time for this market

Return type:

datetime

property low

If this uses tradebar data, return the most recent low.

Returns:

If this uses tradebar data, return the most recent low.

Return type:

float

property margin_interest_rate_model

Gets or sets the margin interest rate model

Returns:

Gets or sets the margin interest rate model

Return type:

IMarginInterestRateModel

property margin_model

Gets the buying power model used for this security, an alias for BuyingPowerModel

Returns:

Gets the buying power model used for this security, an alias for BuyingPowerModel

Return type:

IBuyingPowerModel

property open

If this uses tradebar data, return the most recent open.

Returns:

If this uses tradebar data, return the most recent open.

Return type:

float

property open_interest

Access to the open interest of the security today

Returns:

Access to the open interest of the security today

Return type:

int

property portfolio_model

Gets the portfolio model used by this security

Returns:

Gets the portfolio model used by this security

Return type:

ISecurityPortfolioModel

property price

Get the current value of the security.

Returns:

Get the current value of the security.

Return type:

float

property price_variation_model

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Returns:

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Return type:

IPriceVariationModel

property quote_currency

Gets the Cash object used for converting the quote currency to the account currency

Returns:

Gets the Cash object used for converting the quote currency to the account currency

Return type:

Cash

property settlement_model

Gets the settlement model used for this security

Returns:

Gets the settlement model used for this security

Return type:

ISettlementModel

property shortable_provider

This securities IShortableProvider

Returns:

This securities IShortableProvider

Return type:

IintableProvider

property slippage_model

Slippage model use to compute slippage of market orders

Returns:

Slippage model use to compute slippage of market orders

Return type:

ISlippageModel

property subscriptions

Gets all the subscriptions for this security

Returns:

Gets all the subscriptions for this security

Return type:

List[SubscriptionDataConfig]

property symbol

Symbol for the asset.

Returns:

Symbol for the asset.

Return type:

Symbol

property symbol_properties

Gets the symbol properties for this security

Returns:

Gets the symbol properties for this security

Return type:

SymbolProperties

property type

Type of the security.

Returns:

Type of the security.

Return type:

SecurityType

property volatility_model

Gets the volatility model used for this security

Returns:

Gets the volatility model used for this security

Return type:

IVolatilityModel

property volume

Access to the volume of the equity today

Returns:

Access to the volume of the equity today

Return type:

float

CryptoFuture

class QuantConnect.Securities.CryptoFuture.CryptoFuture[source]

Crypto Future Security Object Implementation for Crypto Future Assets

clear()

Removes every custom property that had been set.

get_last_data()

Get the last price update set to the security if any else null

Return type:

BaseData

is_crypto_coin_future()

Checks whether the security is a crypto coin future

Return type:

bool

refresh_data_normalization_mode_property()

This method will refresh the value of the DataNormalizationMode property. This is required for backward-compatibility. TODO: to be deleted with the DataNormalizationMode property

set_buying_power_model(buying_power_model)

Sets the buying power model

Parameters:
  • buying_power_model (IBuyingPowerModel)
set_buying_power_model(py_object)

Sets the buying power model

Parameters:
  • py_object (PyObject)
set_data_filter(py_object)

Set Security Data Filter

Parameters:
  • py_object (PyObject)
set_data_filter(data_filter)

Set Security Data Filter

Parameters:
  • data_filter (ISecurityDataFilter)
set_fee_model(feel_model)

Sets the fee model

Parameters:
  • feel_model (IFeeModel | PyObject)
set_fill_model(fill_model)

Sets the fill model

Parameters:
  • fill_model (PyObject | IFillModel)
set_leverage(leverage)

Set the leverage parameter for this security

Parameters:
  • leverage (float)
set_local_time_keeper(local_time_keeper)

Sets the LocalTimeKeeper to be used for this . This is the source of this instance's time.

Parameters:
  • local_time_keeper (LocalTimeKeeper)
set_margin_interest_rate_model(margin_interest_rate_model)

Sets the margin interests rate model

Parameters:
  • margin_interest_rate_model (IMarginInterestRateModel)
set_margin_interest_rate_model(py_object)

Sets the margin interests rate model

Parameters:
  • py_object (PyObject)
set_margin_model(py_object)

Sets the margin model

Parameters:
  • py_object (PyObject)
set_margin_model(margin_model)

Sets the margin model

Parameters:
  • margin_model (IBuyingPowerModel)
set_market_price(data)

Update any security properties based on the latest market data and time

Parameters:
  • data (BaseData)
set_settlement_model(settlement_model)

Sets the settlement model

Parameters:
  • settlement_model (PyObject | ISettlementModel)
set_shortable_provider(py_object)

Set Python Shortable Provider for this Security

Parameters:
  • py_object (PyObject)
set_shortable_provider(shortable_provider)

Set Python Shortable Provider for this Security

Parameters:
  • shortable_provider (IintableProvider)
set_slippage_model(slippage_model)

Sets the slippage model

Parameters:
  • slippage_model (PyObject | ISlippageModel)
set_volatility_model(volatility_model)

Sets the volatility model

Parameters:
  • volatility_model (PyObject | IVolatilityModel)
update(data, data_type, contains_fill_forward_data=None)

Updates all of the security properties, such as price/OHLCV/bid/ask based on the data provided. Data is also stored into the security's data cache

Parameters:
  • data (IReadOnlyList[BaseData])
  • data_type (Type)
  • contains_fill_forward_data (bool, optional)
property ask_price

Gets the most recent ask price if available

Returns:

Gets the most recent ask price if available

Return type:

float

property ask_size

Gets the most recent ask size if available

Returns:

Gets the most recent ask size if available

Return type:

float

property base_currency

Gets the currency acquired by going long this currency pair

Returns:

Gets the currency acquired by going long this currency pair

Return type:

Cash

property bid_price

Gets the most recent bid price if available

Returns:

Gets the most recent bid price if available

Return type:

float

property bid_size

Gets the most recent bid size if available

Returns:

Gets the most recent bid size if available

Return type:

float

property buying_power_model

Gets the buying power model used for this security

Returns:

Gets the buying power model used for this security

Return type:

IBuyingPowerModel

property cache

Data cache for the security to store previous price information.

Returns:

Data cache for the security to store previous price information.

Return type:

SecurityCache

property close

If this uses tradebar data, return the most recent close.

Returns:

If this uses tradebar data, return the most recent close.

Return type:

float

property data

Provides dynamic access to data in the cache

Returns:

Provides dynamic access to data in the cache

Return type:

object

property data_filter

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Returns:

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Return type:

ISecurityDataFilter

property exchange

Exchange class contains the market opening hours, along with pre-post market hours.

Returns:

Exchange class contains the market opening hours, along with pre-post market hours.

Return type:

SecurityExchange

property fee_model

Fee model used to compute order fees for this security

Returns:

Fee model used to compute order fees for this security

Return type:

IFeeModel

property fill_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IFillModel

property fundamentals

Gets the fundamental data associated with the security if there is any, otherwise null.

Returns:

Gets the fundamental data associated with the security if there is any, otherwise null.

Return type:

Fundamental

property has_data

There has been at least one datapoint since our algorithm started running for us to determine price.

Returns:

There has been at least one datapoint since our algorithm started running for us to determine price.

Return type:

bool

property high

If this uses tradebar data, return the most recent high.

Returns:

If this uses tradebar data, return the most recent high.

Return type:

float

property hold_stock

Read only property that checks if we currently own stock in the company.

Returns:

Read only property that checks if we currently own stock in the company.

Return type:

bool

property holdings

Holdings class contains the portfolio, cash and processes order fills.

Returns:

Holdings class contains the portfolio, cash and processes order fills.

Return type:

SecurityHolding

property invested

Alias for HoldStock - Do we have any of this security

Returns:

Alias for HoldStock - Do we have any of this security

Return type:

bool

property is_delisted

True if the security has been delisted from exchanges and is no longer tradable

Returns:

True if the security has been delisted from exchanges and is no longer tradable

Return type:

bool

property is_tradable

Gets or sets whether or not this security should be considered tradable

Returns:

Gets or sets whether or not this security should be considered tradable

Return type:

bool

property item

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Returns:

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Return type:

object

property leverage

Leverage for this Security.

Returns:

Leverage for this Security.

Return type:

float

property local_time

Local time for this market

Returns:

Local time for this market

Return type:

datetime

property low

If this uses tradebar data, return the most recent low.

Returns:

If this uses tradebar data, return the most recent low.

Return type:

float

property margin_interest_rate_model

Gets or sets the margin interest rate model

Returns:

Gets or sets the margin interest rate model

Return type:

IMarginInterestRateModel

property margin_model

Gets the buying power model used for this security, an alias for BuyingPowerModel

Returns:

Gets the buying power model used for this security, an alias for BuyingPowerModel

Return type:

IBuyingPowerModel

property open

If this uses tradebar data, return the most recent open.

Returns:

If this uses tradebar data, return the most recent open.

Return type:

float

property open_interest

Access to the open interest of the security today

Returns:

Access to the open interest of the security today

Return type:

int

property portfolio_model

Gets the portfolio model used by this security

Returns:

Gets the portfolio model used by this security

Return type:

ISecurityPortfolioModel

property price

Get the current value of the security.

Returns:

Get the current value of the security.

Return type:

float

property price_variation_model

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Returns:

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Return type:

IPriceVariationModel

property quote_currency

Gets the Cash object used for converting the quote currency to the account currency

Returns:

Gets the Cash object used for converting the quote currency to the account currency

Return type:

Cash

property settlement_model

Gets the settlement model used for this security

Returns:

Gets the settlement model used for this security

Return type:

ISettlementModel

property shortable_provider

This securities IShortableProvider

Returns:

This securities IShortableProvider

Return type:

IintableProvider

property slippage_model

Slippage model use to compute slippage of market orders

Returns:

Slippage model use to compute slippage of market orders

Return type:

ISlippageModel

property subscriptions

Gets all the subscriptions for this security

Returns:

Gets all the subscriptions for this security

Return type:

List[SubscriptionDataConfig]

property symbol

Symbol for the asset.

Returns:

Symbol for the asset.

Return type:

Symbol

property symbol_properties

Gets the symbol properties for this security

Returns:

Gets the symbol properties for this security

Return type:

SymbolProperties

property type

Type of the security.

Returns:

Type of the security.

Return type:

SecurityType

property volatility_model

Gets the volatility model used for this security

Returns:

Gets the volatility model used for this security

Return type:

IVolatilityModel

property volume

Access to the volume of the equity today

Returns:

Access to the volume of the equity today

Return type:

float

DateRules

class QuantConnect.Scheduling.DateRules[source]

Helper class used to provide better syntax when defining date rules

every(day)

Specifies an event should fire on each of the specified days of week

Parameters:
  • day (DayOfWeek)
Return type:

IDateRule

every(days)

Specifies an event should fire on each of the specified days of week

Parameters:
  • days (DayOfWeek)
Return type:

IDateRule

every_day(symbol)

Specifies an event should fire every day

Parameters:
Return type:

IDateRule

month_end(symbol, days_offset=0)

Specifies an event should fire on the last of each month

Parameters:
  • symbol (Symbol)
  • days_offset (int, optional)
Return type:

IDateRule

month_start(symbol, days_offset=0)

Specifies an event should fire on the first of each month + offset

Parameters:
  • symbol (Symbol)
  • days_offset (int, optional)
Return type:

IDateRule

on(year, month, day)

Specifies an event should fire only on the specified day

Parameters:
  • year (int)
  • month (int)
  • day (int)
Return type:

IDateRule

on(dates)

Specifies an event should fire only on the specified day

Parameters:
  • dates (datetime)
Return type:

IDateRule

set_default_time_zone(time_zone)

Sets the default time zone

Parameters:
  • time_zone (datetimeZone)
week_end(symbol, days_offset=0)

Specifies an event should fire on Friday - offset

Parameters:
  • symbol (Symbol)
  • days_offset (int, optional)
Return type:

IDateRule

week_start(symbol, days_offset=0)

Specifies an event should fire on Monday + offset each week

Parameters:
  • symbol (Symbol)
  • days_offset (int, optional)
Return type:

IDateRule

property today

Specifies an event should only fire today in the algorithm's time zone using _securities.UtcTime instead of 'start' since ScheduleManager backs it up a day

Returns:

Specifies an event should only fire today in the algorithm's time zone using _securities.UtcTime instead of 'start' since ScheduleManager backs it up a day

Return type:

IDateRule

property tomorrow

Specifies an event should only fire tomorrow in the algorithm's time zone using _securities.UtcTime instead of 'start' since ScheduleManager backs it up a day

Returns:

Specifies an event should only fire tomorrow in the algorithm's time zone using _securities.UtcTime instead of 'start' since ScheduleManager backs it up a day

Return type:

IDateRule

Delistings

class QuantConnect.Data.Market.Delistings[source]

Collections of Delisting keyed by

add(key, value)

Adds an item to the list.

Parameters:
  • key (Symbol)
  • value (Delisting)
add(item)

Adds an item to the list.

Parameters:
  • item (Dict[Symbol, Delisting])
clear()

Removes all keys and values from the dictionary.

contains(item)

Determines whether the list contains a specific value.

Parameters:
  • item (Dict[Symbol, Delisting])
Return type:

bool

contains_key(key)

Determines whether the dictionary contains an element with the specified key.

Parameters:
Return type:

bool

copy()

Creates a shallow copy of the dictionary.

Return type:

PyDict

copy_to(array, array_index)

Copies the elements of the list to an , starting at a particular index.

Parameters:
  • array (Dict`2)
  • array_index (int)
fromkeys(sequence, value)

Creates a new dictionary from the given sequence of elements.

Parameters:
  • sequence (Symbol)
  • value (Delisting)
Return type:

PyDict

get(symbol, value)

Returns the value for the specified Symbol if Symbol is in dictionary.

Parameters:
  • symbol (Symbol)
  • value (Delisting)
Return type:

Delisting

get_enumerator()

Returns an enumerator that iterates through the collection.

Return type:

IEnumerator[Dict[Symbol, Delisting]]

get_value(key)

Gets the value associated with the specified key.

Parameters:
Return type:

Delisting

items()

Returns a view object that displays a list of dictionary's (Symbol, value) tuple pairs.

Return type:

PyList

keys()

Returns a view object that displays a list of all the Symbol objects in the dictionary

Return type:

PyList

pop(symbol, default_value)

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (Delisting)
Return type:

Delisting

popitem()

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Return type:

PyTuple

remove(item)

Removes the first occurrence of a specific object from the list.

Parameters:
  • item (Dict[Symbol, Delisting])
Return type:

bool

remove(key)

Removes the first occurrence of a specific object from the list.

Parameters:
Return type:

bool

setdefault(symbol, default_value)

Returns the value of a Symbol (if the Symbol is in dictionary). If not, it inserts Symbol with a value to the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (Delisting)
Return type:

Delisting

try_get_value(key, value)

Gets the value associated with the specified key.

Parameters:
Return type:

bool

update(other)

Updates the dictionary with the elements from the another dictionary object or from an iterable of Symbol/value pairs. The update() method adds element(s) to the dictionary if the Symbol is not in the dictionary.If the Symbol is in the dictionary, it updates the Symbol with the new value.

Parameters:
  • other (PyObject)
values()

Returns a view object that displays a list of all the values in the dictionary.

Return type:

PyList

property count

Gets the number of elements contained in the list.

Returns:

Gets the number of elements contained in the list.

Return type:

int

property is_read_only

Gets a value indicating whether the list is read-only.

Returns:

Gets a value indicating whether the list is read-only.

Return type:

bool

property item

Gets or sets the Delisting with the specified ticker.

Returns:

Gets or sets the Delisting with the specified ticker.

Return type:

Delisting

property keys

Gets a list containing the keys of the .

Returns:

Gets a list containing the keys of the .

Return type:

ICollection[Symbol]

property time

Gets or sets the time associated with this collection of data

Returns:

Gets or sets the time associated with this collection of data

Return type:

datetime

property values

Gets a list containing the values in the .

Returns:

Gets a list containing the values in the .

Return type:

ICollection[Delisting]

DeploymentTarget

enum QuantConnect.DeploymentTarget[source]

Represents the types deployment targets for algorithms

field CLOUD_PLATFORM

Cloud Platform (0)

Returns:

Cloud Platform (0)

Return type:

DeploymentTarget

field LOCAL_PLATFORM

Local Platform (1)

Returns:

Local Platform (1)

Return type:

DeploymentTarget

Dividends

class QuantConnect.Data.Market.Dividends[source]

Collection of dividends keyed by Symbol

add(key, value)

Adds an item to the list.

Parameters:
  • key (Symbol)
  • value (Dividend)
add(item)

Adds an item to the list.

Parameters:
  • item (Dict[Symbol, Dividend])
clear()

Removes all keys and values from the dictionary.

contains(item)

Determines whether the list contains a specific value.

Parameters:
  • item (Dict[Symbol, Dividend])
Return type:

bool

contains_key(key)

Determines whether the dictionary contains an element with the specified key.

Parameters:
Return type:

bool

copy()

Creates a shallow copy of the dictionary.

Return type:

PyDict

copy_to(array, array_index)

Copies the elements of the list to an , starting at a particular index.

Parameters:
  • array (Dict`2)
  • array_index (int)
fromkeys(sequence, value)

Creates a new dictionary from the given sequence of elements.

Parameters:
  • sequence (Symbol)
  • value (Dividend)
Return type:

PyDict

get(symbol, value)

Returns the value for the specified Symbol if Symbol is in dictionary.

Parameters:
  • symbol (Symbol)
  • value (Dividend)
Return type:

Dividend

get_enumerator()

Returns an enumerator that iterates through the collection.

Return type:

IEnumerator[Dict[Symbol, Dividend]]

get_value(key)

Gets the value associated with the specified key.

Parameters:
Return type:

Dividend

items()

Returns a view object that displays a list of dictionary's (Symbol, value) tuple pairs.

Return type:

PyList

keys()

Returns a view object that displays a list of all the Symbol objects in the dictionary

Return type:

PyList

pop(symbol, default_value)

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (Dividend)
Return type:

Dividend

popitem()

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Return type:

PyTuple

remove(item)

Removes the first occurrence of a specific object from the list.

Parameters:
  • item (Dict[Symbol, Dividend])
Return type:

bool

remove(key)

Removes the first occurrence of a specific object from the list.

Parameters:
Return type:

bool

setdefault(symbol, default_value)

Returns the value of a Symbol (if the Symbol is in dictionary). If not, it inserts Symbol with a value to the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (Dividend)
Return type:

Dividend

try_get_value(key, value)

Gets the value associated with the specified key.

Parameters:
Return type:

bool

update(other)

Updates the dictionary with the elements from the another dictionary object or from an iterable of Symbol/value pairs. The update() method adds element(s) to the dictionary if the Symbol is not in the dictionary.If the Symbol is in the dictionary, it updates the Symbol with the new value.

Parameters:
  • other (PyObject)
values()

Returns a view object that displays a list of all the values in the dictionary.

Return type:

PyList

property count

Gets the number of elements contained in the list.

Returns:

Gets the number of elements contained in the list.

Return type:

int

property is_read_only

Gets a value indicating whether the list is read-only.

Returns:

Gets a value indicating whether the list is read-only.

Return type:

bool

property item

Gets or sets the Dividend with the specified ticker.

Returns:

Gets or sets the Dividend with the specified ticker.

Return type:

Dividend

property keys

Gets a list containing the keys of the .

Returns:

Gets a list containing the keys of the .

Return type:

ICollection[Symbol]

property time

Gets or sets the time associated with this collection of data

Returns:

Gets or sets the time associated with this collection of data

Return type:

datetime

property values

Gets a list containing the values in the .

Returns:

Gets a list containing the values in the .

Return type:

ICollection[Dividend]

Equity

class QuantConnect.Securities.Equity.Equity[source]

Equity Security Type : Extension of the underlying Security class for equity specific behaviours.

clear()

Removes every custom property that had been set.

get_last_data()

Get the last price update set to the security if any else null

Return type:

BaseData

refresh_data_normalization_mode_property()

This method will refresh the value of the DataNormalizationMode property. This is required for backward-compatibility. TODO: to be deleted with the DataNormalizationMode property

set_buying_power_model(buying_power_model)

Sets the buying power model

Parameters:
  • buying_power_model (IBuyingPowerModel)
set_buying_power_model(py_object)

Sets the buying power model

Parameters:
  • py_object (PyObject)
set_data_filter(py_object)

Set Security Data Filter

Parameters:
  • py_object (PyObject)
set_data_filter(data_filter)

Set Security Data Filter

Parameters:
  • data_filter (ISecurityDataFilter)
set_data_normalization_mode(mode)

Sets the data normalization mode to be used by this security

Parameters:
  • mode (DataNormalizationMode)
set_fee_model(feel_model)

Sets the fee model

Parameters:
  • feel_model (IFeeModel | PyObject)
set_fill_model(fill_model)

Sets the fill model

Parameters:
  • fill_model (PyObject | IFillModel)
set_leverage(leverage)

Set the leverage parameter for this security

Parameters:
  • leverage (float)
set_local_time_keeper(local_time_keeper)

Sets the LocalTimeKeeper to be used for this . This is the source of this instance's time.

Parameters:
  • local_time_keeper (LocalTimeKeeper)
set_margin_interest_rate_model(margin_interest_rate_model)

Sets the margin interests rate model

Parameters:
  • margin_interest_rate_model (IMarginInterestRateModel)
set_margin_interest_rate_model(py_object)

Sets the margin interests rate model

Parameters:
  • py_object (PyObject)
set_margin_model(py_object)

Sets the margin model

Parameters:
  • py_object (PyObject)
set_margin_model(margin_model)

Sets the margin model

Parameters:
  • margin_model (IBuyingPowerModel)
set_market_price(data)

Update any security properties based on the latest market data and time

Parameters:
  • data (BaseData)
set_settlement_model(settlement_model)

Sets the settlement model

Parameters:
  • settlement_model (PyObject | ISettlementModel)
set_shortable_provider(py_object)

Set Python Shortable Provider for this Security

Parameters:
  • py_object (PyObject)
set_shortable_provider(shortable_provider)

Set Python Shortable Provider for this Security

Parameters:
  • shortable_provider (IintableProvider)
set_slippage_model(slippage_model)

Sets the slippage model

Parameters:
  • slippage_model (PyObject | ISlippageModel)
set_volatility_model(volatility_model)

Sets the volatility model

Parameters:
  • volatility_model (PyObject | IVolatilityModel)
update(data, data_type, contains_fill_forward_data=None)

Updates all of the security properties, such as price/OHLCV/bid/ask based on the data provided. Data is also stored into the security's data cache

Parameters:
  • data (IReadOnlyList[BaseData])
  • data_type (Type)
  • contains_fill_forward_data (bool, optional)
property ask_price

Gets the most recent ask price if available

Returns:

Gets the most recent ask price if available

Return type:

float

property ask_size

Gets the most recent ask size if available

Returns:

Gets the most recent ask size if available

Return type:

float

property bid_price

Gets the most recent bid price if available

Returns:

Gets the most recent bid price if available

Return type:

float

property bid_size

Gets the most recent bid size if available

Returns:

Gets the most recent bid size if available

Return type:

float

property buying_power_model

Gets the buying power model used for this security

Returns:

Gets the buying power model used for this security

Return type:

IBuyingPowerModel

property cache

Data cache for the security to store previous price information.

Returns:

Data cache for the security to store previous price information.

Return type:

SecurityCache

property close

If this uses tradebar data, return the most recent close.

Returns:

If this uses tradebar data, return the most recent close.

Return type:

float

property data

Provides dynamic access to data in the cache

Returns:

Provides dynamic access to data in the cache

Return type:

object

property data_filter

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Returns:

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Return type:

ISecurityDataFilter

property exchange

Exchange class contains the market opening hours, along with pre-post market hours.

Returns:

Exchange class contains the market opening hours, along with pre-post market hours.

Return type:

SecurityExchange

property fee_model

Fee model used to compute order fees for this security

Returns:

Fee model used to compute order fees for this security

Return type:

IFeeModel

property fill_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IFillModel

property fundamentals

Gets the fundamental data associated with the security if there is any, otherwise null.

Returns:

Gets the fundamental data associated with the security if there is any, otherwise null.

Return type:

Fundamental

property has_data

There has been at least one datapoint since our algorithm started running for us to determine price.

Returns:

There has been at least one datapoint since our algorithm started running for us to determine price.

Return type:

bool

property high

If this uses tradebar data, return the most recent high.

Returns:

If this uses tradebar data, return the most recent high.

Return type:

float

property hold_stock

Read only property that checks if we currently own stock in the company.

Returns:

Read only property that checks if we currently own stock in the company.

Return type:

bool

property holdings

Holdings class contains the portfolio, cash and processes order fills.

Returns:

Holdings class contains the portfolio, cash and processes order fills.

Return type:

SecurityHolding

property invested

Alias for HoldStock - Do we have any of this security

Returns:

Alias for HoldStock - Do we have any of this security

Return type:

bool

property is_delisted

True if the security has been delisted from exchanges and is no longer tradable

Returns:

True if the security has been delisted from exchanges and is no longer tradable

Return type:

bool

property is_tradable

Gets or sets whether or not this security should be considered tradable

Returns:

Gets or sets whether or not this security should be considered tradable

Return type:

bool

property item

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Returns:

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Return type:

object

property leverage

Leverage for this Security.

Returns:

Leverage for this Security.

Return type:

float

property local_time

Local time for this market

Returns:

Local time for this market

Return type:

datetime

property low

If this uses tradebar data, return the most recent low.

Returns:

If this uses tradebar data, return the most recent low.

Return type:

float

property margin_interest_rate_model

Gets or sets the margin interest rate model

Returns:

Gets or sets the margin interest rate model

Return type:

IMarginInterestRateModel

property margin_model

Gets the buying power model used for this security, an alias for BuyingPowerModel

Returns:

Gets the buying power model used for this security, an alias for BuyingPowerModel

Return type:

IBuyingPowerModel

property open

If this uses tradebar data, return the most recent open.

Returns:

If this uses tradebar data, return the most recent open.

Return type:

float

property open_interest

Access to the open interest of the security today

Returns:

Access to the open interest of the security today

Return type:

int

property portfolio_model

Gets the portfolio model used by this security

Returns:

Gets the portfolio model used by this security

Return type:

ISecurityPortfolioModel

property price

Get the current value of the security.

Returns:

Get the current value of the security.

Return type:

float

property price_variation_model

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Returns:

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Return type:

IPriceVariationModel

property primary_exchange

Equity primary exchange.

Returns:

Equity primary exchange.

Return type:

Exchange

property quote_currency

Gets the Cash object used for converting the quote currency to the account currency

Returns:

Gets the Cash object used for converting the quote currency to the account currency

Return type:

Cash

property settlement_model

Gets the settlement model used for this security

Returns:

Gets the settlement model used for this security

Return type:

ISettlementModel

property shortable

Checks if the equity is a shortable asset. Note that this does not take into account any open orders or existing holdings. To check if the asset is currently shortable, use QCAlgorithm's ShortableQuantity property instead.

Returns:

Checks if the equity is a shortable asset. Note that this does not take into account any open orders or existing holdings. To check if the asset is currently shortable, use QCAlgorithm's ShortableQuantity property instead.

Return type:

bool

property shortable_provider

This securities IShortableProvider

Returns:

This securities IShortableProvider

Return type:

IintableProvider

property slippage_model

Slippage model use to compute slippage of market orders

Returns:

Slippage model use to compute slippage of market orders

Return type:

ISlippageModel

property subscriptions

Gets all the subscriptions for this security

Returns:

Gets all the subscriptions for this security

Return type:

List[SubscriptionDataConfig]

property symbol

Symbol for the asset.

Returns:

Symbol for the asset.

Return type:

Symbol

property symbol_properties

Gets the symbol properties for this security

Returns:

Gets the symbol properties for this security

Return type:

SymbolProperties

property total_shortable_quantity

Gets the total quantity shortable for this security. This does not take into account any open orders or existing holdings. To check the asset's currently shortable quantity, use QCAlgorithm's ShortableQuantity property instead.

Returns:

Gets the total quantity shortable for this security. This does not take into account any open orders or existing holdings. To check the asset's currently shortable quantity, use QCAlgorithm's ShortableQuantity property instead.

Return type:

int

property type

Type of the security.

Returns:

Type of the security.

Return type:

SecurityType

property volatility_model

Gets the volatility model used for this security

Returns:

Gets the volatility model used for this security

Return type:

IVolatilityModel

property volume

Access to the volume of the equity today

Returns:

Access to the volume of the equity today

Return type:

float

field DEFAULT_SETTLEMENT_DAYS

The default number of days required to settle an equity sale

Returns:

The default number of days required to settle an equity sale

Return type:

int

field DEFAULT_SETTLEMENT_TIME

The default time of day for settlement

Returns:

The default time of day for settlement

Return type:

timedelta

Forex

class QuantConnect.Securities.Forex.Forex[source]

FOREX Security Object Implementation for FOREX Assets

clear()

Removes every custom property that had been set.

get_last_data()

Get the last price update set to the security if any else null

Return type:

BaseData

refresh_data_normalization_mode_property()

This method will refresh the value of the DataNormalizationMode property. This is required for backward-compatibility. TODO: to be deleted with the DataNormalizationMode property

set_buying_power_model(buying_power_model)

Sets the buying power model

Parameters:
  • buying_power_model (IBuyingPowerModel)
set_buying_power_model(py_object)

Sets the buying power model

Parameters:
  • py_object (PyObject)
set_data_filter(py_object)

Set Security Data Filter

Parameters:
  • py_object (PyObject)
set_data_filter(data_filter)

Set Security Data Filter

Parameters:
  • data_filter (ISecurityDataFilter)
set_fee_model(feel_model)

Sets the fee model

Parameters:
  • feel_model (IFeeModel | PyObject)
set_fill_model(fill_model)

Sets the fill model

Parameters:
  • fill_model (PyObject | IFillModel)
set_leverage(leverage)

Set the leverage parameter for this security

Parameters:
  • leverage (float)
set_local_time_keeper(local_time_keeper)

Sets the LocalTimeKeeper to be used for this . This is the source of this instance's time.

Parameters:
  • local_time_keeper (LocalTimeKeeper)
set_margin_interest_rate_model(margin_interest_rate_model)

Sets the margin interests rate model

Parameters:
  • margin_interest_rate_model (IMarginInterestRateModel)
set_margin_interest_rate_model(py_object)

Sets the margin interests rate model

Parameters:
  • py_object (PyObject)
set_margin_model(py_object)

Sets the margin model

Parameters:
  • py_object (PyObject)
set_margin_model(margin_model)

Sets the margin model

Parameters:
  • margin_model (IBuyingPowerModel)
set_market_price(data)

Update any security properties based on the latest market data and time

Parameters:
  • data (BaseData)
set_settlement_model(settlement_model)

Sets the settlement model

Parameters:
  • settlement_model (PyObject | ISettlementModel)
set_shortable_provider(py_object)

Set Python Shortable Provider for this Security

Parameters:
  • py_object (PyObject)
set_shortable_provider(shortable_provider)

Set Python Shortable Provider for this Security

Parameters:
  • shortable_provider (IintableProvider)
set_slippage_model(slippage_model)

Sets the slippage model

Parameters:
  • slippage_model (PyObject | ISlippageModel)
set_volatility_model(volatility_model)

Sets the volatility model

Parameters:
  • volatility_model (PyObject | IVolatilityModel)
update(data, data_type, contains_fill_forward_data=None)

Updates all of the security properties, such as price/OHLCV/bid/ask based on the data provided. Data is also stored into the security's data cache

Parameters:
  • data (IReadOnlyList[BaseData])
  • data_type (Type)
  • contains_fill_forward_data (bool, optional)
property ask_price

Gets the most recent ask price if available

Returns:

Gets the most recent ask price if available

Return type:

float

property ask_size

Gets the most recent ask size if available

Returns:

Gets the most recent ask size if available

Return type:

float

property base_currency

Gets the currency acquired by going long this currency pair

Returns:

Gets the currency acquired by going long this currency pair

Return type:

Cash

property bid_price

Gets the most recent bid price if available

Returns:

Gets the most recent bid price if available

Return type:

float

property bid_size

Gets the most recent bid size if available

Returns:

Gets the most recent bid size if available

Return type:

float

property buying_power_model

Gets the buying power model used for this security

Returns:

Gets the buying power model used for this security

Return type:

IBuyingPowerModel

property cache

Data cache for the security to store previous price information.

Returns:

Data cache for the security to store previous price information.

Return type:

SecurityCache

property close

If this uses tradebar data, return the most recent close.

Returns:

If this uses tradebar data, return the most recent close.

Return type:

float

property data

Provides dynamic access to data in the cache

Returns:

Provides dynamic access to data in the cache

Return type:

object

property data_filter

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Returns:

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Return type:

ISecurityDataFilter

property exchange

Exchange class contains the market opening hours, along with pre-post market hours.

Returns:

Exchange class contains the market opening hours, along with pre-post market hours.

Return type:

SecurityExchange

property fee_model

Fee model used to compute order fees for this security

Returns:

Fee model used to compute order fees for this security

Return type:

IFeeModel

property fill_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IFillModel

property fundamentals

Gets the fundamental data associated with the security if there is any, otherwise null.

Returns:

Gets the fundamental data associated with the security if there is any, otherwise null.

Return type:

Fundamental

property has_data

There has been at least one datapoint since our algorithm started running for us to determine price.

Returns:

There has been at least one datapoint since our algorithm started running for us to determine price.

Return type:

bool

property high

If this uses tradebar data, return the most recent high.

Returns:

If this uses tradebar data, return the most recent high.

Return type:

float

property hold_stock

Read only property that checks if we currently own stock in the company.

Returns:

Read only property that checks if we currently own stock in the company.

Return type:

bool

property holdings

Holdings class contains the portfolio, cash and processes order fills.

Returns:

Holdings class contains the portfolio, cash and processes order fills.

Return type:

SecurityHolding

property invested

Alias for HoldStock - Do we have any of this security

Returns:

Alias for HoldStock - Do we have any of this security

Return type:

bool

property is_delisted

True if the security has been delisted from exchanges and is no longer tradable

Returns:

True if the security has been delisted from exchanges and is no longer tradable

Return type:

bool

property is_tradable

Gets or sets whether or not this security should be considered tradable

Returns:

Gets or sets whether or not this security should be considered tradable

Return type:

bool

property item

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Returns:

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Return type:

object

property leverage

Leverage for this Security.

Returns:

Leverage for this Security.

Return type:

float

property local_time

Local time for this market

Returns:

Local time for this market

Return type:

datetime

property low

If this uses tradebar data, return the most recent low.

Returns:

If this uses tradebar data, return the most recent low.

Return type:

float

property margin_interest_rate_model

Gets or sets the margin interest rate model

Returns:

Gets or sets the margin interest rate model

Return type:

IMarginInterestRateModel

property margin_model

Gets the buying power model used for this security, an alias for BuyingPowerModel

Returns:

Gets the buying power model used for this security, an alias for BuyingPowerModel

Return type:

IBuyingPowerModel

property open

If this uses tradebar data, return the most recent open.

Returns:

If this uses tradebar data, return the most recent open.

Return type:

float

property open_interest

Access to the open interest of the security today

Returns:

Access to the open interest of the security today

Return type:

int

property portfolio_model

Gets the portfolio model used by this security

Returns:

Gets the portfolio model used by this security

Return type:

ISecurityPortfolioModel

property price

Get the current value of the security.

Returns:

Get the current value of the security.

Return type:

float

property price_variation_model

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Returns:

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Return type:

IPriceVariationModel

property quote_currency

Gets the Cash object used for converting the quote currency to the account currency

Returns:

Gets the Cash object used for converting the quote currency to the account currency

Return type:

Cash

property settlement_model

Gets the settlement model used for this security

Returns:

Gets the settlement model used for this security

Return type:

ISettlementModel

property shortable_provider

This securities IShortableProvider

Returns:

This securities IShortableProvider

Return type:

IintableProvider

property slippage_model

Slippage model use to compute slippage of market orders

Returns:

Slippage model use to compute slippage of market orders

Return type:

ISlippageModel

property subscriptions

Gets all the subscriptions for this security

Returns:

Gets all the subscriptions for this security

Return type:

List[SubscriptionDataConfig]

property symbol

Symbol for the asset.

Returns:

Symbol for the asset.

Return type:

Symbol

property symbol_properties

Gets the symbol properties for this security

Returns:

Gets the symbol properties for this security

Return type:

SymbolProperties

property type

Type of the security.

Returns:

Type of the security.

Return type:

SecurityType

property volatility_model

Gets the volatility model used for this security

Returns:

Gets the volatility model used for this security

Return type:

IVolatilityModel

property volume

Access to the volume of the equity today

Returns:

Access to the volume of the equity today

Return type:

float

Fundamental

class QuantConnect.Data.Fundamental.Fundamental[source]

Lean fundamental data class

clone(fill_forward)

Return a new instance clone of this object, used in fill forward

Parameters:
  • fill_forward (bool)
Return type:

BaseData

data_time_zone()

Specifies the data time zone for this data type. This is useful for custom data types

Return type:

datetimeZone

default_resolution()

Gets the default resolution for this data and security type

Return type:

Resolution

get_source(config, date, is_live_mode)

Return the URL string source of the file. This will be converted to a stream

Parameters:
  • config (SubscriptionDataConfig)
  • date (datetime)
  • is_live_mode (bool)
Return type:

SubscriptionDataSource

is_sparse_data()

Indicates that the data set is expected to be sparse

Return type:

bool

reader(config, line, date, is_live_mode)

Will read a new instance from the given line

Parameters:
  • config (SubscriptionDataConfig)
  • line (str)
  • date (datetime)
  • is_live_mode (bool)
Return type:

BaseData

reader(config, stream, date, is_live_mode)

Reader converts each line of the data source into BaseData objects. Each data type creates its own factory method, and returns a new instance of the object each time it is called. The returned object is assumed to be time stamped in the config.ExchangeTimeZone.

Parameters:
  • config (SubscriptionDataConfig)
  • stream (StreamReader)
  • date (datetime)
  • is_live_mode (bool)
Return type:

BaseData

requires_mapping()

Indicates if there is support for mapping

Return type:

bool

should_cache_to_security()

Indicates whether this contains data that should be stored in the security cache

Return type:

bool

supported_resolutions()

This is a daily data set

Return type:

List[Resolution]

update(last_trade, bid_price, ask_price, volume, bid_size, ask_size)

Updates this base data with a new trade

Parameters:
  • last_trade (float)
  • bid_price (float)
  • ask_price (float)
  • volume (float)
  • bid_size (float)
  • ask_size (float)
update_ask(ask_price, ask_size)

Updates this base data with the new quote ask information

Parameters:
  • ask_price (float)
  • ask_size (float)
update_bid(bid_price, bid_size)

Updates this base data with the new quote bid information

Parameters:
  • bid_price (float)
  • bid_size (float)
update_quote(bid_price, bid_size, ask_price, ask_size)

Updates this base data with new quote information

Parameters:
  • bid_price (float)
  • bid_size (float)
  • ask_price (float)
  • ask_size (float)
update_trade(last_trade, trade_size)

Updates this base data with a new trade

Parameters:
  • last_trade (float)
  • trade_size (float)
property adjusted_price

Gets the split and dividend adjusted price

Returns:

Gets the split and dividend adjusted price

Return type:

float

property asset_classification

The instance of the AssetClassification class

Returns:

The instance of the AssetClassification class

Return type:

AssetClassification

property company_profile

The instance of the CompanyProfile class

Returns:

The instance of the CompanyProfile class

Return type:

CompanyProfile

property company_reference

The instance of the CompanyReference class

Returns:

The instance of the CompanyReference class

Return type:

CompanyReference

property data_type

Market Data Type of this data - does it come in individual price packets or is it grouped into OHLC.

Returns:

Market Data Type of this data - does it come in individual price packets or is it grouped into OHLC.

Return type:

MarketDataType

property dollar_volume

Gets the day's dollar volume for this symbol

Returns:

Gets the day's dollar volume for this symbol

Return type:

float

property earning_ratios

The instance of the EarningRatios class

Returns:

The instance of the EarningRatios class

Return type:

EarningRatios

property earning_reports

The instance of the EarningReports class

Returns:

The instance of the EarningReports class

Return type:

EarningReports

property end_time

The end time of this data.

Returns:

The end time of this data.

Return type:

datetime

property financial_statements

The instance of the FinancialStatements class

Returns:

The instance of the FinancialStatements class

Return type:

FinancialStatements

property has_fundamental_data

Returns whether the symbol has fundamental data for the given date

Returns:

Returns whether the symbol has fundamental data for the given date

Return type:

bool

property is_fill_forward

True if this is a fill forward piece of data

Returns:

True if this is a fill forward piece of data

Return type:

bool

property market

Gets the market for this symbol

Returns:

Gets the market for this symbol

Return type:

str

property market_cap

Price * Total SharesOutstanding. The most current market cap for example, would be the most recent closing price x the most recent reported shares outstanding. For ADR share classes, market cap is price * (ordinary shares outstanding / adr ratio).

Returns:

Price * Total SharesOutstanding. The most current market cap for example, would be the most recent closing price x the most recent reported shares outstanding. For ADR share classes, market cap is price * (ordinary shares outstanding / adr ratio).

Return type:

int

property operation_ratios

The instance of the OperationRatios class

Returns:

The instance of the OperationRatios class

Return type:

OperationRatios

property price

Gets the raw price

Returns:

Gets the raw price

Return type:

float

property price_factor

Gets the price factor for the given date

Returns:

Gets the price factor for the given date

Return type:

float

property price_scale_factor

Gets the combined factor used to create adjusted prices from raw prices

Returns:

Gets the combined factor used to create adjusted prices from raw prices

Return type:

float

property security_reference

The instance of the SecurityReference class

Returns:

The instance of the SecurityReference class

Return type:

SecurityReference

property split_factor

Gets the split factor for the given date

Returns:

Gets the split factor for the given date

Return type:

float

property symbol

Symbol representation for underlying Security

Returns:

Symbol representation for underlying Security

Return type:

Symbol

property time

Current time marker of this data packet.

Returns:

Current time marker of this data packet.

Return type:

datetime

property valuation_ratios

The instance of the ValuationRatios class

Returns:

The instance of the ValuationRatios class

Return type:

ValuationRatios

property value

Gets the raw price

Returns:

Gets the raw price

Return type:

float

property volume

Gets the day's total volume

Returns:

Gets the day's total volume

Return type:

int

Future

class QuantConnect.Securities.Future.Future[source]

Futures Security Object Implementation for Futures Assets

clear()

Removes every custom property that had been set.

get_last_data()

Get the last price update set to the security if any else null

Return type:

BaseData

refresh_data_normalization_mode_property()

This method will refresh the value of the DataNormalizationMode property. This is required for backward-compatibility. TODO: to be deleted with the DataNormalizationMode property

set_buying_power_model(buying_power_model)

Sets the buying power model

Parameters:
  • buying_power_model (IBuyingPowerModel)
set_buying_power_model(py_object)

Sets the buying power model

Parameters:
  • py_object (PyObject)
set_data_filter(py_object)

Set Security Data Filter

Parameters:
  • py_object (PyObject)
set_data_filter(data_filter)

Set Security Data Filter

Parameters:
  • data_filter (ISecurityDataFilter)
set_fee_model(feel_model)

Sets the fee model

Parameters:
  • feel_model (IFeeModel | PyObject)
set_fill_model(fill_model)

Sets the fill model

Parameters:
  • fill_model (PyObject | IFillModel)
set_filter(min_expiry, max_expiry)

Sets the ContractFilter to a new instance of the filter using the specified expiration range values

Parameters:
  • min_expiry (timedelta)
  • max_expiry (timedelta)
set_filter(min_expiry_days, max_expiry_days)

Sets the ContractFilter to a new instance of the filter using the specified expiration range values

Parameters:
  • min_expiry_days (int)
  • max_expiry_days (int)
set_filter(universe_func)

Sets the ContractFilter to a new instance of the filter using the specified expiration range values

Parameters:
  • universe_func (PyObject | 0, Culture=neutral, PublicKeyToken=null]])
set_leverage(leverage)

Set the leverage parameter for this security

Parameters:
  • leverage (float)
set_local_time_keeper(local_time_keeper)

Sets the LocalTimeKeeper to be used for this . This is the source of this instance's time.

Parameters:
  • local_time_keeper (LocalTimeKeeper)
set_margin_interest_rate_model(margin_interest_rate_model)

Sets the margin interests rate model

Parameters:
  • margin_interest_rate_model (IMarginInterestRateModel)
set_margin_interest_rate_model(py_object)

Sets the margin interests rate model

Parameters:
  • py_object (PyObject)
set_margin_model(py_object)

Sets the margin model

Parameters:
  • py_object (PyObject)
set_margin_model(margin_model)

Sets the margin model

Parameters:
  • margin_model (IBuyingPowerModel)
set_market_price(data)

Update any security properties based on the latest market data and time

Parameters:
  • data (BaseData)
set_settlement_model(settlement_model)

Sets the settlement model

Parameters:
  • settlement_model (PyObject | ISettlementModel)
set_shortable_provider(py_object)

Set Python Shortable Provider for this Security

Parameters:
  • py_object (PyObject)
set_shortable_provider(shortable_provider)

Set Python Shortable Provider for this Security

Parameters:
  • shortable_provider (IintableProvider)
set_slippage_model(slippage_model)

Sets the slippage model

Parameters:
  • slippage_model (PyObject | ISlippageModel)
set_volatility_model(volatility_model)

Sets the volatility model

Parameters:
  • volatility_model (PyObject | IVolatilityModel)
update(data, data_type, contains_fill_forward_data=None)

Updates all of the security properties, such as price/OHLCV/bid/ask based on the data provided. Data is also stored into the security's data cache

Parameters:
  • data (IReadOnlyList[BaseData])
  • data_type (Type)
  • contains_fill_forward_data (bool, optional)
property ask_price

Gets the most recent ask price if available

Returns:

Gets the most recent ask price if available

Return type:

float

property ask_size

Gets the most recent ask size if available

Returns:

Gets the most recent ask size if available

Return type:

float

property bid_price

Gets the most recent bid price if available

Returns:

Gets the most recent bid price if available

Return type:

float

property bid_size

Gets the most recent bid size if available

Returns:

Gets the most recent bid size if available

Return type:

float

property buying_power_model

Gets the buying power model used for this security

Returns:

Gets the buying power model used for this security

Return type:

IBuyingPowerModel

property cache

Data cache for the security to store previous price information.

Returns:

Data cache for the security to store previous price information.

Return type:

SecurityCache

property close

If this uses tradebar data, return the most recent close.

Returns:

If this uses tradebar data, return the most recent close.

Return type:

float

property contract_filter

Gets or sets the contract filter

Returns:

Gets or sets the contract filter

Return type:

IDerivativeSecurityFilter

property data

Provides dynamic access to data in the cache

Returns:

Provides dynamic access to data in the cache

Return type:

object

property data_filter

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Returns:

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Return type:

ISecurityDataFilter

property exchange

Exchange class contains the market opening hours, along with pre-post market hours.

Returns:

Exchange class contains the market opening hours, along with pre-post market hours.

Return type:

SecurityExchange

property expiry

Gets the expiration date

Returns:

Gets the expiration date

Return type:

datetime

property fee_model

Fee model used to compute order fees for this security

Returns:

Fee model used to compute order fees for this security

Return type:

IFeeModel

property fill_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IFillModel

property fundamentals

Gets the fundamental data associated with the security if there is any, otherwise null.

Returns:

Gets the fundamental data associated with the security if there is any, otherwise null.

Return type:

Fundamental

property has_data

There has been at least one datapoint since our algorithm started running for us to determine price.

Returns:

There has been at least one datapoint since our algorithm started running for us to determine price.

Return type:

bool

property high

If this uses tradebar data, return the most recent high.

Returns:

If this uses tradebar data, return the most recent high.

Return type:

float

property hold_stock

Read only property that checks if we currently own stock in the company.

Returns:

Read only property that checks if we currently own stock in the company.

Return type:

bool

property holdings

Holdings class contains the portfolio, cash and processes order fills.

Returns:

Holdings class contains the portfolio, cash and processes order fills.

Return type:

SecurityHolding

property invested

Alias for HoldStock - Do we have any of this security

Returns:

Alias for HoldStock - Do we have any of this security

Return type:

bool

property is_delisted

True if the security has been delisted from exchanges and is no longer tradable

Returns:

True if the security has been delisted from exchanges and is no longer tradable

Return type:

bool

property is_future_chain

Returns true if this is the future chain security, false if it is a specific future contract

Returns:

Returns true if this is the future chain security, false if it is a specific future contract

Return type:

bool

property is_future_contract

Returns true if this is a specific future contract security, false if it is the future chain security

Returns:

Returns true if this is a specific future contract security, false if it is the future chain security

Return type:

bool

property is_tradable

Gets or sets whether or not this security should be considered tradable

Returns:

Gets or sets whether or not this security should be considered tradable

Return type:

bool

property item

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Returns:

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Return type:

object

property leverage

Leverage for this Security.

Returns:

Leverage for this Security.

Return type:

float

property local_time

Local time for this market

Returns:

Local time for this market

Return type:

datetime

property low

If this uses tradebar data, return the most recent low.

Returns:

If this uses tradebar data, return the most recent low.

Return type:

float

property mapped

Gets or sets the currently mapped symbol for the security

Returns:

Gets or sets the currently mapped symbol for the security

Return type:

Symbol

property margin_interest_rate_model

Gets or sets the margin interest rate model

Returns:

Gets or sets the margin interest rate model

Return type:

IMarginInterestRateModel

property margin_model

Gets the buying power model used for this security, an alias for BuyingPowerModel

Returns:

Gets the buying power model used for this security, an alias for BuyingPowerModel

Return type:

IBuyingPowerModel

property open

If this uses tradebar data, return the most recent open.

Returns:

If this uses tradebar data, return the most recent open.

Return type:

float

property open_interest

Access to the open interest of the security today

Returns:

Access to the open interest of the security today

Return type:

int

property portfolio_model

Gets the portfolio model used by this security

Returns:

Gets the portfolio model used by this security

Return type:

ISecurityPortfolioModel

property price

Get the current value of the security.

Returns:

Get the current value of the security.

Return type:

float

property price_variation_model

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Returns:

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Return type:

IPriceVariationModel

property quote_currency

Gets the Cash object used for converting the quote currency to the account currency

Returns:

Gets the Cash object used for converting the quote currency to the account currency

Return type:

Cash

property settlement_model

Gets the settlement model used for this security

Returns:

Gets the settlement model used for this security

Return type:

ISettlementModel

property settlement_type

Specifies if futures contract has physical or cash settlement on settlement

Returns:

Specifies if futures contract has physical or cash settlement on settlement

Return type:

SettlementType

property shortable_provider

This securities IShortableProvider

Returns:

This securities IShortableProvider

Return type:

IintableProvider

property slippage_model

Slippage model use to compute slippage of market orders

Returns:

Slippage model use to compute slippage of market orders

Return type:

ISlippageModel

property subscriptions

Gets all the subscriptions for this security

Returns:

Gets all the subscriptions for this security

Return type:

List[SubscriptionDataConfig]

property symbol

Symbol for the asset.

Returns:

Symbol for the asset.

Return type:

Symbol

property symbol_properties

Gets the symbol properties for this security

Returns:

Gets the symbol properties for this security

Return type:

SymbolProperties

property type

Type of the security.

Returns:

Type of the security.

Return type:

SecurityType

property underlying

Gets or sets the underlying security object.

Returns:

Gets or sets the underlying security object.

Return type:

Security

property volatility_model

Gets the volatility model used for this security

Returns:

Gets the volatility model used for this security

Return type:

IVolatilityModel

property volume

Access to the volume of the equity today

Returns:

Access to the volume of the equity today

Return type:

float

field DEFAULT_SETTLEMENT_DAYS

The default number of days required to settle a futures sale

Returns:

The default number of days required to settle a futures sale

Return type:

int

field DEFAULT_SETTLEMENT_TIME

The default time of day for settlement

Returns:

The default time of day for settlement

Return type:

timedelta

HistoryRequest

class QuantConnect.Data.HistoryRequest[source]

Represents a request for historical data

property contract_depth_offset

The continuous contract desired offset from the current front month. For example, 0 (default) will use the front month, 1 will use the back month contract

Returns:

The continuous contract desired offset from the current front month. For example, 0 (default) will use the front month, 1 will use the back month contract

Return type:

int

property data_mapping_mode

Gets the data mapping mode used for this subscription

Returns:

Gets the data mapping mode used for this subscription

Return type:

DataMappingMode

property data_normalization_mode

Gets the normalization mode used for this subscription

Returns:

Gets the normalization mode used for this subscription

Return type:

DataNormalizationMode

property data_time_zone

Gets the time zone of the time stamps on the raw input data

Returns:

Gets the time zone of the time stamps on the raw input data

Return type:

datetimeZone

property data_type

Gets the data type used to process the subscription request, this type must derive from BaseData

Returns:

Gets the data type used to process the subscription request, this type must derive from BaseData

Return type:

Type

property end_time_local

Gets the EndTimeUtc in the security's exchange time zone

Returns:

Gets the EndTimeUtc in the security's exchange time zone

Return type:

datetime

property end_time_utc

Gets the end of the requested time interval in UTC

Returns:

Gets the end of the requested time interval in UTC

Return type:

datetime

property exchange_hours

Gets the exchange hours used for processing fill forward requests

Returns:

Gets the exchange hours used for processing fill forward requests

Return type:

SecurityExchangeHours

property fill_forward_resolution

Gets the requested fill forward resolution, set to null for no fill forward behavior. Will always return null when Resolution is set to Tick.

Returns:

Gets the requested fill forward resolution, set to null for no fill forward behavior. Will always return null when Resolution is set to Tick.

Return type:

Resolution

property include_extended_market_hours

Gets whether or not to include extended market hours data, set to false for only normal market hours

Returns:

Gets whether or not to include extended market hours data, set to false for only normal market hours

Return type:

bool

property is_custom_data

Gets true if this is a custom data request, false for normal QC data

Returns:

Gets true if this is a custom data request, false for normal QC data

Return type:

bool

property resolution

Gets the requested data resolution

Returns:

Gets the requested data resolution

Return type:

Resolution

property start_time_local

Gets the StartTimeUtc in the security's exchange time zone

Returns:

Gets the StartTimeUtc in the security's exchange time zone

Return type:

datetime

property start_time_utc

Gets the beginning of the requested time interval in UTC

Returns:

Gets the beginning of the requested time interval in UTC

Return type:

datetime

property symbol

Gets the symbol to request data for

Returns:

Gets the symbol to request data for

Return type:

Symbol

property tick_type

TickType of the history request

Returns:

TickType of the history request

Return type:

TickType

property tradable_days_in_data_time_zone

Gets the tradable days specified by this request, in the security's data time zone

Returns:

Gets the tradable days specified by this request, in the security's data time zone

Return type:

List[datetime]

Index

class QuantConnect.Securities.Index.Index[source]

INDEX Security Object Implementation for INDEX Assets

clear()

Removes every custom property that had been set.

get_last_data()

Get the last price update set to the security if any else null

Return type:

BaseData

refresh_data_normalization_mode_property()

This method will refresh the value of the DataNormalizationMode property. This is required for backward-compatibility. TODO: to be deleted with the DataNormalizationMode property

set_buying_power_model(buying_power_model)

Sets the buying power model

Parameters:
  • buying_power_model (IBuyingPowerModel)
set_buying_power_model(py_object)

Sets the buying power model

Parameters:
  • py_object (PyObject)
set_data_filter(py_object)

Set Security Data Filter

Parameters:
  • py_object (PyObject)
set_data_filter(data_filter)

Set Security Data Filter

Parameters:
  • data_filter (ISecurityDataFilter)
set_fee_model(feel_model)

Sets the fee model

Parameters:
  • feel_model (IFeeModel | PyObject)
set_fill_model(fill_model)

Sets the fill model

Parameters:
  • fill_model (PyObject | IFillModel)
set_leverage(leverage)

Set the leverage parameter for this security

Parameters:
  • leverage (float)
set_local_time_keeper(local_time_keeper)

Sets the LocalTimeKeeper to be used for this . This is the source of this instance's time.

Parameters:
  • local_time_keeper (LocalTimeKeeper)
set_margin_interest_rate_model(margin_interest_rate_model)

Sets the margin interests rate model

Parameters:
  • margin_interest_rate_model (IMarginInterestRateModel)
set_margin_interest_rate_model(py_object)

Sets the margin interests rate model

Parameters:
  • py_object (PyObject)
set_margin_model(py_object)

Sets the margin model

Parameters:
  • py_object (PyObject)
set_margin_model(margin_model)

Sets the margin model

Parameters:
  • margin_model (IBuyingPowerModel)
set_market_price(data)

Update any security properties based on the latest market data and time

Parameters:
  • data (BaseData)
set_settlement_model(settlement_model)

Sets the settlement model

Parameters:
  • settlement_model (PyObject | ISettlementModel)
set_shortable_provider(py_object)

Set Python Shortable Provider for this Security

Parameters:
  • py_object (PyObject)
set_shortable_provider(shortable_provider)

Set Python Shortable Provider for this Security

Parameters:
  • shortable_provider (IintableProvider)
set_slippage_model(slippage_model)

Sets the slippage model

Parameters:
  • slippage_model (PyObject | ISlippageModel)
set_volatility_model(volatility_model)

Sets the volatility model

Parameters:
  • volatility_model (PyObject | IVolatilityModel)
update(data, data_type, contains_fill_forward_data=None)

Updates all of the security properties, such as price/OHLCV/bid/ask based on the data provided. Data is also stored into the security's data cache

Parameters:
  • data (IReadOnlyList[BaseData])
  • data_type (Type)
  • contains_fill_forward_data (bool, optional)
property ask_price

Gets the most recent ask price if available

Returns:

Gets the most recent ask price if available

Return type:

float

property ask_size

Gets the most recent ask size if available

Returns:

Gets the most recent ask size if available

Return type:

float

property bid_price

Gets the most recent bid price if available

Returns:

Gets the most recent bid price if available

Return type:

float

property bid_size

Gets the most recent bid size if available

Returns:

Gets the most recent bid size if available

Return type:

float

property buying_power_model

Gets the buying power model used for this security

Returns:

Gets the buying power model used for this security

Return type:

IBuyingPowerModel

property cache

Data cache for the security to store previous price information.

Returns:

Data cache for the security to store previous price information.

Return type:

SecurityCache

property close

If this uses tradebar data, return the most recent close.

Returns:

If this uses tradebar data, return the most recent close.

Return type:

float

property data

Provides dynamic access to data in the cache

Returns:

Provides dynamic access to data in the cache

Return type:

object

property data_filter

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Returns:

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Return type:

ISecurityDataFilter

property exchange

Exchange class contains the market opening hours, along with pre-post market hours.

Returns:

Exchange class contains the market opening hours, along with pre-post market hours.

Return type:

SecurityExchange

property fee_model

Fee model used to compute order fees for this security

Returns:

Fee model used to compute order fees for this security

Return type:

IFeeModel

property fill_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IFillModel

property fundamentals

Gets the fundamental data associated with the security if there is any, otherwise null.

Returns:

Gets the fundamental data associated with the security if there is any, otherwise null.

Return type:

Fundamental

property has_data

There has been at least one datapoint since our algorithm started running for us to determine price.

Returns:

There has been at least one datapoint since our algorithm started running for us to determine price.

Return type:

bool

property high

If this uses tradebar data, return the most recent high.

Returns:

If this uses tradebar data, return the most recent high.

Return type:

float

property hold_stock

Read only property that checks if we currently own stock in the company.

Returns:

Read only property that checks if we currently own stock in the company.

Return type:

bool

property holdings

Holdings class contains the portfolio, cash and processes order fills.

Returns:

Holdings class contains the portfolio, cash and processes order fills.

Return type:

SecurityHolding

property invested

Alias for HoldStock - Do we have any of this security

Returns:

Alias for HoldStock - Do we have any of this security

Return type:

bool

property is_delisted

True if the security has been delisted from exchanges and is no longer tradable

Returns:

True if the security has been delisted from exchanges and is no longer tradable

Return type:

bool

property is_tradable

Gets or sets whether or not this security should be considered tradable

Returns:

Gets or sets whether or not this security should be considered tradable

Return type:

bool

property item

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Returns:

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Return type:

object

property leverage

Leverage for this Security.

Returns:

Leverage for this Security.

Return type:

float

property local_time

Local time for this market

Returns:

Local time for this market

Return type:

datetime

property low

If this uses tradebar data, return the most recent low.

Returns:

If this uses tradebar data, return the most recent low.

Return type:

float

property margin_interest_rate_model

Gets or sets the margin interest rate model

Returns:

Gets or sets the margin interest rate model

Return type:

IMarginInterestRateModel

property margin_model

Gets the buying power model used for this security, an alias for BuyingPowerModel

Returns:

Gets the buying power model used for this security, an alias for BuyingPowerModel

Return type:

IBuyingPowerModel

property open

If this uses tradebar data, return the most recent open.

Returns:

If this uses tradebar data, return the most recent open.

Return type:

float

property open_interest

Access to the open interest of the security today

Returns:

Access to the open interest of the security today

Return type:

int

property portfolio_model

Gets the portfolio model used by this security

Returns:

Gets the portfolio model used by this security

Return type:

ISecurityPortfolioModel

property price

Get the current value of the security.

Returns:

Get the current value of the security.

Return type:

float

property price_variation_model

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Returns:

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Return type:

IPriceVariationModel

property quote_currency

Gets the Cash object used for converting the quote currency to the account currency

Returns:

Gets the Cash object used for converting the quote currency to the account currency

Return type:

Cash

property settlement_model

Gets the settlement model used for this security

Returns:

Gets the settlement model used for this security

Return type:

ISettlementModel

property shortable_provider

This securities IShortableProvider

Returns:

This securities IShortableProvider

Return type:

IintableProvider

property slippage_model

Slippage model use to compute slippage of market orders

Returns:

Slippage model use to compute slippage of market orders

Return type:

ISlippageModel

property subscriptions

Gets all the subscriptions for this security

Returns:

Gets all the subscriptions for this security

Return type:

List[SubscriptionDataConfig]

property symbol

Symbol for the asset.

Returns:

Symbol for the asset.

Return type:

Symbol

property symbol_properties

Gets the symbol properties for this security

Returns:

Gets the symbol properties for this security

Return type:

SymbolProperties

property type

Type of the security.

Returns:

Type of the security.

Return type:

SecurityType

property volatility_model

Gets the volatility model used for this security

Returns:

Gets the volatility model used for this security

Return type:

IVolatilityModel

property volume

Access to the volume of the equity today

Returns:

Access to the volume of the equity today

Return type:

float

Insight

class QuantConnect.Algorithm.Framework.Alphas.Insight[source]

Defines a alpha prediction for a single symbol generated by the algorithm

cancel(utc_time)

Cancel this insight

Parameters:
  • utc_time (datetime)
clone()

Creates a deep clone of this insight instance

Return type:

Insight

expire(utc_time)

Expire this insight

Parameters:
  • utc_time (datetime)
is_active(utc_time)

Determines whether or not this insight is considered active at the specified utcTime

Parameters:
  • utc_time (datetime)
Return type:

bool

is_expired(utc_time)

Determines whether or not this insight is considered expired at the specified utcTime

Parameters:
  • utc_time (datetime)
Return type:

bool

set_period_and_close_time(exchange_hours)

Sets the insight period and close times if they have not already been set.

Parameters:
short_to_string()

Returns a short string that represents the current object.

Return type:

str

property close_time_utc

Gets the insight's prediction end time. This is the time when this insight prediction is expected to be fulfilled. This time takes into account market hours, weekends, as well as the symbol's data resolution

Returns:

Gets the insight's prediction end time. This is the time when this insight prediction is expected to be fulfilled. This time takes into account market hours, weekends, as well as the symbol's data resolution

Return type:

datetime

property confidence

Gets the confidence in this insight

Returns:

Gets the confidence in this insight

Return type:

float

property direction

Gets the predicted direction, down, flat or up

Returns:

Gets the predicted direction, down, flat or up

Return type:

InsightDirection

property estimated_value

Gets the estimated value of this insight in the account currency

Returns:

Gets the estimated value of this insight in the account currency

Return type:

float

property generated_time_utc

Gets the utc time this insight was generated

Returns:

Gets the utc time this insight was generated

Return type:

datetime

property group_id

Gets the group id this insight belongs to, null if not in a group

Returns:

Gets the group id this insight belongs to, null if not in a group

Return type:

Guid

property id

Gets the unique identifier for this insight

Returns:

Gets the unique identifier for this insight

Return type:

Guid

property magnitude

Gets the predicted percent change in the insight type (price/volatility)

Returns:

Gets the predicted percent change in the insight type (price/volatility)

Return type:

float

property period

Gets the period over which this insight is expected to come to fruition

Returns:

Gets the period over which this insight is expected to come to fruition

Return type:

timedelta

property reference_value

Gets the initial reference value this insight is predicting against. The value is dependent on the specified InsightType

Returns:

Gets the initial reference value this insight is predicting against. The value is dependent on the specified InsightType

Return type:

float

property reference_value_final

Gets the final reference value, used for scoring, this insight is predicting against. The value is dependent on the specified InsightType

Returns:

Gets the final reference value, used for scoring, this insight is predicting against. The value is dependent on the specified InsightType

Return type:

float

property score

Gets the most recent scores for this insight

Returns:

Gets the most recent scores for this insight

Return type:

InsightScore

property source_model

Gets an identifier for the source model that generated this insight.

Returns:

Gets an identifier for the source model that generated this insight.

Return type:

str

property symbol

Gets the symbol this insight is for

Returns:

Gets the symbol this insight is for

Return type:

Symbol

property tag

The insight's tag containing additional information

Returns:

The insight's tag containing additional information

Return type:

str

property type

Gets the type of insight, for example, price insight or volatility insight

Returns:

Gets the type of insight, for example, price insight or volatility insight

Return type:

InsightType

property weight

Gets the portfolio weight of this insight

Returns:

Gets the portfolio weight of this insight

Return type:

float

InsightManager

class QuantConnect.Algorithm.Framework.Alphas.Analysis.InsightManager[source]

Encapsulates the storage of insights.

add(item)

Adds an item to the list.

Parameters:
add_range(insights)

Adds each item in the specified enumerable of insights to this collection

Parameters:
  • insights (List[Insight])
cancel(symbols)

Cancel the insights of the given symbols

Parameters:
  • symbols (List[Symbol])
cancel(insights)

Cancel the insights of the given symbols

Parameters:
  • insights (List[Insight])
clear(symbols)

Removes the symbol and its insights

Parameters:
contains(item)

Determines whether the list contains a specific value.

Parameters:
Return type:

bool

contains_key(symbol)

Determines whether insights exist in this collection for the specified symbol

Parameters:
Return type:

bool

expire(symbols)

Expire the insights of the given symbols

Parameters:
  • symbols (List[Symbol])
expire(insights)

Expire the insights of the given symbols

Parameters:
  • insights (List[Insight])
get_active_insights(utc_time)

Gets the last generated active insight

Parameters:
  • utc_time (datetime)
Return type:

ICollection[Insight]

get_enumerator()

Returns an enumerator that iterates through the collection.

Return type:

IEnumerator[Insight]

get_insights(filter)

Will return insights from the complete insight collection

Parameters:
  • filter (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

List[Insight]

get_next_expiry_time()

Gets the next expiry time UTC

Return type:

datetime

has_active_insights(symbol, utc_time)

Returns true if there are active insights for a given symbol and time

Parameters:
  • symbol (Symbol)
  • utc_time (datetime)
Return type:

bool

remove(item)

Removes the first occurrence of a specific object from the list.

Parameters:
Return type:

bool

remove_expired_insights(utc_time)

Remove all expired insights from the collection and retuns them

Parameters:
  • utc_time (datetime)
Return type:

ICollection[Insight]

remove_insights(filter)

Will remove insights from the complete insight collection

Parameters:
  • filter (Callable[Insight, bool])
set_insight_score_function(insight_score_function)

Sets the insight score function to use

Parameters:
  • insight_score_function (PyObject | IInsightScoreCallabletion)
step(utc_now)

Process a new time step handling insights scoring

Parameters:
  • utc_now (datetime)
try_get_value(symbol, insights)

Attempts to get the list of insights with the specified symbol key

Parameters:
  • symbol (Symbol)
  • insights (List`1&)
Return type:

bool

property count

The open insight count

Returns:

The open insight count

Return type:

int

property item

Dictionary accessor returns a list of insights for the specified symbol

Returns:

Dictionary accessor returns a list of insights for the specified symbol

Return type:

List[Insight]

property total_count

The total insight count

Returns:

The total insight count

Return type:

int

NotificationManager

class QuantConnect.Notifications.NotificationManager[source]

Local/desktop implementation of messaging system for Lean Engine.

email(address, subject, message, data, headers)

Send an email to the address specified for live trading notifications.

Parameters:
  • address (str)
  • subject (str)
  • message (str)
  • data (str)
  • headers (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

bool

sms(phone_number, message)

Send an SMS to the phone number specified

Parameters:
  • phone_number (str)
  • message (str)
Return type:

bool

telegram(id, message, token=None)

Send a telegram message to the chat ID specified, supply token for custom bot. Note: Requires bot to have chat with user or be in the group specified by ID.

Parameters:
  • id (str)
  • message (str)
  • token (str, optional)
Return type:

bool

web(address, data, headers)

Place REST POST call to the specified address with the specified DATA. Python overload for Headers parameter.

Parameters:
  • address (str)
  • data (Object)
  • headers (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

bool

property messages

Public access to the messages

Returns:

Public access to the messages

Return type:

ConcurrentQueue[Notification]

ObjectStore

class QuantConnect.Storage.ObjectStore[source]

Helper class for easier access to IObjectStore methods

clear()

Will clear the object store state cache. This is useful when the object store is used concurrently by nodes which want to share information

contains_key(path)

Determines whether the store contains data for the specified path

Parameters:
  • path (str)
Return type:

bool

delete(path)

Deletes the object data for the specified path

Parameters:
  • path (str)
Return type:

bool

dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

get_enumerator()

Returns an enumerator that iterates through the collection.

Return type:

IEnumerator[Dict[str, Byte]]

get_file_path(path)

Returns the file path for the specified path

Parameters:
  • path (str)
Return type:

str

initialize(user_id, project_id, user_token, controls)

Initializes the object store

Parameters:
  • user_id (int)
  • project_id (int)
  • user_token (str)
  • controls (Controls)
read(path, encoding=None)

Returns the object data for the specified path

Parameters:
  • path (str)
  • encoding (Encoding, optional)
Return type:

str

read_bytes(path)

Returns the object data for the specified path

Parameters:
  • path (str)
Return type:

Byte

read_json(path, encoding=None, settings=None)

Returns the JSON deserialized object data for the specified path

Parameters:
  • path (str)
  • encoding (Encoding, optional)
  • settings (JsonSerializerSettings, optional)
Return type:

T

read_string(path, encoding=None)

Returns the string object data for the specified path

Parameters:
  • path (str)
  • encoding (Encoding, optional)
Return type:

str

read_xml(path, encoding=None)

Returns the XML deserialized object data for the specified path

Parameters:
  • path (str)
  • encoding (Encoding, optional)
Return type:

T

save(path, text, encoding=None)

Saves the object data for the specified path

Parameters:
  • path (str)
  • text (str)
  • encoding (Encoding, optional)
Return type:

bool

save_bytes(path, contents)

Saves the object data for the specified path

Parameters:
  • path (str)
  • contents (Byte)
Return type:

bool

save_json(path, obj, encoding=None, settings=None)

Saves the object data in JSON format for the specified path

Parameters:
  • path (str)
  • obj (T)
  • encoding (Encoding, optional)
  • settings (JsonSerializerSettings, optional)
Return type:

bool

save_string(path, text, encoding=None)

Saves the object data in text format for the specified path

Parameters:
  • path (str)
  • text (str)
  • encoding (Encoding, optional)
Return type:

bool

save_xml(path, obj, encoding=None)

Saves the object data in XML format for the specified path

Parameters:
  • path (str)
  • obj (T)
  • encoding (Encoding, optional)
Return type:

bool

property keys

Returns the file paths present in the object store. This is specially useful not to load the object store into memory

Returns:

Returns the file paths present in the object store. This is specially useful not to load the object store into memory

Return type:

ICollection[str]

Option

class QuantConnect.Securities.Option.Option[source]

Option Security Object Implementation for Option Assets

clear()

Removes every custom property that had been set.

evaluate_price_model(slice, contract)

For this option security object, evaluates the specified option contract to compute a theoretical price, IV and greeks

Parameters:
  • slice (Slice)
  • contract (OptionContract)
Return type:

OptionPriceModelResult

get_aggregate_exercise_amount()

Aggregate exercise amount or aggregate contract value. It is the total amount of cash one will pay (or receive) for the shares of the underlying stock if he/she decides to exercise (or is assigned an exercise notice). This amount is not the premium paid or received for an equity option.

Return type:

float

get_exercise_quantity(exercise_order_quantity)

Returns the directional quantity of underlying shares that are going to change hands on exercise/assignment of all contracts held by this account, taking into account the contract's Right as well as the contract's current , which may have recently changed due to a split/reverse split in the underlying security.

Parameters:
  • exercise_order_quantity (float)
Return type:

float

get_intrinsic_value(underlying_price)

Intrinsic value function of the option

Parameters:
  • underlying_price (float)
Return type:

float

get_last_data()

Get the last price update set to the security if any else null

Return type:

BaseData

get_pay_off(underlying_price)

Option payoff function at expiration time

Parameters:
  • underlying_price (float)
Return type:

float

is_auto_exercised(underlying_price)

Checks if option is eligible for automatic exercise on expiration

Parameters:
  • underlying_price (float)
Return type:

bool

out_of_the_money_amount(underlying_price)

Option out of the money function

Parameters:
  • underlying_price (float)
Return type:

float

refresh_data_normalization_mode_property()

This method will refresh the value of the DataNormalizationMode property. This is required for backward-compatibility. TODO: to be deleted with the DataNormalizationMode property

set_buying_power_model(buying_power_model)

Sets the buying power model

Parameters:
  • buying_power_model (IBuyingPowerModel)
set_buying_power_model(py_object)

Sets the buying power model

Parameters:
  • py_object (PyObject)
set_data_filter(py_object)

Set Security Data Filter

Parameters:
  • py_object (PyObject)
set_data_filter(data_filter)

Set Security Data Filter

Parameters:
  • data_filter (ISecurityDataFilter)
set_data_normalization_mode(mode)

Sets the data normalization mode to be used by this security

Parameters:
  • mode (DataNormalizationMode)
set_fee_model(feel_model)

Sets the fee model

Parameters:
  • feel_model (IFeeModel | PyObject)
set_fill_model(fill_model)

Sets the fill model

Parameters:
  • fill_model (PyObject | IFillModel)
set_filter(min_strike, max_strike, min_expiry, max_expiry)

Sets the ContractFilter to a new instance of the filter using the specified min and max strike values. Contracts with expirations further than 35 days out will also be filtered.

Parameters:
  • min_strike (int)
  • max_strike (int)
  • min_expiry (timedelta)
  • max_expiry (timedelta)
set_filter(min_strike, max_strike, min_expiry_days, max_expiry_days)

Sets the ContractFilter to a new instance of the filter using the specified min and max strike values. Contracts with expirations further than 35 days out will also be filtered.

Parameters:
  • min_strike (int)
  • max_strike (int)
  • min_expiry_days (int)
  • max_expiry_days (int)
set_filter(universe_func)

Sets the ContractFilter to a new instance of the filter using the specified min and max strike values. Contracts with expirations further than 35 days out will also be filtered.

Parameters:
  • universe_func (0, Culture=neutral, PublicKeyToken=null]] | PyObject)
set_leverage(leverage)

Set the leverage parameter for this security

Parameters:
  • leverage (float)
set_local_time_keeper(local_time_keeper)

Sets the LocalTimeKeeper to be used for this . This is the source of this instance's time.

Parameters:
  • local_time_keeper (LocalTimeKeeper)
set_margin_interest_rate_model(margin_interest_rate_model)

Sets the margin interests rate model

Parameters:
  • margin_interest_rate_model (IMarginInterestRateModel)
set_margin_interest_rate_model(py_object)

Sets the margin interests rate model

Parameters:
  • py_object (PyObject)
set_margin_model(py_object)

Sets the margin model

Parameters:
  • py_object (PyObject)
set_margin_model(margin_model)

Sets the margin model

Parameters:
  • margin_model (IBuyingPowerModel)
set_market_price(data)

Update any security properties based on the latest market data and time

Parameters:
  • data (BaseData)
set_option_assignment_model(py_object)

Sets the automatic option assignment model

Parameters:
  • py_object (PyObject)
set_option_assignment_model(option_assignment_model)

Sets the automatic option assignment model

Parameters:
  • option_assignment_model (IOptionAssignmentModel)
set_option_exercise_model(py_object)

Sets the option exercise model

Parameters:
  • py_object (PyObject)
set_option_exercise_model(option_exercise_model)

Sets the option exercise model

Parameters:
  • option_exercise_model (IOptionExerciseModel)
set_settlement_model(settlement_model)

Sets the settlement model

Parameters:
  • settlement_model (PyObject | ISettlementModel)
set_shortable_provider(py_object)

Set Python Shortable Provider for this Security

Parameters:
  • py_object (PyObject)
set_shortable_provider(shortable_provider)

Set Python Shortable Provider for this Security

Parameters:
  • shortable_provider (IintableProvider)
set_slippage_model(slippage_model)

Sets the slippage model

Parameters:
  • slippage_model (PyObject | ISlippageModel)
set_volatility_model(volatility_model)

Sets the volatility model

Parameters:
  • volatility_model (PyObject | IVolatilityModel)
update(data, data_type, contains_fill_forward_data=None)

Updates all of the security properties, such as price/OHLCV/bid/ask based on the data provided. Data is also stored into the security's data cache

Parameters:
  • data (IReadOnlyList[BaseData])
  • data_type (Type)
  • contains_fill_forward_data (bool, optional)
property ask_price

Gets the most recent ask price if available

Returns:

Gets the most recent ask price if available

Return type:

float

property ask_size

Gets the most recent ask size if available

Returns:

Gets the most recent ask size if available

Return type:

float

property bid_price

Gets the most recent bid price if available

Returns:

Gets the most recent bid price if available

Return type:

float

property bid_size

Gets the most recent bid size if available

Returns:

Gets the most recent bid size if available

Return type:

float

property buying_power_model

Gets the buying power model used for this security

Returns:

Gets the buying power model used for this security

Return type:

IBuyingPowerModel

property cache

Data cache for the security to store previous price information.

Returns:

Data cache for the security to store previous price information.

Return type:

SecurityCache

property close

If this uses tradebar data, return the most recent close.

Returns:

If this uses tradebar data, return the most recent close.

Return type:

float

property contract_filter

Gets or sets the contract filter

Returns:

Gets or sets the contract filter

Return type:

IDerivativeSecurityFilter

property contract_multiplier

The contract multiplier for the option security

Returns:

The contract multiplier for the option security

Return type:

int

property contract_unit_of_trade

When the holder of an equity option exercises one contract, or when the writer of an equity option is assigned an exercise notice on one contract, this unit of trade, usually 100 shares of the underlying security, changes hands.

Returns:

When the holder of an equity option exercises one contract, or when the writer of an equity option is assigned an exercise notice on one contract, this unit of trade, usually 100 shares of the underlying security, changes hands.

Return type:

int

property data

Provides dynamic access to data in the cache

Returns:

Provides dynamic access to data in the cache

Return type:

object

property data_filter

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Returns:

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Return type:

ISecurityDataFilter

property exchange

Exchange class contains the market opening hours, along with pre-post market hours.

Returns:

Exchange class contains the market opening hours, along with pre-post market hours.

Return type:

SecurityExchange

property exercise_settlement

Specifies if option contract has physical or cash settlement on exercise

Returns:

Specifies if option contract has physical or cash settlement on exercise

Return type:

SettlementType

property expiry

Gets the expiration date

Returns:

Gets the expiration date

Return type:

datetime

property fee_model

Fee model used to compute order fees for this security

Returns:

Fee model used to compute order fees for this security

Return type:

IFeeModel

property fill_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IFillModel

property fundamentals

Gets the fundamental data associated with the security if there is any, otherwise null.

Returns:

Gets the fundamental data associated with the security if there is any, otherwise null.

Return type:

Fundamental

property has_data

There has been at least one datapoint since our algorithm started running for us to determine price.

Returns:

There has been at least one datapoint since our algorithm started running for us to determine price.

Return type:

bool

property high

If this uses tradebar data, return the most recent high.

Returns:

If this uses tradebar data, return the most recent high.

Return type:

float

property hold_stock

Read only property that checks if we currently own stock in the company.

Returns:

Read only property that checks if we currently own stock in the company.

Return type:

bool

property holdings

Holdings class contains the portfolio, cash and processes order fills.

Returns:

Holdings class contains the portfolio, cash and processes order fills.

Return type:

SecurityHolding

property invested

Alias for HoldStock - Do we have any of this security

Returns:

Alias for HoldStock - Do we have any of this security

Return type:

bool

property is_delisted

True if the security has been delisted from exchanges and is no longer tradable

Returns:

True if the security has been delisted from exchanges and is no longer tradable

Return type:

bool

property is_option_chain

Returns true if this is the option chain security, false if it is a specific option contract

Returns:

Returns true if this is the option chain security, false if it is a specific option contract

Return type:

bool

property is_option_contract

Returns true if this is a specific option contract security, false if it is the option chain security

Returns:

Returns true if this is a specific option contract security, false if it is the option chain security

Return type:

bool

property is_tradable

Gets or sets whether or not this security should be considered tradable

Returns:

Gets or sets whether or not this security should be considered tradable

Return type:

bool

property item

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Returns:

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Return type:

object

property leverage

Leverage for this Security.

Returns:

Leverage for this Security.

Return type:

float

property local_time

Local time for this market

Returns:

Local time for this market

Return type:

datetime

property low

If this uses tradebar data, return the most recent low.

Returns:

If this uses tradebar data, return the most recent low.

Return type:

float

property margin_interest_rate_model

Gets or sets the margin interest rate model

Returns:

Gets or sets the margin interest rate model

Return type:

IMarginInterestRateModel

property margin_model

Gets the buying power model used for this security, an alias for BuyingPowerModel

Returns:

Gets the buying power model used for this security, an alias for BuyingPowerModel

Return type:

IBuyingPowerModel

property open

If this uses tradebar data, return the most recent open.

Returns:

If this uses tradebar data, return the most recent open.

Return type:

float

property open_interest

Access to the open interest of the security today

Returns:

Access to the open interest of the security today

Return type:

int

property option_assignment_model

The automatic option assignment model

Returns:

The automatic option assignment model

Return type:

IOptionAssignmentModel

property option_exercise_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IOptionExerciseModel

property portfolio_model

Gets the portfolio model used by this security

Returns:

Gets the portfolio model used by this security

Return type:

ISecurityPortfolioModel

property price

Get the current value of the security.

Returns:

Get the current value of the security.

Return type:

float

property price_model

Gets or sets the price model for this option security

Returns:

Gets or sets the price model for this option security

Return type:

IOptionPriceModel

property price_variation_model

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Returns:

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Return type:

IPriceVariationModel

property quote_currency

Gets the Cash object used for converting the quote currency to the account currency

Returns:

Gets the Cash object used for converting the quote currency to the account currency

Return type:

Cash

property right

Gets the right being purchased (call [right to buy] or put [right to sell])

Returns:

Gets the right being purchased (call [right to buy] or put [right to sell])

Return type:

OptionRight

property scaled_strike_price

Gets the strike price multiplied by the strike multiplier

Returns:

Gets the strike price multiplied by the strike multiplier

Return type:

float

property settlement_model

Gets the settlement model used for this security

Returns:

Gets the settlement model used for this security

Return type:

ISettlementModel

property shortable_provider

This securities IShortableProvider

Returns:

This securities IShortableProvider

Return type:

IintableProvider

property slippage_model

Slippage model use to compute slippage of market orders

Returns:

Slippage model use to compute slippage of market orders

Return type:

ISlippageModel

property strike_price

Gets the strike price

Returns:

Gets the strike price

Return type:

float

property style

Gets the option style

Returns:

Gets the option style

Return type:

OptionStyle

property subscriptions

Gets all the subscriptions for this security

Returns:

Gets all the subscriptions for this security

Return type:

List[SubscriptionDataConfig]

property symbol

Symbol for the asset.

Returns:

Symbol for the asset.

Return type:

Symbol

property symbol_properties

Gets the symbol properties for this security

Returns:

Gets the symbol properties for this security

Return type:

SymbolProperties

property type

Type of the security.

Returns:

Type of the security.

Return type:

SecurityType

property underlying

Gets or sets the underlying security object.

Returns:

Gets or sets the underlying security object.

Return type:

Security

property volatility_model

Gets the volatility model used for this security

Returns:

Gets the volatility model used for this security

Return type:

IVolatilityModel

property volume

Access to the volume of the equity today

Returns:

Access to the volume of the equity today

Return type:

float

field DEFAULT_SETTLEMENT_DAYS

The default number of days required to settle an equity sale

Returns:

The default number of days required to settle an equity sale

Return type:

int

field DEFAULT_SETTLEMENT_TIME

The default time of day for settlement

Returns:

The default time of day for settlement

Return type:

timedelta

OptionStrategy

class QuantConnect.Securities.Option.OptionStrategy[source]

Option strategy specification class. Describes option strategy and its parameters for trading.

property canonical_option

The canonical Option symbol of the strategy

Returns:

The canonical Option symbol of the strategy

Return type:

Symbol

property name

Option strategy name

Returns:

Option strategy name

Return type:

str

property option_legs

Option strategy legs

Returns:

Option strategy legs

Return type:

List[OptionLegData]

property underlying

Underlying symbol of the strategy

Returns:

Underlying symbol of the strategy

Return type:

Symbol

property underlying_legs

Option strategy underlying legs (usually 0 or 1 legs)

Returns:

Option strategy underlying legs (usually 0 or 1 legs)

Return type:

List[UnderlyingLegData]

OrderEvent

class QuantConnect.Orders.OrderEvent[source]

Order Event - Messaging class signifying a change in an order state and record the change in the user's algorithm portfolio

clone()

Returns a clone of the current object.

Return type:

OrderEvent

short_to_string()

Returns a short string that represents the current object.

Return type:

str

property absolute_fill_quantity

Public Property Absolute Getter of Quantity -Filled

Returns:

Public Property Absolute Getter of Quantity -Filled

Return type:

float

property direction

Order direction.

Returns:

Order direction.

Return type:

OrderDirection

property fill_price

Fill price information about the order

Returns:

Fill price information about the order

Return type:

float

property fill_price_currency

Currency for the fill price

Returns:

Currency for the fill price

Return type:

str

property fill_quantity

Number of shares of the order that was filled in this event.

Returns:

Number of shares of the order that was filled in this event.

Return type:

float

property id

The unique order event id for each order

Returns:

The unique order event id for each order

Return type:

int

property is_assignment

True if the order event is an assignment

Returns:

True if the order event is an assignment

Return type:

bool

property is_in_the_money

True if the order event's option is In-The-Money (ITM)

Returns:

True if the order event's option is In-The-Money (ITM)

Return type:

bool

property limit_price

The current limit price

Returns:

The current limit price

Return type:

float

property message

Any message from the exchange.

Returns:

Any message from the exchange.

Return type:

str

property order_fee

The fee associated with the order

Returns:

The fee associated with the order

Return type:

OrderFee

property order_id

Id of the order this event comes from.

Returns:

Id of the order this event comes from.

Return type:

int

property quantity

The current order quantity

Returns:

The current order quantity

Return type:

float

property status

Status message of the order.

Returns:

Status message of the order.

Return type:

OrderStatus

property stop_price

The current stop price

Returns:

The current stop price

Return type:

float

property symbol

Easy access to the order symbol associated with this event.

Returns:

Easy access to the order symbol associated with this event.

Return type:

Symbol

property ticket

The order ticket associated to the order

Returns:

The order ticket associated to the order

Return type:

OrderTicket

property trailing_amount

The trailing stop amount

Returns:

The trailing stop amount

Return type:

float

property trailing_as_percentage

Whether the TrailingAmount is a percentage or an absolute currency value

Returns:

Whether the TrailingAmount is a percentage or an absolute currency value

Return type:

bool

property trigger_price

The current trigger price

Returns:

The current trigger price

Return type:

float

property utc_time

The date and time of this event (UTC).

Returns:

The date and time of this event (UTC).

Return type:

datetime

OrderTicket

class QuantConnect.Orders.OrderTicket[source]

Provides a single reference to an order for the algorithm to maintain. As the order gets updated this ticket will also get updated

cancel(tag=None)

Submits a new request to cancel this order

Parameters:
  • tag (str, optional)
Return type:

OrderResponse

get(field)

Gets the specified field from the ticket

Parameters:
  • field (OrderField)
Return type:

float

get_most_recent_order_request()

Gets the most recent OrderRequest for this ticket

Return type:

OrderRequest

get_most_recent_order_response()

Gets the most recent OrderResponse for this ticket

Return type:

OrderResponse

update(fields)

Submits an UpdateOrderRequest with the to update the ticket with data specified in fields

Parameters:
  • fields (UpdateOrderFields)
Return type:

OrderResponse

update_limit_price(limit_price, tag=None)

Submits an UpdateOrderRequest with the to update the ticker with limit price specified in limitPrice and with tag specified in

Parameters:
  • limit_price (float)
  • tag (str, optional)
Return type:

OrderResponse

update_quantity(quantity, tag=None)

Submits an UpdateOrderRequest with the to update the ticket with quantity specified in quantity and with tag specified in quantity

Parameters:
  • quantity (float)
  • tag (str, optional)
Return type:

OrderResponse

update_stop_price(stop_price, tag=None)

Submits an UpdateOrderRequest with the to update the ticker with stop price specified in stopPrice and with tag specified in

Parameters:
  • stop_price (float)
  • tag (str, optional)
Return type:

OrderResponse

update_stop_trailing_amount(trailing_amount, tag=None)

Submits an UpdateOrderRequest with the to update the ticker with stop trailing amount specified in trailingAmount and with tag specified in

Parameters:
  • trailing_amount (float)
  • tag (str, optional)
Return type:

OrderResponse

update_tag(tag)

Submits an UpdateOrderRequest with the to update the ticket with tag specified in tag

Parameters:
  • tag (str)
Return type:

OrderResponse

update_trigger_price(trigger_price, tag=None)

Submits an UpdateOrderRequest with the to update the ticker with trigger price specified in triggerPrice and with tag specified in

Parameters:
  • trigger_price (float)
  • tag (str, optional)
Return type:

OrderResponse

property average_fill_price

Gets the average fill price for this ticket. If no fills have been processed then this will return a value of zero.

Returns:

Gets the average fill price for this ticket. If no fills have been processed then this will return a value of zero.

Return type:

float

property cancel_request

Gets the CancelOrderRequest if this order was canceled. If this order was not canceled, this will return null

Returns:

Gets the CancelOrderRequest if this order was canceled. If this order was not canceled, this will return null

Return type:

CancelOrderRequest

property has_order

Returns true if the order has been set for this ticket

Returns:

Returns true if the order has been set for this ticket

Return type:

bool

property order_closed

Gets a wait handle that can be used to wait until this order has filled

Returns:

Gets a wait handle that can be used to wait until this order has filled

Return type:

WaitHandle

property order_events

Gets a list of all order events for this ticket

Returns:

Gets a list of all order events for this ticket

Return type:

IReadOnlyList[OrderEvent]

property order_id

Gets the order id of this ticket

Returns:

Gets the order id of this ticket

Return type:

int

property order_set

Gets a wait handle that can be used to wait until the order has been set

Returns:

Gets a wait handle that can be used to wait until the order has been set

Return type:

WaitHandle

property order_type

Gets the type of order

Returns:

Gets the type of order

Return type:

OrderType

property quantity

Gets the number of units ordered

Returns:

Gets the number of units ordered

Return type:

float

property quantity_filled

Gets the total qantity filled for this ticket. If no fills have been processed then this will return a value of zero.

Returns:

Gets the total qantity filled for this ticket. If no fills have been processed then this will return a value of zero.

Return type:

float

property security_type

Gets the Symbol's

Returns:

Gets the Symbol's

Return type:

SecurityType

property status

Gets the current status of this order ticket

Returns:

Gets the current status of this order ticket

Return type:

OrderStatus

property submit_request

Gets the SubmitOrderRequest that initiated this order

Returns:

Gets the SubmitOrderRequest that initiated this order

Return type:

SubmitOrderRequest

property symbol

Gets the symbol being ordered

Returns:

Gets the symbol being ordered

Return type:

Symbol

property tag

Gets the order's current tag

Returns:

Gets the order's current tag

Return type:

str

property time

Gets the time this order was last updated

Returns:

Gets the time this order was last updated

Return type:

datetime

property update_requests

Gets a list of UpdateOrderRequest containing an item for each UpdateOrderRequest that was sent for this order id

Returns:

Gets a list of UpdateOrderRequest containing an item for each UpdateOrderRequest that was sent for this order id

Return type:

IReadOnlyList[UpdateOrderRequest]

PandasConverter

class QuantConnect.Python.PandasConverter[source]

Collection of methods that converts lists of objects in pandas.DataFrame

get_data_frame(data, data_type=None)

Converts an enumerable of Slice in a pandas.DataFrame

Parameters:
  • data (0, Culture=neutral, PublicKeyToken=null]] | None)
  • data_type (Type, optional)
Return type:

PyObject

get_indicator_data_frame(data)

Converts a dictionary with a list of IndicatorDataPoint in a pandas.DataFrame

Parameters:
  • data (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

PyObject

Resolution

enum QuantConnect.Resolution[source]

Resolution of data requested.

field DAILY

Daily Resolution (4)

Returns:

Daily Resolution (4)

Return type:

Resolution

field HOUR

Hour Resolution (3)

Returns:

Hour Resolution (3)

Return type:

Resolution

field MINUTE

Minute Resolution (2)

Returns:

Minute Resolution (2)

Return type:

Resolution

field SECOND

Second Resolution (1)

Returns:

Second Resolution (1)

Return type:

Resolution

field TICK

Tick Resolution (0)

Returns:

Tick Resolution (0)

Return type:

Resolution

ScheduleManager

class QuantConnect.Scheduling.ScheduleManager[source]

Provides access to the real time handler's event scheduling feature

add(scheduled_event)

Adds the specified event to the schedule

Parameters:
event(name)

Entry point for the fluent scheduled event builder

Parameters:
  • name (str)
Return type:

IFluentSchedulingDateSpecifier

on(name, date_rule, time_rule, callback)

Schedules the callback to run using the specified date and time rules

Parameters:
  • name (str)
  • date_rule (IDateRule)
  • time_rule (ITimeRule)
  • callback (Action | PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

ScheduledEvent

remove(scheduled_event)

Removes the specified event from the schedule

Parameters:
training(date_rule, time_rule, training_code)

Schedules the provided training code to execute immediately

Parameters:
  • date_rule (IDateRule)
  • time_rule (ITimeRule)
  • training_code (Action | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]] | PyObject)
Return type:

ScheduledEvent

training_now(training_code)

Schedules the provided training code to execute immediately

Parameters:
  • training_code (Action | PyObject)
Return type:

ScheduledEvent

property date_rules

Gets the date rules helper object to make specifying dates for events easier

Returns:

Gets the date rules helper object to make specifying dates for events easier

Return type:

DateRules

property time_rules

Gets the time rules helper object to make specifying times for events easier

Returns:

Gets the time rules helper object to make specifying times for events easier

Return type:

TimeRules

ScheduledEvent

class QuantConnect.Scheduling.ScheduledEvent[source]

Real time self scheduling event

property enabled

Gets or sets whether this event is enabled

Returns:

Gets or sets whether this event is enabled

Return type:

bool

property name

Gets an identifier for this event

Returns:

Gets an identifier for this event

Return type:

str

property next_event_utc_time

Gets the next time this scheduled event will fire in UTC

Returns:

Gets the next time this scheduled event will fire in UTC

Return type:

datetime

field ALGORITHM_END_OF_DAY_DELTA

Gets the default time before midnight end of day events will fire

Returns:

Gets the default time before midnight end of day events will fire

Return type:

timedelta

field SECURITY_END_OF_DAY_DELTA

Gets the default time before market close end of trading day events will fire

Returns:

Gets the default time before market close end of trading day events will fire

Return type:

timedelta

Security

class QuantConnect.Securities.Security[source]

A base vehicle properties class for providing a common interface to all assets in QuantConnect.

clear()

Removes every custom property that had been set.

get_last_data()

Get the last price update set to the security if any else null

Return type:

BaseData

refresh_data_normalization_mode_property()

This method will refresh the value of the DataNormalizationMode property. This is required for backward-compatibility. TODO: to be deleted with the DataNormalizationMode property

set_buying_power_model(buying_power_model)

Sets the buying power model

Parameters:
  • buying_power_model (IBuyingPowerModel)
set_buying_power_model(py_object)

Sets the buying power model

Parameters:
  • py_object (PyObject)
set_data_filter(py_object)

Set Security Data Filter

Parameters:
  • py_object (PyObject)
set_data_filter(data_filter)

Set Security Data Filter

Parameters:
  • data_filter (ISecurityDataFilter)
set_fee_model(feel_model)

Sets the fee model

Parameters:
  • feel_model (IFeeModel | PyObject)
set_fill_model(fill_model)

Sets the fill model

Parameters:
  • fill_model (PyObject | IFillModel)
set_leverage(leverage)

Set the leverage parameter for this security

Parameters:
  • leverage (float)
set_local_time_keeper(local_time_keeper)

Sets the LocalTimeKeeper to be used for this . This is the source of this instance's time.

Parameters:
  • local_time_keeper (LocalTimeKeeper)
set_margin_interest_rate_model(margin_interest_rate_model)

Sets the margin interests rate model

Parameters:
  • margin_interest_rate_model (IMarginInterestRateModel)
set_margin_interest_rate_model(py_object)

Sets the margin interests rate model

Parameters:
  • py_object (PyObject)
set_margin_model(py_object)

Sets the margin model

Parameters:
  • py_object (PyObject)
set_margin_model(margin_model)

Sets the margin model

Parameters:
  • margin_model (IBuyingPowerModel)
set_market_price(data)

Update any security properties based on the latest market data and time

Parameters:
  • data (BaseData)
set_settlement_model(settlement_model)

Sets the settlement model

Parameters:
  • settlement_model (PyObject | ISettlementModel)
set_shortable_provider(py_object)

Set Python Shortable Provider for this Security

Parameters:
  • py_object (PyObject)
set_shortable_provider(shortable_provider)

Set Python Shortable Provider for this Security

Parameters:
  • shortable_provider (IintableProvider)
set_slippage_model(slippage_model)

Sets the slippage model

Parameters:
  • slippage_model (PyObject | ISlippageModel)
set_volatility_model(volatility_model)

Sets the volatility model

Parameters:
  • volatility_model (PyObject | IVolatilityModel)
update(data, data_type, contains_fill_forward_data=None)

Updates all of the security properties, such as price/OHLCV/bid/ask based on the data provided. Data is also stored into the security's data cache

Parameters:
  • data (IReadOnlyList[BaseData])
  • data_type (Type)
  • contains_fill_forward_data (bool, optional)
property ask_price

Gets the most recent ask price if available

Returns:

Gets the most recent ask price if available

Return type:

float

property ask_size

Gets the most recent ask size if available

Returns:

Gets the most recent ask size if available

Return type:

float

property bid_price

Gets the most recent bid price if available

Returns:

Gets the most recent bid price if available

Return type:

float

property bid_size

Gets the most recent bid size if available

Returns:

Gets the most recent bid size if available

Return type:

float

property buying_power_model

Gets the buying power model used for this security

Returns:

Gets the buying power model used for this security

Return type:

IBuyingPowerModel

property cache

Data cache for the security to store previous price information.

Returns:

Data cache for the security to store previous price information.

Return type:

SecurityCache

property close

If this uses tradebar data, return the most recent close.

Returns:

If this uses tradebar data, return the most recent close.

Return type:

float

property data

Provides dynamic access to data in the cache

Returns:

Provides dynamic access to data in the cache

Return type:

object

property data_filter

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Returns:

Customizable data filter to filter outlier ticks before they are passed into user event handlers. By default all ticks are passed into the user algorithms.

Return type:

ISecurityDataFilter

property exchange

Exchange class contains the market opening hours, along with pre-post market hours.

Returns:

Exchange class contains the market opening hours, along with pre-post market hours.

Return type:

SecurityExchange

property fee_model

Fee model used to compute order fees for this security

Returns:

Fee model used to compute order fees for this security

Return type:

IFeeModel

property fill_model

Fill model used to produce fill events for this security

Returns:

Fill model used to produce fill events for this security

Return type:

IFillModel

property fundamentals

Gets the fundamental data associated with the security if there is any, otherwise null.

Returns:

Gets the fundamental data associated with the security if there is any, otherwise null.

Return type:

Fundamental

property has_data

There has been at least one datapoint since our algorithm started running for us to determine price.

Returns:

There has been at least one datapoint since our algorithm started running for us to determine price.

Return type:

bool

property high

If this uses tradebar data, return the most recent high.

Returns:

If this uses tradebar data, return the most recent high.

Return type:

float

property hold_stock

Read only property that checks if we currently own stock in the company.

Returns:

Read only property that checks if we currently own stock in the company.

Return type:

bool

property holdings

Holdings class contains the portfolio, cash and processes order fills.

Returns:

Holdings class contains the portfolio, cash and processes order fills.

Return type:

SecurityHolding

property invested

Alias for HoldStock - Do we have any of this security

Returns:

Alias for HoldStock - Do we have any of this security

Return type:

bool

property is_delisted

True if the security has been delisted from exchanges and is no longer tradable

Returns:

True if the security has been delisted from exchanges and is no longer tradable

Return type:

bool

property is_tradable

Gets or sets whether or not this security should be considered tradable

Returns:

Gets or sets whether or not this security should be considered tradable

Return type:

bool

property item

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Returns:

Gets or sets the specified custom property through the indexer. This is a wrapper around the String) and methods.

Return type:

object

property leverage

Leverage for this Security.

Returns:

Leverage for this Security.

Return type:

float

property local_time

Local time for this market

Returns:

Local time for this market

Return type:

datetime

property low

If this uses tradebar data, return the most recent low.

Returns:

If this uses tradebar data, return the most recent low.

Return type:

float

property margin_interest_rate_model

Gets or sets the margin interest rate model

Returns:

Gets or sets the margin interest rate model

Return type:

IMarginInterestRateModel

property margin_model

Gets the buying power model used for this security, an alias for BuyingPowerModel

Returns:

Gets the buying power model used for this security, an alias for BuyingPowerModel

Return type:

IBuyingPowerModel

property open

If this uses tradebar data, return the most recent open.

Returns:

If this uses tradebar data, return the most recent open.

Return type:

float

property open_interest

Access to the open interest of the security today

Returns:

Access to the open interest of the security today

Return type:

int

property portfolio_model

Gets the portfolio model used by this security

Returns:

Gets the portfolio model used by this security

Return type:

ISecurityPortfolioModel

property price

Get the current value of the security.

Returns:

Get the current value of the security.

Return type:

float

property price_variation_model

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Returns:

Customizable price variation model used to define the minimum price variation of this security. By default minimum price variation is a constant find in the symbol-properties-database.

Return type:

IPriceVariationModel

property quote_currency

Gets the Cash object used for converting the quote currency to the account currency

Returns:

Gets the Cash object used for converting the quote currency to the account currency

Return type:

Cash

property settlement_model

Gets the settlement model used for this security

Returns:

Gets the settlement model used for this security

Return type:

ISettlementModel

property shortable_provider

This securities IShortableProvider

Returns:

This securities IShortableProvider

Return type:

IintableProvider

property slippage_model

Slippage model use to compute slippage of market orders

Returns:

Slippage model use to compute slippage of market orders

Return type:

ISlippageModel

property subscriptions

Gets all the subscriptions for this security

Returns:

Gets all the subscriptions for this security

Return type:

List[SubscriptionDataConfig]

property symbol

Symbol for the asset.

Returns:

Symbol for the asset.

Return type:

Symbol

property symbol_properties

Gets the symbol properties for this security

Returns:

Gets the symbol properties for this security

Return type:

SymbolProperties

property type

Type of the security.

Returns:

Type of the security.

Return type:

SecurityType

property volatility_model

Gets the volatility model used for this security

Returns:

Gets the volatility model used for this security

Return type:

IVolatilityModel

property volume

Access to the volume of the equity today

Returns:

Access to the volume of the equity today

Return type:

float

field NULL_LEVERAGE

A null security leverage value

Returns:

A null security leverage value

Return type:

float

SecurityChanges

class QuantConnect.Data.UniverseSelection.SecurityChanges[source]

Defines the additions and subtractions to the algorithm's security subscriptions

property added_securities

Gets the symbols that were added by universe selection

Returns:

Gets the symbols that were added by universe selection

Return type:

IReadOnlyList[Security]

property count

Gets the total count of added and removed securities

Returns:

Gets the total count of added and removed securities

Return type:

int

property filter_custom_securities

True will filter out custom securities from the AddedSecurities and properties

Returns:

True will filter out custom securities from the AddedSecurities and properties

Return type:

bool

property filter_internal_securities

True will filter out internal securities from the AddedSecurities and properties

Returns:

True will filter out internal securities from the AddedSecurities and properties

Return type:

bool

property removed_securities

Gets the symbols that were removed by universe selection. This list may include symbols that were removed, but are still receiving data due to existing holdings or open orders

Returns:

Gets the symbols that were removed by universe selection. This list may include symbols that were removed, but are still receiving data due to existing holdings or open orders

Return type:

IReadOnlyList[Security]

field NONE

Gets an instance that represents no changes have been made

Returns:

Gets an instance that represents no changes have been made

Return type:

SecurityChanges

SecurityExchangeHours

class QuantConnect.Securities.SecurityExchangeHours[source]

Represents the schedule of a security exchange. This includes daily regular and extended market hours as well as holidays, early closes and late opens.

get_market_hours(local_date_time)

Helper to access the market hours field based on the day of week

Parameters:
  • local_date_time (datetime)
Return type:

LocalMarketHours

get_next_market_close(local_date_time, extended_market_hours)

Gets the local date time corresponding to the next market close following the specified time

Parameters:
  • local_date_time (datetime)
  • extended_market_hours (bool)
Return type:

datetime

get_next_market_open(local_date_time, extended_market_hours)

Gets the local date time corresponding to the next market open following the specified time

Parameters:
  • local_date_time (datetime)
  • extended_market_hours (bool)
Return type:

datetime

get_next_trading_day(date)

Gets the next trading day

Parameters:
  • date (datetime)
Return type:

datetime

get_previous_market_open(local_date_time, extended_market_hours)

Gets the local date time corresponding to the previous market open to the specified time

Parameters:
  • local_date_time (datetime)
  • extended_market_hours (bool)
Return type:

datetime

get_previous_trading_day(local_date)

Gets the previous trading day

Parameters:
  • local_date (datetime)
Return type:

datetime

is_date_open(local_date_time)

Determines if the exchange will be open on the date specified by the local date time

Parameters:
  • local_date_time (datetime)
Return type:

bool

is_open(start_local_date_time, end_local_date_time, extended_market_hours)

Determines if the exchange is open at the specified local date time.

Parameters:
  • start_local_date_time (datetime)
  • end_local_date_time (datetime)
  • extended_market_hours (bool)
Return type:

bool

is_open(local_date_time, extended_market_hours)

Determines if the exchange is open at the specified local date time.

Parameters:
  • local_date_time (datetime)
  • extended_market_hours (bool)
Return type:

bool

property early_closes

Gets the early closes for this exchange

Returns:

Gets the early closes for this exchange

Return type:

IReadOnlyDict[datetime, timedelta]

property holidays

Gets the holidays for the exchange

Returns:

Gets the holidays for the exchange

Return type:

HashSet[datetime]

property is_market_always_open

Checks whether the market is always open or not

Returns:

Checks whether the market is always open or not

Return type:

bool

property late_opens

Gets the late opens for this exchange

Returns:

Gets the late opens for this exchange

Return type:

IReadOnlyDict[datetime, timedelta]

property market_hours

Gets the market hours for this exchange

Returns:

Gets the market hours for this exchange

Return type:

IReadOnlyDict[DayOfWeek, LocalMarketHours]

property regular_market_duration

Gets the most common tradable time during the market week. For a normal US equity trading day this is 6.5 hours. This does NOT account for extended market hours and only considers Market

Returns:

Gets the most common tradable time during the market week. For a normal US equity trading day this is 6.5 hours. This does NOT account for extended market hours and only considers Market

Return type:

timedelta

property time_zone

Gets the time zone this exchange resides in

Returns:

Gets the time zone this exchange resides in

Return type:

datetimeZone

SecurityManager

class QuantConnect.Securities.SecurityManager[source]

Enumerable security management class for grouping security objects into an array and providing any common properties.

clear()

Clear the securities array to delete all the portfolio and asset information.

contains(pair)

Check if this collection contains this key value pair.

Parameters:
  • pair (Dict[Symbol, Security])
Return type:

bool

contains_key(symbol)

Check if this collection contains this symbol.

Parameters:
Return type:

bool

copy()

Creates a shallow copy of the dictionary.

Return type:

PyDict

copy_to(array, number)

Copy from the internal array to an external array.

Parameters:
  • array (Dict`2)
  • number (int)
create_security(symbol, subscription_data_config_list, leverage=0.0, add_to_symbol_cache=True, underlying=None)

Creates a new security

Parameters:
  • symbol (Symbol)
  • subscription_data_config_list (List[SubscriptionDataConfig])
  • leverage (float, optional)
  • add_to_symbol_cache (bool, optional)
  • underlying (Security, optional)
Return type:

Security

create_security(symbol, subscription_data_config, leverage=0.0, add_to_symbol_cache=True, underlying=None)

Creates a new security

Parameters:
  • symbol (Symbol)
  • subscription_data_config (SubscriptionDataConfig)
  • leverage (float, optional)
  • add_to_symbol_cache (bool, optional)
  • underlying (Security, optional)
Return type:

Security

fromkeys(sequence, value)

Creates a new dictionary from the given sequence of elements.

Parameters:
Return type:

PyDict

items()

Returns a view object that displays a list of dictionary's (Symbol, value) tuple pairs.

Return type:

PyList

keys()

Returns a view object that displays a list of all the Symbol objects in the dictionary

Return type:

PyList

pop(symbol, default_value)

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Parameters:
Return type:

Security

popitem()

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Return type:

PyTuple

set_live_mode(is_live_mode)

Set live mode state of the algorithm

Parameters:
  • is_live_mode (bool)
set_security_service(security_service)

Sets the Security Service to be used

Parameters:
  • security_service (SecurityService)
setdefault(symbol, default_value)

Returns the value of a Symbol (if the Symbol is in dictionary). If not, it inserts Symbol with a value to the dictionary.

Parameters:
Return type:

Security

try_get_value(symbol, security)

Try and get this security object with matching symbol and return true on success.

Parameters:
Return type:

bool

update(other)

Updates the dictionary with the elements from the another dictionary object or from an iterable of Symbol/value pairs. The update() method adds element(s) to the dictionary if the Symbol is not in the dictionary.If the Symbol is in the dictionary, it updates the Symbol with the new value.

Parameters:
  • other (PyObject)
values()

Returns a view object that displays a list of all the values in the dictionary.

Return type:

PyList

property count

Count of the number of securities in the collection.

Returns:

Count of the number of securities in the collection.

Return type:

int

property is_read_only

Flag indicating if the internal array is read only.

Returns:

Flag indicating if the internal array is read only.

Return type:

bool

property item

Indexer method for the security manager to access the securities objects by their symbol.

Returns:

Indexer method for the security manager to access the securities objects by their symbol.

Return type:

Security

property keys

List of the symbol-keys in the collection of securities.

Returns:

List of the symbol-keys in the collection of securities.

Return type:

ICollection[Symbol]

property total

Get a list of the complete security objects for this collection, including non active or delisted securities

Returns:

Get a list of the complete security objects for this collection, including non active or delisted securities

Return type:

ICollection[Security]

property utc_time

Gets the most recent time this manager was updated

Returns:

Gets the most recent time this manager was updated

Return type:

datetime

property values

Get a list of the security objects for this collection.

Returns:

Get a list of the security objects for this collection.

Return type:

ICollection[Security]

SecurityPortfolioManager

class QuantConnect.Securities.SecurityPortfolioManager[source]

Portfolio manager class groups popular properties and makes them accessible through one interface. It also provide indexing by the vehicle symbol to get the Security.Holding objects.

add_transaction_record(time, transaction_profit_loss, is_win)

Record the transaction value and time in a list to later be processed for statistics creation.

Parameters:
  • time (datetime)
  • transaction_profit_loss (float)
  • is_win (bool)
apply_dividend(dividend, live_mode, mode)

Applies a dividend to the portfolio

Parameters:
  • dividend (Dividend)
  • live_mode (bool)
  • mode (DataNormalizationMode)
apply_split(split, security, live_mode, mode)

Applies a split to the portfolio

Parameters:
  • split (Split)
  • security (Security)
  • live_mode (bool)
  • mode (DataNormalizationMode)
clear()

Clear the portfolio of securities objects.

contains(pair)

Check if the portfolio contains this symbol string.

Parameters:
  • pair (Dict[Symbol, SecurityHolding])
Return type:

bool

contains_key(symbol)

Check if the portfolio contains this symbol string.

Parameters:
Return type:

bool

copy()

Creates a shallow copy of the dictionary.

Return type:

PyDict

copy_to(array, index)

Copy contents of the portfolio collection to a new destination.

Parameters:
  • array (Dict`2)
  • index (int)
fromkeys(sequence, value)

Creates a new dictionary from the given sequence of elements.

Parameters:
  • sequence (Symbol)
  • value (SecurityHolding)
Return type:

PyDict

get_buying_power(symbol, direction=0)

Gets the margin available for trading a specific symbol in a specific direction. Alias for OrderDirection)

Parameters:
  • symbol (Symbol)
  • direction (OrderDirection, optional)
Return type:

float

get_margin_remaining(symbol, direction=0)

Gets the remaining margin on the account in the account's currency for the given total portfolio value

Parameters:
  • symbol (Symbol)
  • direction (OrderDirection, optional)
Return type:

float

get_margin_remaining(total_portfolio_value)

Gets the remaining margin on the account in the account's currency for the given total portfolio value

Parameters:
  • total_portfolio_value (float)
Return type:

float

has_sufficient_buying_power_for_order(orders)

Will determine if the algorithms portfolio has enough buying power to fill the given orders

Parameters:
  • orders (List[Order])
Return type:

HasSufficientBuyingPowerForOrderResult

invalidate_total_portfolio_value()

Will flag the current TotalPortfolioValue as invalid so it is recalculated when gotten

items()

Returns a view object that displays a list of dictionary's (Symbol, value) tuple pairs.

Return type:

PyList

keys()

Returns a view object that displays a list of all the Symbol objects in the dictionary

Return type:

PyList

log_margin_information(order_request=None)

Logs margin information for debugging

Parameters:
  • order_request (OrderRequest, optional)
pop(symbol, default_value)

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (SecurityHolding)
Return type:

SecurityHolding

popitem()

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Return type:

PyTuple

process_fills(fills)

Calculate the new average price after processing a list of partial/complete order fill events.

Parameters:
  • fills (List[OrderEvent])
set_account_currency(account_currency, starting_cash=None)

Sets the account currency cash symbol this algorithm is to manage, as well as the starting cash in this currency if given

Parameters:
  • account_currency (str)
  • starting_cash (float, optional)
set_cash(symbol, cash, conversion_rate)

Set the account currency cash this algorithm is to manage.

Parameters:
  • symbol (str)
  • cash (float)
  • conversion_rate (float)
set_margin_call_model(margin_call_model)

Sets the margin call model

Parameters:
  • margin_call_model (IMarginCallModel)
set_margin_call_model(py_object)

Sets the margin call model

Parameters:
  • py_object (PyObject)
set_positions(position_group_model)

Will set the security position group model to use

Parameters:
  • position_group_model (SecurityPositionGroupModel)
setdefault(symbol, default_value)

Returns the value of a Symbol (if the Symbol is in dictionary). If not, it inserts Symbol with a value to the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (SecurityHolding)
Return type:

SecurityHolding

try_get_value(symbol, holding)

Attempt to get the value of the securities holding class if this symbol exists.

Parameters:
Return type:

bool

update(other)

Updates the dictionary with the elements from the another dictionary object or from an iterable of Symbol/value pairs. The update() method adds element(s) to the dictionary if the Symbol is not in the dictionary.If the Symbol is in the dictionary, it updates the Symbol with the new value.

Parameters:
  • other (PyObject)
values()

Returns a view object that displays a list of all the values in the dictionary.

Return type:

PyList

property cash

Sum of all currencies in account in US dollars (only settled cash)

Returns:

Sum of all currencies in account in US dollars (only settled cash)

Return type:

float

property cash_book

Gets the cash book that keeps track of all currency holdings (only settled cash)

Returns:

Gets the cash book that keeps track of all currency holdings (only settled cash)

Return type:

CashBook

property count

Count the securities objects in the portfolio.

Returns:

Count the securities objects in the portfolio.

Return type:

int

property hold_stock

Boolean flag indicating we have any holdings in the portfolio.

Returns:

Boolean flag indicating we have any holdings in the portfolio.

Return type:

bool

property invested

Alias for HoldStock. Check if we have any holdings.

Returns:

Alias for HoldStock. Check if we have any holdings.

Return type:

bool

property is_read_only

Check if the underlying securities array is read only.

Returns:

Check if the underlying securities array is read only.

Return type:

bool

property item

Indexer for the PortfolioManager class to access the underlying security holdings objects.

Returns:

Indexer for the PortfolioManager class to access the underlying security holdings objects.

Return type:

SecurityHolding

property keys

Symbol keys collection of the underlying assets in the portfolio.

Returns:

Symbol keys collection of the underlying assets in the portfolio.

Return type:

ICollection[Symbol]

property margin_call_model

Gets or sets the MarginCallModel for the portfolio. This is used to executed margin call orders.

Returns:

Gets or sets the MarginCallModel for the portfolio. This is used to executed margin call orders.

Return type:

IMarginCallModel

property margin_remaining

Gets the remaining margin on the account in the account's currency

Returns:

Gets the remaining margin on the account in the account's currency

Return type:

float

property positions

Local access to the position manager

Returns:

Local access to the position manager

Return type:

SecurityPositionGroupModel

property total_absolute_holdings_cost

Gets the total absolute holdings cost of the portfolio. This sums up the individual absolute cost of each holding

Returns:

Gets the total absolute holdings cost of the portfolio. This sums up the individual absolute cost of each holding

Return type:

float

property total_fees

Total fees paid during the algorithm operation across all securities in portfolio.

Returns:

Total fees paid during the algorithm operation across all securities in portfolio.

Return type:

float

property total_holdings_value

Absolute sum the individual items in portfolio.

Returns:

Absolute sum the individual items in portfolio.

Return type:

float

property total_margin_used

Gets the total margin used across all securities in the account's currency

Returns:

Gets the total margin used across all securities in the account's currency

Return type:

float

property total_net_profit

Sum of all net profit across all securities in portfolio and dividend payments.

Returns:

Sum of all net profit across all securities in portfolio and dividend payments.

Return type:

float

property total_portfolio_value

Total portfolio value if we sold all holdings at current market rates.

Returns:

Total portfolio value if we sold all holdings at current market rates.

Return type:

float

property total_portfolio_value_less_free_buffer

Returns the adjusted total portfolio value removing the free amount If the FreePortfolioValue has not been set, the free amount will have a trailing behavior and be updated when requested

Returns:

Returns the adjusted total portfolio value removing the free amount If the FreePortfolioValue has not been set, the free amount will have a trailing behavior and be updated when requested

Return type:

float

property total_profit

Sum of all gross profit across all securities in portfolio and dividend payments.

Returns:

Sum of all gross profit across all securities in portfolio and dividend payments.

Return type:

float

property total_sale_volume

Total sale volume since the start of algorithm operations.

Returns:

Total sale volume since the start of algorithm operations.

Return type:

float

property total_unlevered_absolute_holdings_cost

Absolute value of cash discounted from our total cash by the holdings we own.

Returns:

Absolute value of cash discounted from our total cash by the holdings we own.

Return type:

float

property total_unrealised_profit

Get the total unrealised profit in our portfolio from the individual security unrealized profits.

Returns:

Get the total unrealised profit in our portfolio from the individual security unrealized profits.

Return type:

float

property total_unrealized_profit

Get the total unrealised profit in our portfolio from the individual security unrealized profits.

Returns:

Get the total unrealised profit in our portfolio from the individual security unrealized profits.

Return type:

float

property unsettled_cash

Sum of all currencies in account in US dollars (only unsettled cash)

Returns:

Sum of all currencies in account in US dollars (only unsettled cash)

Return type:

float

property unsettled_cash_book

Gets the cash book that keeps track of all currency holdings (only unsettled cash)

Returns:

Gets the cash book that keeps track of all currency holdings (only unsettled cash)

Return type:

CashBook

property values

Collection of securities objects in the portfolio.

Returns:

Collection of securities objects in the portfolio.

Return type:

ICollection[SecurityHolding]

field securities

Local access to the securities collection for the portfolio summation.

Returns:

Local access to the securities collection for the portfolio summation.

Return type:

SecurityManager

field transactions

Local access to the transactions collection for the portfolio summation and updates.

Returns:

Local access to the transactions collection for the portfolio summation and updates.

Return type:

SecurityTransactionManager

SecurityTransactionManager

class QuantConnect.Securities.SecurityTransactionManager[source]

Algorithm Transactions Manager - Recording Transactions

add_order(request)

Add an order to collection and return the unique order id or negative if an error.

Parameters:
Return type:

OrderTicket

add_transaction_record(time, transaction_profit_loss, is_win)

Record the transaction value and time in a list to later be processed for statistics creation.

Parameters:
  • time (datetime)
  • transaction_profit_loss (float)
  • is_win (bool)
cancel_open_orders(symbol, tag=None)

Cancels all open orders for all symbols

Parameters:
  • symbol (Symbol)
  • tag (str, optional)
Return type:

List[OrderTicket]

cancel_order(order_id, order_tag=None)

Added alias for RemoveOrder -

Parameters:
  • order_id (int)
  • order_tag (str, optional)
Return type:

OrderTicket

get_increment_group_order_manager_id()

Get a new group order manager id, and increment the internal counter.

Return type:

int

get_increment_order_id()

Get a new order id, and increment the internal counter.

Return type:

int

get_open_order_tickets(symbol)

Get an enumerable of open OrderTicket for the specified symbol

Parameters:
Return type:

List[OrderTicket]

get_open_order_tickets(filter)

Get an enumerable of open OrderTicket for the specified symbol

Parameters:
  • filter (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

List[OrderTicket]

get_open_orders(symbol)

Gets the remaining quantity to be filled from open orders, i.e. order size minus quantity filled

Parameters:
Return type:

List[Order]

get_open_orders(filter)

Gets the remaining quantity to be filled from open orders, i.e. order size minus quantity filled

Parameters:
  • filter (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

List[Order]

get_open_orders_remaining_quantity(filter)

Gets the remaining quantity to be filled from open orders, i.e. order size minus quantity filled

Parameters:
  • filter (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

float

get_open_orders_remaining_quantity(symbol)

Gets the remaining quantity to be filled from open orders, i.e. order size minus quantity filled

Parameters:
Return type:

float

get_order_by_id(order_id)

Get the order by its id

Parameters:
  • order_id (int)
Return type:

Order

get_order_ticket(order_id)

Gets an enumerable of OrderTicket matching the specified filter

Parameters:
  • order_id (int)
Return type:

OrderTicket

get_order_tickets(filter)

Gets an enumerable of OrderTicket matching the specified filter

Parameters:
  • filter (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

List[OrderTicket]

get_orders(filter)

Gets the order by its brokerage id

Parameters:
  • filter (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

List[Order]

get_orders_by_brokerage_id(brokerage_id)

Gets the order by its brokerage id

Parameters:
  • brokerage_id (str)
Return type:

List[Order]

process_request(request)

Processes the order request

Parameters:
  • request (OrderRequest)
Return type:

OrderTicket

remove_order(order_id, tag=None)

Remove this order from outstanding queue: user is requesting a cancel.

Parameters:
  • order_id (int)
  • tag (str, optional)
Return type:

OrderTicket

set_live_mode(is_live_mode)

Set live mode state of the algorithm

Parameters:
  • is_live_mode (bool)
set_order_id(request)

Sets the order id for the specified submit request

Parameters:
set_order_processor(order_provider)

Sets the IOrderProvider used for fetching orders for the algorithm

Parameters:
  • order_provider (IOrderProcessor)
update_order(request)

Update an order yet to be filled such as stop or limit orders.

Parameters:
  • request (UpdateOrderRequest)
Return type:

OrderTicket

wait_for_order(order_id)

Wait for a specific order to be either Filled, Invalid or Canceled

Parameters:
  • order_id (int)
Return type:

bool

property last_order_id

Get the last order id.

Returns:

Get the last order id.

Return type:

int

property losing_transactions

Trade record of profits and losses for each trade statistics calculations that are considered losing trades

Returns:

Trade record of profits and losses for each trade statistics calculations that are considered losing trades

Return type:

Dict[datetime, float]

property loss_count

Gets the number of losing transactions

Returns:

Gets the number of losing transactions

Return type:

int

property market_order_fill_timeout

Configurable timeout for market order fills

Returns:

Configurable timeout for market order fills

Return type:

timedelta

property orders_count

Gets the current number of orders that have been processed

Returns:

Gets the current number of orders that have been processed

Return type:

int

property transaction_record

Trade record of profits and losses for each trade statistics calculations

Returns:

Trade record of profits and losses for each trade statistics calculations

Return type:

Dict[datetime, float]

property utc_time

Gets the time the security information was last updated

Returns:

Gets the time the security information was last updated

Return type:

datetime

property win_count

Gets the number or winning transactions

Returns:

Gets the number or winning transactions

Return type:

int

property winning_transactions

Trade record of profits and losses for each trade statistics calculations that are considered winning trades

Returns:

Trade record of profits and losses for each trade statistics calculations that are considered winning trades

Return type:

Dict[datetime, float]

SecurityType

enum QuantConnect.SecurityType[source]

Type of tradable security / underlying asset

field BASE

Base class for all security types (0)

Returns:

Base class for all security types (0)

Return type:

SecurityType

field CFD

Contract For a Difference Security Type (6)

Returns:

Contract For a Difference Security Type (6)

Return type:

SecurityType

field COMMODITY

Commodity Security Type (3)

Returns:

Commodity Security Type (3)

Return type:

SecurityType

field CRYPTO

Cryptocurrency Security Type (7)

Returns:

Cryptocurrency Security Type (7)

Return type:

SecurityType

field CRYPTO_FUTURE

Crypto Future Type (11)

Returns:

Crypto Future Type (11)

Return type:

SecurityType

field EQUITY

US Equity Security (1)

Returns:

US Equity Security (1)

Return type:

SecurityType

field FOREX

FOREX Security (4)

Returns:

FOREX Security (4)

Return type:

SecurityType

field FUTURE

Future Security Type (5)

Returns:

Future Security Type (5)

Return type:

SecurityType

field FUTURE_OPTION

Futures Options Security Type (8)

Returns:

Futures Options Security Type (8)

Return type:

SecurityType

field INDEX

Index Security Type (9)

Returns:

Index Security Type (9)

Return type:

SecurityType

field INDEX_OPTION

Index Option Security Type (10)

Returns:

Index Option Security Type (10)

Return type:

SecurityType

field OPTION

Option Security Type (2)

Returns:

Option Security Type (2)

Return type:

SecurityType

SeriesType

enum QuantConnect.SeriesType[source]

Available types of chart series

field BAR

Bar chart (3)

Returns:

Bar chart (3)

Return type:

SeriesType

field CANDLE

Charts (2)

Returns:

Charts (2)

Return type:

SeriesType

field FLAG

Flag indicators (4)

Returns:

Flag indicators (4)

Return type:

SeriesType

field HEATMAP

Heatmap Plot (9) -- NOTE: 8 is reserved

Returns:

Heatmap Plot (9) -- NOTE: 8 is reserved

Return type:

SeriesType

field LINE

Line Plot for Value Types (0)

Returns:

Line Plot for Value Types (0)

Return type:

SeriesType

field PIE

Pie chart (6)

Returns:

Pie chart (6)

Return type:

SeriesType

field SCATTER

Scatter Plot for Chart Distinct Types (1)

Returns:

Scatter Plot for Chart Distinct Types (1)

Return type:

SeriesType

field SCATTER_3D

Scatter 3D Plot (10)

Returns:

Scatter 3D Plot (10)

Return type:

SeriesType

field STACKED_AREA

100% area chart showing relative proportions of series values at each time index (5)

Returns:

100% area chart showing relative proportions of series values at each time index (5)

Return type:

SeriesType

field TREEMAP

Treemap Plot (7)

Returns:

Treemap Plot (7)

Return type:

SeriesType

SignalExportManager

class QuantConnect.Algorithm.Framework.Portfolio.SignalExports.SignalExportManager[source]

Class manager to send portfolio targets to different 3rd party API's For example, it allows Collective2, CrunchDAO and Numerai signal export providers

add_signal_export_providers(signal_exports)

Adds one or more new signal exports providers

Parameters:
  • signal_exports (ISignalExportTarget)
set_target_portfolio(portfolio_targets)

Sets the portfolio targets from the algorihtm's Portfolio and sends them with the algorithm being ran to the signal exports providers already set

Parameters:
  • portfolio_targets (PortfolioTarget)
Return type:

bool

set_target_portfolio_from_portfolio()

Sets the portfolio targets from the algorihtm's Portfolio and sends them with the algorithm being ran to the signal exports providers already set

Return type:

bool

Slice

class QuantConnect.Data.Slice[source]

Provides a data structure for all of an algorithm's data at a single time step

clear()

Removes all keys and values from the dictionary.

contains_key(symbol)

Determines whether this instance contains data for the specified symbol

Parameters:
Return type:

bool

copy()

Creates a shallow copy of the dictionary.

Return type:

PyDict

fromkeys(sequence, value)

Creates a new dictionary from the given sequence of elements.

Parameters:
  • sequence (Symbol)
  • value (object)
Return type:

PyDict

get(symbol, value)

Returns the value for the specified Symbol if Symbol is in dictionary.

Parameters:
  • symbol (Symbol)
  • value (object)
Return type:

object

get(type)

Gets the DataDictionary`1 for all data of the specified type

Parameters:
  • type (Type)
Return type:

object

get_enumerator()

Returns an enumerator that iterates through the collection.

Return type:

IEnumerator[Dict[Symbol, BaseData]]

items()

Returns a view object that displays a list of dictionary's (Symbol, value) tuple pairs.

Return type:

PyList

keys()

Returns a view object that displays a list of all the Symbol objects in the dictionary

Return type:

PyList

merge_slice(input_slice)

Merge two slice with same Time

Parameters:
pop(symbol, default_value)

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (object)
Return type:

object

popitem()

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Return type:

PyTuple

remove(symbol)

Removes the value with the specified Symbol

Parameters:
Return type:

bool

setdefault(symbol, default_value)

Returns the value of a Symbol (if the Symbol is in dictionary). If not, it inserts Symbol with a value to the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (object)
Return type:

object

try_get_value(symbol, data)

Gets the data associated with the specified symbol

Parameters:
  • symbol (Symbol)
  • data (Object&)
Return type:

bool

update(other)

Updates the dictionary with the elements from the another dictionary object or from an iterable of Symbol/value pairs. The update() method adds element(s) to the dictionary if the Symbol is not in the dictionary.If the Symbol is in the dictionary, it updates the Symbol with the new value.

Parameters:
  • other (PyObject)
values()

Returns a view object that displays a list of all the values in the dictionary.

Return type:

PyList

property all_data

All the data hold in this slice

Returns:

All the data hold in this slice

Return type:

List[BaseData]

property bars

Gets the TradeBars for this slice of data

Returns:

Gets the TradeBars for this slice of data

Return type:

TradeBars

property count

Gets the number of symbols held in this slice

Returns:

Gets the number of symbols held in this slice

Return type:

int

property delistings

Gets the Delistings for this slice of data

Returns:

Gets the Delistings for this slice of data

Return type:

Delistings

property dividends

Gets the Dividends for this slice of data

Returns:

Gets the Dividends for this slice of data

Return type:

Dividends

property future_chains

Gets the FuturesChains for this slice of data

Returns:

Gets the FuturesChains for this slice of data

Return type:

FuturesChains

property futures_chains

Gets the FuturesChains for this slice of data

Returns:

Gets the FuturesChains for this slice of data

Return type:

FuturesChains

property has_data

Gets whether or not this slice has data

Returns:

Gets whether or not this slice has data

Return type:

bool

property is_read_only

Gets a value indicating whether the IDictionary object is read-only.

Returns:

Gets a value indicating whether the IDictionary object is read-only.

Return type:

bool

property item

Gets the data corresponding to the specified symbol. If the requested data is of Tick, then a will be returned, otherwise, it will be the subscribed type, for example, or event for custom data.

Returns:

Gets the data corresponding to the specified symbol. If the requested data is of Tick, then a will be returned, otherwise, it will be the subscribed type, for example, or event for custom data.

Return type:

object

property keys

Gets all the symbols in this slice

Returns:

Gets all the symbols in this slice

Return type:

IReadOnlyList[Symbol]

property margin_interest_rates

Gets the MarginInterestRates for this slice of data

Returns:

Gets the MarginInterestRates for this slice of data

Return type:

MarginInterestRates

property option_chains

Gets the OptionChains for this slice of data

Returns:

Gets the OptionChains for this slice of data

Return type:

OptionChains

property quote_bars

Gets the QuoteBars for this slice of data

Returns:

Gets the QuoteBars for this slice of data

Return type:

QuoteBars

property splits

Gets the Splits for this slice of data

Returns:

Gets the Splits for this slice of data

Return type:

Splits

property symbol_changed_events

Gets the SymbolChangedEvents for this slice of data

Returns:

Gets the SymbolChangedEvents for this slice of data

Return type:

SymbolChangedEvents

property ticks

Gets the Ticks for this slice of data

Returns:

Gets the Ticks for this slice of data

Return type:

Ticks

property time

Gets the timestamp for this slice of data

Returns:

Gets the timestamp for this slice of data

Return type:

datetime

property utc_time

Gets the timestamp for this slice of data in UTC

Returns:

Gets the timestamp for this slice of data in UTC

Return type:

datetime

property values

Gets a list of all the data in this slice

Returns:

Gets a list of all the data in this slice

Return type:

IReadOnlyList[BaseData]

Splits

class QuantConnect.Data.Market.Splits[source]

Collection of splits keyed by Symbol

add(key, value)

Adds an item to the list.

Parameters:
add(item)

Adds an item to the list.

Parameters:
  • item (Dict[Symbol, Split])
clear()

Removes all keys and values from the dictionary.

contains(item)

Determines whether the list contains a specific value.

Parameters:
  • item (Dict[Symbol, Split])
Return type:

bool

contains_key(key)

Determines whether the dictionary contains an element with the specified key.

Parameters:
Return type:

bool

copy()

Creates a shallow copy of the dictionary.

Return type:

PyDict

copy_to(array, array_index)

Copies the elements of the list to an , starting at a particular index.

Parameters:
  • array (Dict`2)
  • array_index (int)
fromkeys(sequence, value)

Creates a new dictionary from the given sequence of elements.

Parameters:
  • sequence (Symbol)
  • value (Split)
Return type:

PyDict

get(symbol, value)

Returns the value for the specified Symbol if Symbol is in dictionary.

Parameters:
  • symbol (Symbol)
  • value (Split)
Return type:

Split

get_enumerator()

Returns an enumerator that iterates through the collection.

Return type:

IEnumerator[Dict[Symbol, Split]]

get_value(key)

Gets the value associated with the specified key.

Parameters:
Return type:

Split

items()

Returns a view object that displays a list of dictionary's (Symbol, value) tuple pairs.

Return type:

PyList

keys()

Returns a view object that displays a list of all the Symbol objects in the dictionary

Return type:

PyList

pop(symbol, default_value)

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (Split)
Return type:

Split

popitem()

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Return type:

PyTuple

remove(item)

Removes the first occurrence of a specific object from the list.

Parameters:
  • item (Dict[Symbol, Split])
Return type:

bool

remove(key)

Removes the first occurrence of a specific object from the list.

Parameters:
Return type:

bool

setdefault(symbol, default_value)

Returns the value of a Symbol (if the Symbol is in dictionary). If not, it inserts Symbol with a value to the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (Split)
Return type:

Split

try_get_value(key, value)

Gets the value associated with the specified key.

Parameters:
Return type:

bool

update(other)

Updates the dictionary with the elements from the another dictionary object or from an iterable of Symbol/value pairs. The update() method adds element(s) to the dictionary if the Symbol is not in the dictionary.If the Symbol is in the dictionary, it updates the Symbol with the new value.

Parameters:
  • other (PyObject)
values()

Returns a view object that displays a list of all the values in the dictionary.

Return type:

PyList

property count

Gets the number of elements contained in the list.

Returns:

Gets the number of elements contained in the list.

Return type:

int

property is_read_only

Gets a value indicating whether the list is read-only.

Returns:

Gets a value indicating whether the list is read-only.

Return type:

bool

property item

Gets or sets the Split with the specified ticker.

Returns:

Gets or sets the Split with the specified ticker.

Return type:

Split

property keys

Gets a list containing the keys of the .

Returns:

Gets a list containing the keys of the .

Return type:

ICollection[Symbol]

property time

Gets or sets the time associated with this collection of data

Returns:

Gets or sets the time associated with this collection of data

Return type:

datetime

property values

Gets a list containing the values in the .

Returns:

Gets a list containing the values in the .

Return type:

ICollection[Split]

StatisticsResults

class QuantConnect.Statistics.StatisticsResults[source]

The StatisticsResults class represents total and rolling statistics for an algorithm

property rolling_performances

The rolling performance of the algorithm over 1, 3, 6, 12 month periods

Returns:

The rolling performance of the algorithm over 1, 3, 6, 12 month periods

Return type:

Dict[str, AlgorithmPerformance]

property summary

Returns a summary of the algorithm performance as a dictionary

Returns:

Returns a summary of the algorithm performance as a dictionary

Return type:

Dict[str, str]

property total_performance

The performance of the algorithm over the whole period

Returns:

The performance of the algorithm over the whole period

Return type:

AlgorithmPerformance

SubmitOrderRequest

class QuantConnect.Orders.SubmitOrderRequest[source]

Defines a request to submit a new order

set_response(response, status=3)

Sets the Response for this request

Parameters:
  • response (OrderResponse)
  • status (OrderRequestStatus, optional)
property group_order_manager

Gets the manager for the combo order. If null, the order is not a combo order.

Returns:

Gets the manager for the combo order. If null, the order is not a combo order.

Return type:

GroupOrderManager

property limit_price

Gets the limit price of the order, zero if not a limit order

Returns:

Gets the limit price of the order, zero if not a limit order

Return type:

float

property order_id

Gets the order id the request acts on

Returns:

Gets the order id the request acts on

Return type:

int

property order_properties

Gets the order properties for this request

Returns:

Gets the order properties for this request

Return type:

IOrderProperties

property order_request_type

Gets Submit

Returns:

Gets Submit

Return type:

OrderRequestType

property order_type

Gets the order type od the order

Returns:

Gets the order type od the order

Return type:

OrderType

property quantity

Gets the quantity of the order

Returns:

Gets the quantity of the order

Return type:

float

property response

Gets the response for this request. If this request was never processed then this will equal Unprocessed. This value is never equal to null.

Returns:

Gets the response for this request. If this request was never processed then this will equal Unprocessed. This value is never equal to null.

Return type:

OrderResponse

property security_type

Gets the security type of the symbol

Returns:

Gets the security type of the symbol

Return type:

SecurityType

property status

Gets the status of this request

Returns:

Gets the status of this request

Return type:

OrderRequestStatus

property stop_price

Gets the stop price of the order, zero if not a stop order

Returns:

Gets the stop price of the order, zero if not a stop order

Return type:

float

property symbol

Gets the symbol to be traded

Returns:

Gets the symbol to be traded

Return type:

Symbol

property tag

Gets a tag for this request

Returns:

Gets a tag for this request

Return type:

str

property time

Gets the UTC time the request was created

Returns:

Gets the UTC time the request was created

Return type:

datetime

property trailing_amount

Trailing amount for a trailing stop order

Returns:

Trailing amount for a trailing stop order

Return type:

float

property trailing_as_percentage

Determines whether the TrailingAmount is a percentage or an absolute currency value

Returns:

Determines whether the TrailingAmount is a percentage or an absolute currency value

Return type:

bool

property trigger_price

Price which must first be reached before a limit order can be submitted.

Returns:

Price which must first be reached before a limit order can be submitted.

Return type:

float

SubscriptionManager

class QuantConnect.Data.SubscriptionManager[source]

Enumerable Subscription Management Class

add(data_type, tick_type, symbol, resolution, data_time_zone, exchange_time_zone, is_custom_data, fill_forward=True, extended_market_hours=False, is_internal_feed=False, is_filtered_subscription=True, data_normalization_mode=1)

Add Market Data Required (Overloaded method for backwards compatibility).

Parameters:
  • data_type (Type)
  • tick_type (TickType)
  • symbol (Symbol)
  • resolution (Resolution)
  • data_time_zone (datetimeZone)
  • exchange_time_zone (datetimeZone)
  • is_custom_data (bool)
  • fill_forward (bool, optional)
  • extended_market_hours (bool, optional)
  • is_internal_feed (bool, optional)
  • is_filtered_subscription (bool, optional)
  • data_normalization_mode (DataNormalizationMode, optional)
Return type:

SubscriptionDataConfig

add(symbol, resolution, time_zone, exchange_time_zone, is_custom_data=False, fill_forward=True, extended_market_hours=False)

Add Market Data Required (Overloaded method for backwards compatibility).

Parameters:
  • symbol (Symbol)
  • resolution (Resolution)
  • time_zone (datetimeZone)
  • exchange_time_zone (datetimeZone)
  • is_custom_data (bool, optional)
  • fill_forward (bool, optional)
  • extended_market_hours (bool, optional)
Return type:

SubscriptionDataConfig

add_consolidator(symbol, consolidator, tick_type=None)

Add a consolidator for the symbol

Parameters:
  • symbol (Symbol)
  • consolidator (IDataConsolidator)
  • tick_type (TickType, optional)
add_consolidator(symbol, py_consolidator)

Add a consolidator for the symbol

Parameters:
  • symbol (Symbol)
  • py_consolidator (PyObject)
get_data_types_for_security(security_type)

Get the available data types for a security

Parameters:
Return type:

IReadOnlyList[TickType]

lookup_subscription_config_data_types(symbol_security_type, resolution, is_canonical)

Get the data feed types for a given SecurityType

Parameters:
Return type:

List[Tuple[Type, TickType]]

remove_consolidator(symbol, consolidator)

Removes the specified consolidator for the symbol

Parameters:
  • symbol (Symbol)
  • consolidator (IDataConsolidator)
scan_past_consolidators(new_utc_time, algorithm)

Will trigger past consolidator scans

Parameters:
  • new_utc_time (datetime)
  • algorithm (IAlgorithm)
set_data_manager(subscription_manager)

Sets the Subscription Manager

Parameters:
  • subscription_manager (IAlgorithmSubscriptionManager)
property available_data_types

The different TickType each supports

Returns:

The different TickType each supports

Return type:

Dict[SecurityType, List[TickType]]

property count

Get the count of assets:

Returns:

Get the count of assets:

Return type:

int

property subscription_data_config_service

Instance that implements ISubscriptionDataConfigService

Returns:

Instance that implements ISubscriptionDataConfigService

Return type:

ISubscriptionDataConfigService

property subscriptions

Returns an IEnumerable of Subscriptions

Returns:

Returns an IEnumerable of Subscriptions

Return type:

List[SubscriptionDataConfig]

Symbol

class QuantConnect.Symbol[source]

Represents a unique security identifier. This is made of two components, the unique SID and the Value. The value is the current ticker symbol while the SID is constant over the life of a security

has_canonical()

Determines whether the symbol has a canonical representation

Return type:

bool

has_underlying_symbol(symbol)

Determines if the specified symbol is an underlying of this symbol instance

Parameters:
Return type:

bool

is_canonical()

Method returns true, if symbol is a derivative canonical symbol

Return type:

bool

update_mapped_symbol(mapped_symbol, contract_depth_offset=0)

Creates new symbol with updated mapped symbol. Symbol Mapping: When symbols change over time (e.g. CHASE-> JPM) need to update the symbol requested. Method returns newly created symbol

Parameters:
  • mapped_symbol (str)
  • contract_depth_offset (int, optional)
Return type:

Symbol

property canonical

Get's the canonical representation of this symbol

Returns:

Get's the canonical representation of this symbol

Return type:

Symbol

property cik

The Central Index Key number (CIK) corresponding to this Symbol

Returns:

The Central Index Key number (CIK) corresponding to this Symbol

Return type:

int

property composite_figi

The composite Financial Instrument Global Identifier (FIGI) corresponding to this Symbol

Returns:

The composite Financial Instrument Global Identifier (FIGI) corresponding to this Symbol

Return type:

str

property cusip

The Committee on Uniform Securities Identification Procedures (CUSIP) number corresponding to this Symbol

Returns:

The Committee on Uniform Securities Identification Procedures (CUSIP) number corresponding to this Symbol

Return type:

str

property has_underlying

Gets whether or not this Symbol is a derivative, that is, it has a valid property

Returns:

Gets whether or not this Symbol is a derivative, that is, it has a valid property

Return type:

bool

property id

Gets the security identifier for this symbol

Returns:

Gets the security identifier for this symbol

Return type:

SecurityIdentifier

property isin

The International Securities Identification Number (ISIN) corresponding to this Symbol

Returns:

The International Securities Identification Number (ISIN) corresponding to this Symbol

Return type:

str

property security_type

Gets the security type of the symbol

Returns:

Gets the security type of the symbol

Return type:

SecurityType

property sedol

The Stock Exchange Daily Official List (SEDOL) security identifier corresponding to this Symbol

Returns:

The Stock Exchange Daily Official List (SEDOL) security identifier corresponding to this Symbol

Return type:

str

property underlying

Gets the security underlying symbol, if any

Returns:

Gets the security underlying symbol, if any

Return type:

Symbol

property value

Gets the current symbol for this ticker

Returns:

Gets the current symbol for this ticker

Return type:

str

field EMPTY

Represents an unassigned symbol. This is intended to be used as an uninitialized, default value

Returns:

Represents an unassigned symbol. This is intended to be used as an uninitialized, default value

Return type:

Symbol

field NONE

Represents no symbol. This is intended to be used when no symbol is explicitly intended

Returns:

Represents no symbol. This is intended to be used when no symbol is explicitly intended

Return type:

Symbol

SymbolChangedEvents

class QuantConnect.Data.Market.SymbolChangedEvents[source]

Collection of SymbolChangedEvent keyed by the original, requested symbol

add(key, value)

Adds an item to the list.

Parameters:
  • key (Symbol)
  • value (SymbolChangedEvent)
add(item)

Adds an item to the list.

Parameters:
  • item (Dict[Symbol, SymbolChangedEvent])
clear()

Removes all keys and values from the dictionary.

contains(item)

Determines whether the list contains a specific value.

Parameters:
  • item (Dict[Symbol, SymbolChangedEvent])
Return type:

bool

contains_key(key)

Determines whether the dictionary contains an element with the specified key.

Parameters:
Return type:

bool

copy()

Creates a shallow copy of the dictionary.

Return type:

PyDict

copy_to(array, array_index)

Copies the elements of the list to an , starting at a particular index.

Parameters:
  • array (Dict`2)
  • array_index (int)
fromkeys(sequence, value)

Creates a new dictionary from the given sequence of elements.

Parameters:
  • sequence (Symbol)
  • value (SymbolChangedEvent)
Return type:

PyDict

get(symbol, value)

Returns the value for the specified Symbol if Symbol is in dictionary.

Parameters:
  • symbol (Symbol)
  • value (SymbolChangedEvent)
Return type:

SymbolChangedEvent

get_enumerator()

Returns an enumerator that iterates through the collection.

Return type:

IEnumerator[Dict[Symbol, SymbolChangedEvent]]

get_value(key)

Gets the value associated with the specified key.

Parameters:
Return type:

SymbolChangedEvent

items()

Returns a view object that displays a list of dictionary's (Symbol, value) tuple pairs.

Return type:

PyList

keys()

Returns a view object that displays a list of all the Symbol objects in the dictionary

Return type:

PyList

pop(symbol, default_value)

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (SymbolChangedEvent)
Return type:

SymbolChangedEvent

popitem()

Returns and removes an arbitrary element (Symbol, value) pair from the dictionary.

Return type:

PyTuple

remove(item)

Removes the first occurrence of a specific object from the list.

Parameters:
  • item (Dict[Symbol, SymbolChangedEvent])
Return type:

bool

remove(key)

Removes the first occurrence of a specific object from the list.

Parameters:
Return type:

bool

setdefault(symbol, default_value)

Returns the value of a Symbol (if the Symbol is in dictionary). If not, it inserts Symbol with a value to the dictionary.

Parameters:
  • symbol (Symbol)
  • default_value (SymbolChangedEvent)
Return type:

SymbolChangedEvent

try_get_value(key, value)

Gets the value associated with the specified key.

Parameters:
Return type:

bool

update(other)

Updates the dictionary with the elements from the another dictionary object or from an iterable of Symbol/value pairs. The update() method adds element(s) to the dictionary if the Symbol is not in the dictionary.If the Symbol is in the dictionary, it updates the Symbol with the new value.

Parameters:
  • other (PyObject)
values()

Returns a view object that displays a list of all the values in the dictionary.

Return type:

PyList

property count

Gets the number of elements contained in the list.

Returns:

Gets the number of elements contained in the list.

Return type:

int

property is_read_only

Gets a value indicating whether the list is read-only.

Returns:

Gets a value indicating whether the list is read-only.

Return type:

bool

property item

Gets or sets the SymbolChangedEvent with the specified ticker.

Returns:

Gets or sets the SymbolChangedEvent with the specified ticker.

Return type:

SymbolChangedEvent

property keys

Gets a list containing the keys of the .

Returns:

Gets a list containing the keys of the .

Return type:

ICollection[Symbol]

property time

Gets or sets the time associated with this collection of data

Returns:

Gets or sets the time associated with this collection of data

Return type:

datetime

property values

Gets a list containing the values in the .

Returns:

Gets a list containing the values in the .

Return type:

ICollection[SymbolChangedEvent]

SymbolProperties

class QuantConnect.Securities.SymbolProperties[source]

Represents common properties for a specific security, uniquely identified by market, symbol and security type

property contract_multiplier

The contract multiplier for the security

Returns:

The contract multiplier for the security

Return type:

float

property description

The description of the security

Returns:

The description of the security

Return type:

str

property lot_size

The lot size (lot size of the order) for the security

Returns:

The lot size (lot size of the order) for the security

Return type:

float

property market_ticker

The market ticker

Returns:

The market ticker

Return type:

str

property minimum_order_size

The minimum order size allowed For crypto/forex pairs it's expected to be expressed in base or quote currency i.e For BTC/USD the minimum order size allowed with Coinbase is 0.0001 BTC while on Binance the minimum order size allowed is 10 USD

Returns:

The minimum order size allowed For crypto/forex pairs it's expected to be expressed in base or quote currency i.e For BTC/USD the minimum order size allowed with Coinbase is 0.0001 BTC while on Binance the minimum order size allowed is 10 USD

Return type:

float

property minimum_price_variation

The minimum price variation (tick size) for the security

Returns:

The minimum price variation (tick size) for the security

Return type:

float

property price_magnifier

Allows normalizing live asset prices to US Dollars for Lean consumption. In some exchanges, for some securities, data is expressed in cents like for example for corn futures ('ZC').

Returns:

Allows normalizing live asset prices to US Dollars for Lean consumption. In some exchanges, for some securities, data is expressed in cents like for example for corn futures ('ZC').

Return type:

float

property quote_currency

The quote currency of the security

Returns:

The quote currency of the security

Return type:

str

property strike_multiplier

Scale factor for option's strike price. For some options, such as NQX, the strike price is based on a fraction of the underlying, thus this paramater scales the strike price so that it can be used in comparation with the underlying such as in Int32)

Returns:

Scale factor for option's strike price. For some options, such as NQX, the strike price is based on a fraction of the underlying, thus this paramater scales the strike price so that it can be used in comparation with the underlying such as in Int32)

Return type:

float

TimeRules

class QuantConnect.Scheduling.TimeRules[source]

Helper class used to provide better syntax when defining time rules

after_market_open(symbol, minutes_after_open=0.0, extended_market_open=False)

Specifies an event should fire at market open +- minutesAfterOpen

Parameters:
  • symbol (Symbol)
  • minutes_after_open (float, optional)
  • extended_market_open (bool, optional)
Return type:

ITimeRule

at(hour, minute, second, time_zone)

Specifies an event should fire at the specified time of day in the algorithm's time zone

Parameters:
  • hour (int)
  • minute (int)
  • second (int)
  • time_zone (datetimeZone)
Return type:

ITimeRule

at(time_of_day, time_zone)

Specifies an event should fire at the specified time of day in the algorithm's time zone

Parameters:
  • time_of_day (timedelta)
  • time_zone (datetimeZone)
Return type:

ITimeRule

before_market_close(symbol, minutes_before_close=0.0, extended_market_close=False)

Specifies an event should fire at the market close +- minutesBeforeClose

Parameters:
  • symbol (Symbol)
  • minutes_before_close (float, optional)
  • extended_market_close (bool, optional)
Return type:

ITimeRule

every(interval)

Specifies an event should fire periodically on the requested interval

Parameters:
  • interval (timedelta)
Return type:

ITimeRule

set_default_time_zone(time_zone)

Sets the default time zone

Parameters:
  • time_zone (datetimeZone)
property midnight

Convenience property for running a scheduled event at midnight in the algorithm time zone

Returns:

Convenience property for running a scheduled event at midnight in the algorithm time zone

Return type:

ITimeRule

property noon

Convenience property for running a scheduled event at noon in the algorithm time zone

Returns:

Convenience property for running a scheduled event at noon in the algorithm time zone

Return type:

ITimeRule

property now

Specifies an event should fire at the current time

Returns:

Specifies an event should fire at the current time

Return type:

ITimeRule

TradeBar

class QuantConnect.Data.Market.TradeBar[source]

TradeBar class for second and minute resolution data: An OHLC implementation of the QuantConnect BaseData class with parameters for candles.

clone(fill_forward)

Return a new instance clone of this object, used in fill forward

Parameters:
  • fill_forward (bool)
Return type:

BaseData

data_time_zone()

Specifies the data time zone for this data type. This is useful for custom data types

Return type:

datetimeZone

default_resolution()

Gets the default resolution for this data and security type

Return type:

Resolution

get_source(config, date, is_live_mode)

Get Source for Custom Data File >> What source file location would you prefer for each type of usage:

Parameters:
  • config (SubscriptionDataConfig)
  • date (datetime)
  • is_live_mode (bool)
Return type:

SubscriptionDataSource

is_sparse_data()

Indicates that the data set is expected to be sparse

Return type:

bool

reader(config, line, date, is_live_mode)

TradeBar Reader: Fetch the data from the QC storage and feed it line by line into the engine.

Parameters:
  • config (SubscriptionDataConfig)
  • line (str)
  • date (datetime)
  • is_live_mode (bool)
Return type:

BaseData

reader(config, stream, date, is_live_mode)

TradeBar Reader: Fetch the data from the QC storage and feed it line by line into the engine.

Parameters:
  • config (SubscriptionDataConfig)
  • stream (StreamReader)
  • date (datetime)
  • is_live_mode (bool)
Return type:

BaseData

requires_mapping()

Indicates if there is support for mapping

Return type:

bool

should_cache_to_security()

Indicates whether this contains data that should be stored in the security cache

Return type:

bool

supported_resolutions()

Gets the supported resolution for this data and security type

Return type:

List[Resolution]

update(last_trade, bid_price, ask_price, volume, bid_size, ask_size)

Update the tradebar - build the bar from this pricing information:

Parameters:
  • last_trade (float)
  • bid_price (float)
  • ask_price (float)
  • volume (float)
  • bid_size (float)
  • ask_size (float)
update_ask(ask_price, ask_size)

Updates this base data with the new quote ask information

Parameters:
  • ask_price (float)
  • ask_size (float)
update_bid(bid_price, bid_size)

Updates this base data with the new quote bid information

Parameters:
  • bid_price (float)
  • bid_size (float)
update_quote(bid_price, bid_size, ask_price, ask_size)

Updates this base data with new quote information

Parameters:
  • bid_price (float)
  • bid_size (float)
  • ask_price (float)
  • ask_size (float)
update_trade(last_trade, trade_size)

Updates this base data with a new trade

Parameters:
  • last_trade (float)
  • trade_size (float)
property close

Closing price of the TradeBar. Defined as the price at Start Time + TimeSpan.

Returns:

Closing price of the TradeBar. Defined as the price at Start Time + TimeSpan.

Return type:

float

property data_type

Market Data Type of this data - does it come in individual price packets or is it grouped into OHLC.

Returns:

Market Data Type of this data - does it come in individual price packets or is it grouped into OHLC.

Return type:

MarketDataType

property end_time

The closing time of this bar, computed via the Time and Period

Returns:

The closing time of this bar, computed via the Time and Period

Return type:

datetime

property high

High price of the TradeBar during the time period.

Returns:

High price of the TradeBar during the time period.

Return type:

float

property is_fill_forward

True if this is a fill forward piece of data

Returns:

True if this is a fill forward piece of data

Return type:

bool

property low

Low price of the TradeBar during the time period.

Returns:

Low price of the TradeBar during the time period.

Return type:

float

property open

Opening price of the bar: Defined as the price at the start of the time period.

Returns:

Opening price of the bar: Defined as the price at the start of the time period.

Return type:

float

property period

The period of this trade bar, (second, minute, daily, ect...)

Returns:

The period of this trade bar, (second, minute, daily, ect...)

Return type:

timedelta

property price

As this is a backtesting platform we'll provide an alias of value as price.

Returns:

As this is a backtesting platform we'll provide an alias of value as price.

Return type:

float

property symbol

Symbol representation for underlying Security

Returns:

Symbol representation for underlying Security

Return type:

Symbol

property time

Current time marker of this data packet.

Returns:

Current time marker of this data packet.

Return type:

datetime

property value

Value representation of this data packet. All data requires a representative value for this moment in time. For streams of data this is the price now, for OHLC packets this is the closing price.

Returns:

Value representation of this data packet. All data requires a representative value for this moment in time. For streams of data this is the price now, for OHLC packets this is the closing price.

Return type:

float

property volume

Volume:

Returns:

Volume:

Return type:

float

TradingCalendar

class QuantConnect.TradingCalendar[source]

Class represents trading calendar, populated with variety of events relevant to currently trading instruments

get_days_by_type(type, start, end)

Method returns TradingDay of the specified type () that contains trading events associated with the range of dates

Parameters:
  • type (TradingDayType)
  • start (datetime)
  • end (datetime)
Return type:

List[TradingDay]

get_trading_day(day)

Method returns TradingDay that contains trading events associated with today's date

Parameters:
  • day (datetime)
Return type:

TradingDay

get_trading_days(start, end)

Method returns TradingDay that contains trading events associated with the range of dates

Parameters:
  • start (datetime)
  • end (datetime)
Return type:

List[TradingDay]

Universe

class QuantConnect.Data.UniverseSelection.Universe[source]

Provides a base class for all universes to derive from.

can_remove_member(utc_time, security)

Determines whether or not the specified security can be removed from this universe. This is useful to prevent securities from being taken out of a universe before the algorithm has had enough time to make decisions on the security

Parameters:
  • utc_time (datetime)
  • security (Security)
Return type:

bool

contains_member(symbol)

Determines whether or not the specified symbol is currently a member of this universe

Parameters:
Return type:

bool

dispose()

Marks this universe as disposed and ready to remove all child subscriptions

get_subscription_requests(security, current_time_utc, maximum_end_time_utc, subscription_service)

Gets the subscription requests to be added for the specified security

Parameters:
  • security (Security)
  • current_time_utc (datetime)
  • maximum_end_time_utc (datetime)
  • subscription_service (ISubscriptionDataConfigService)
Return type:

List[SubscriptionRequest]

perform_selection(utc_time, data)

Performs universe selection using the data specified

Parameters:
  • utc_time (datetime)
  • data (BaseDataCollection)
Return type:

List[Symbol]

select_symbols(utc_time, data)

Performs universe selection using the data specified

Parameters:
  • utc_time (datetime)
  • data (BaseDataCollection)
Return type:

List[Symbol]

property asynchronous

True if this universe filter can run async in the data stack

Returns:

True if this universe filter can run async in the data stack

Return type:

bool

property configuration

Gets the configuration used to get universe data

Returns:

Gets the configuration used to get universe data

Return type:

SubscriptionDataConfig

property data_type

Gets the data type of this universe

Returns:

Gets the data type of this universe

Return type:

Type

property dispose_requested

Flag indicating if disposal of this universe has been requested

Returns:

Flag indicating if disposal of this universe has been requested

Return type:

bool

property market

Gets the market of this universe

Returns:

Gets the market of this universe

Return type:

str

property members

Gets the current listing of members in this universe. Modifications to this dictionary do not change universe membership.

Returns:

Gets the current listing of members in this universe. Modifications to this dictionary do not change universe membership.

Return type:

Dict[Symbol, Security]

property securities

Gets the internal security collection used to define membership in this universe

Returns:

Gets the internal security collection used to define membership in this universe

Return type:

ConcurrentDict[Symbol, Member]

property security_type

Gets the security type of this universe

Returns:

Gets the security type of this universe

Return type:

SecurityType

property selected

The currently selected symbol set

Returns:

The currently selected symbol set

Return type:

HashSet[Symbol]

property symbol

Gets the symbol of this universe

Returns:

Gets the symbol of this universe

Return type:

Symbol

property universe_settings

Gets the settings used for subscriptions added for this universe

Returns:

Gets the settings used for subscriptions added for this universe

Return type:

UniverseSettings

field UNCHANGED

Gets a value indicating that no change to the universe should be made

Returns:

Gets a value indicating that no change to the universe should be made

Return type:

Universe+UnchangedUniverse

UniverseDefinitions

class QuantConnect.Algorithm.UniverseDefinitions[source]

Provides helpers for defining universes in algorithms

etf(etf_ticker, market, universe_settings, universe_filter_func)

Creates a universe for the constituents of the provided etfTicker

Parameters:
  • etf_ticker (str)
  • market (str)
  • universe_settings (UniverseSettings)
  • universe_filter_func (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

Universe

etf(symbol, universe_settings, universe_filter_func)

Creates a universe for the constituents of the provided etfTicker

Parameters:
  • symbol (Symbol)
  • universe_settings (UniverseSettings)
  • universe_filter_func (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

Universe

index(index_ticker, market, universe_settings, universe_filter_func)

Creates a universe for the constituents of the provided indexTicker

Parameters:
  • index_ticker (str)
  • market (str)
  • universe_settings (UniverseSettings)
  • universe_filter_func (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

Universe

index(index_symbol, universe_settings, universe_filter_func)

Creates a universe for the constituents of the provided indexTicker

Parameters:
  • index_symbol (Symbol)
  • universe_settings (UniverseSettings)
  • universe_filter_func (PyObject | 0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]])
Return type:

Universe

top(count, universe_settings=None)

Creates a new coarse universe that contains the top count of stocks by daily dollar volume

Parameters:
Return type:

Universe

property dollar_volume

Gets a helper that provides methods for creating universes based on daily dollar volumes

Returns:

Gets a helper that provides methods for creating universes based on daily dollar volumes

Return type:

DollarVolumeUniverseDefinitions

property qc_500

Creates a new fine universe that contains the constituents of QC500 index based onthe company fundamentals The algorithm creates a default tradable and liquid universe containing 500 US equities which are chosen at the first trading day of each month.

Returns:

Creates a new fine universe that contains the constituents of QC500 index based onthe company fundamentals The algorithm creates a default tradable and liquid universe containing 500 US equities which are chosen at the first trading day of each month.

Return type:

Universe

property unchanged

Specifies that universe selection should not make changes on this iteration

Returns:

Specifies that universe selection should not make changes on this iteration

Return type:

Universe+UnchangedUniverse

UniverseManager

class QuantConnect.Securities.UniverseManager[source]

Manages the algorithm's collection of universes

clear()

Removes all items from the list.

contains(item)

Determines whether the list contains a specific value.

Parameters:
  • item (Dict[Symbol, Universe])
Return type:

bool

contains_key(key)

Determines whether the dictionary contains an element with the specified key.

Parameters:
Return type:

bool

copy_to(array, array_index)

Copies the elements of the list to an , starting at a particular index.

Parameters:
  • array (Dict`2)
  • array_index (int)
get_enumerator()

Returns an enumerator that iterates through the collection.

Return type:

IEnumerator[Dict[Symbol, Universe]]

process_changes()

Will trigger collection changed event if required

try_get_value(key, value)

Gets the value associated with the specified key.

Parameters:
Return type:

bool

property active_securities

Read-only dictionary containing all active securities. An active security is a security that is currently selected by the universe or has holdings or open orders.

Returns:

Read-only dictionary containing all active securities. An active security is a security that is currently selected by the universe or has holdings or open orders.

Return type:

IReadOnlyDict[Symbol, Security]

property count

Gets the number of elements contained in the list.

Returns:

Gets the number of elements contained in the list.

Return type:

int

property is_read_only

Gets a value indicating whether the list is read-only.

Returns:

Gets a value indicating whether the list is read-only.

Return type:

bool

property item

Gets or sets the element with the specified key.

Returns:

Gets or sets the element with the specified key.

Return type:

Universe

property keys

Gets a list containing the keys of the .

Returns:

Gets a list containing the keys of the .

Return type:

ICollection[Symbol]

property values

Gets a list containing the values in the .

Returns:

Gets a list containing the values in the .

Return type:

ICollection[Universe]

UniverseSettings

class QuantConnect.Data.UniverseSelection.UniverseSettings[source]

Defines settings required when adding a subscription

field asynchronous

True if universe selection can run asynchronous

Returns:

True if universe selection can run asynchronous

Return type:

bool

field contract_depth_offset

The continuous contract desired offset from the current front month. For example, 0 (default) will use the front month, 1 will use the back month contra

Returns:

The continuous contract desired offset from the current front month. For example, 0 (default) will use the front month, 1 will use the back month contra

Return type:

int

field data_mapping_mode

Defines how universe data is mapped together

Returns:

Defines how universe data is mapped together

Return type:

DataMappingMode

field data_normalization_mode

Defines how universe data is normalized before being send into the algorithm

Returns:

Defines how universe data is normalized before being send into the algorithm

Return type:

DataNormalizationMode

field extended_market_hours

True to allow extended market hours data, false otherwise

Returns:

True to allow extended market hours data, false otherwise

Return type:

bool

field fill_forward

True to fill data forward, false otherwise

Returns:

True to fill data forward, false otherwise

Return type:

bool

field leverage

The leverage to be used

Returns:

The leverage to be used

Return type:

float

field minimum_time_in_universe

Defines the minimum amount of time a security must be in the universe before being removed.

Returns:

Defines the minimum amount of time a security must be in the universe before being removed.

Return type:

timedelta

field resolution

The resolution to be used

Returns:

The resolution to be used

Return type:

Resolution

field schedule

If configured, will be used to determine universe selection schedule and filter or skip selection data that does not fit the schedule

Returns:

If configured, will be used to determine universe selection schedule and filter or skip selection data that does not fit the schedule

Return type:

Schedule

field subscription_data_types

Allows a universe to specify which data types to add for a selected symbol

Returns:

Allows a universe to specify which data types to add for a selected symbol

Return type:

List[Tuple[Type, TickType]]

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

Did you find this page helpful?

Contribute to the documentation: