/* * QUANTCONNECT.COM - Democratizing Finance, Empowering Individuals. * Lean Algorithmic Trading Engine v2.0. Copyright 2014 QuantConnect Corporation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ using System; using QuantConnect.Data; using QuantConnect.Orders.Fees; using QuantConnect.Orders.Fills; using QuantConnect.Orders.Slippage; using QuantConnect.Util; namespace QuantConnect.Securities.Forex { /// /// FOREX Security Object Implementation for FOREX Assets /// /// public class Forex : Security, IBaseCurrencySymbol { /// /// Gets the currency acquired by going long this currency pair /// /// /// For example, the EUR/USD has a base currency of the euro, and as a result /// of going long the EUR/USD a trader is acquiring euros in exchange for US dollars /// public Cash BaseCurrency { get; protected set; } /// /// Constructor for the forex security /// /// Defines the hours this exchange is open /// The cash object that represent the quote currency /// The cash object that represent the base currency /// The subscription configuration for this security /// The symbol properties for this security /// Currency converter used to convert /// instances into units of the account currency /// Provides all data types registered in the algorithm public Forex(SecurityExchangeHours exchangeHours, Cash quoteCurrency, Cash baseCurrency, SubscriptionDataConfig config, SymbolProperties symbolProperties, ICurrencyConverter currencyConverter, IRegisteredSecurityDataTypesProvider registeredTypes) : base(config, quoteCurrency, symbolProperties, new ForexExchange(exchangeHours), new ForexCache(), new SecurityPortfolioModel(), new ImmediateFillModel(), new InteractiveBrokersFeeModel(), NullSlippageModel.Instance, new ImmediateSettlementModel(), Securities.VolatilityModel.Null, new SecurityMarginModel(50m), new ForexDataFilter(), new SecurityPriceVariationModel(), currencyConverter, registeredTypes, Securities.MarginInterestRateModel.Null ) { BaseCurrency = baseCurrency; Holdings = new ForexHolding(this, currencyConverter); } /// /// Constructor for the forex security /// /// The security's symbol /// Defines the hours this exchange is open /// The cash object that represent the quote currency /// The cash object that represent the base currency /// The symbol properties for this security /// Currency converter used to convert /// instances into units of the account currency /// Provides all data types registered in the algorithm /// Cache for storing Security data public Forex(Symbol symbol, SecurityExchangeHours exchangeHours, Cash quoteCurrency, Cash baseCurrency, SymbolProperties symbolProperties, ICurrencyConverter currencyConverter, IRegisteredSecurityDataTypesProvider registeredTypes, SecurityCache securityCache) : base(symbol, quoteCurrency, symbolProperties, new ForexExchange(exchangeHours), securityCache, new SecurityPortfolioModel(), new ImmediateFillModel(), new InteractiveBrokersFeeModel(), NullSlippageModel.Instance, new ImmediateSettlementModel(), Securities.VolatilityModel.Null, new SecurityMarginModel(50m), new ForexDataFilter(), new SecurityPriceVariationModel(), currencyConverter, registeredTypes, Securities.MarginInterestRateModel.Null ) { BaseCurrency = baseCurrency; Holdings = new ForexHolding(this, currencyConverter); } /// /// Decomposes the specified currency pair into a base and quote currency provided as out parameters /// /// The input currency pair to be decomposed, for example, "EURUSD" /// The output base currency /// The output quote currency public static void DecomposeCurrencyPair(string currencyPair, out string baseCurrency, out string quoteCurrency) { if (!CurrencyPairUtil.IsForexDecomposable(currencyPair)) { throw new ArgumentException($"Currency pairs must be exactly 6 characters: {currencyPair}"); } baseCurrency = currencyPair.Substring(0, 3); quoteCurrency = currencyPair.Substring(3); } } }