/*
* 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.Interfaces;
using System.Collections.Generic;
using QuantConnect.Data.Auxiliary;
namespace QuantConnect.Lean.Engine.DataFeeds
{
///
/// An implementation of that reads the list of contracts from open interest zip data files
///
public class BacktestingOptionChainProvider : BacktestingChainProvider, IOptionChainProvider
{
///
/// Gets the list of option contracts for a given underlying symbol
///
/// The option or the underlying symbol to get the option chain for.
/// Providing the option allows targeting an option ticker different than the default e.g. SPXW
/// The date for which to request the option chain (only used in backtesting)
/// The list of option contracts
public virtual IEnumerable GetOptionContractList(Symbol symbol, DateTime date)
{
Symbol canonicalSymbol;
if (!symbol.SecurityType.HasOptions())
{
// we got an option
if (symbol.SecurityType.IsOption() && symbol.Underlying != null)
{
canonicalSymbol = GetCanonical(symbol, date);
}
else
{
throw new NotSupportedException($"BacktestingOptionChainProvider.GetOptionContractList(): " +
$"{nameof(SecurityType.Equity)}, {nameof(SecurityType.Future)}, or {nameof(SecurityType.Index)} is expected but was {symbol.SecurityType}");
}
}
else
{
// we got the underlying
var mappedUnderlyingSymbol = MapUnderlyingSymbol(symbol, date);
canonicalSymbol = Symbol.CreateCanonicalOption(mappedUnderlyingSymbol);
}
return GetSymbols(canonicalSymbol, date);
}
private Symbol GetCanonical(Symbol optionSymbol, DateTime date)
{
// Resolve any mapping before requesting option contract list for equities
// Needs to be done in order for the data file key to be accurate
if (optionSymbol.Underlying.RequiresMapping())
{
var mappedUnderlyingSymbol = MapUnderlyingSymbol(optionSymbol.Underlying, date);
return Symbol.CreateCanonicalOption(mappedUnderlyingSymbol);
}
else
{
return optionSymbol.Canonical;
}
}
private Symbol MapUnderlyingSymbol(Symbol underlying, DateTime date)
{
if (underlying.RequiresMapping())
{
var mapFileResolver = MapFileProvider.Get(AuxiliaryDataKey.Create(underlying));
var mapFile = mapFileResolver.ResolveMapFile(underlying);
var ticker = mapFile.GetMappedSymbol(date, underlying.Value);
return underlying.UpdateMappedSymbol(ticker);
}
else
{
return underlying;
}
}
}
}