/*
* 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 System.Globalization;
using QuantConnect.Data;
namespace QuantConnect.Algorithm.Examples
{
///
/// 3.0 CUSTOM DATA SOURCE: USE YOUR OWN MARKET DATA (OPTIONS, FOREX, FUTURES, DERIVATIVES etc).
///
/// The new QuantConnect Lean Backtesting Engine is incredibly flexible and allows you to define your own data source.
///
/// This includes any data source which has a TIME and VALUE. These are the *only* requirements. To demonstrate this we're loading
/// in "Bitcoin" data.
///
///
public class CustomDataBitcoinAlgorithm : QCAlgorithm
{
///
/// Initialise the data and resolution required, as well as the cash and start-end dates for your algorithm. All algorithms must initialized.
///
public override void Initialize()
{
//Weather data we have is within these days:
SetStartDate(2011, 9, 13);
SetEndDate(DateTime.Now.Date.AddDays(-1));
//Set the cash for the strategy:
SetCash(100000);
//Define the symbol and "type" of our generic data:
AddData("BTC");
}
///
/// Event Handler for Bitcoin Data Events: These weather objects are created from our
/// "Weather" type below and fired into this event handler.
///
/// One(1) Weather Object, streamed into our algorithm synchronised in time with our other data streams
public void OnData(Bitcoin data)
{
//If we don't have any weather "SHARES" -- invest"
if (!Portfolio.Invested)
{
//Weather used as a tradable asset, like stocks, futures etc.
if (data.Close != 0)
{
Order("BTC", (Portfolio.Cash / Math.Abs(data.Close + 1)));
}
Console.WriteLine("Buying BTC 'Shares': BTC: " + data.Close);
}
Console.WriteLine("Time: " + Time.ToLongDateString() + " " + Time.ToLongTimeString() + data.Close.ToString());
}
}
///
/// Custom Data Type: Bitcoin data from Quandl.
/// http://www.quandl.com/help/api-for-bitcoin-data
///
public class Bitcoin : BaseData
{
//Set the defaults:
///
/// Opening Price
///
public decimal Open = 0;
///
/// High Price
///
public decimal High = 0;
///
/// Low Price
///
public decimal Low = 0;
///
/// Closing Price
///
public decimal Close = 0;
///
/// Volume in BTC
///
public decimal VolumeBTC = 0;
///
/// Volume in USD
///
public decimal VolumeUSD = 0;
///
/// Weighted Average Price
///
public decimal WeightedPrice = 0;
///
/// 1. DEFAULT CONSTRUCTOR: Custom data types need a default constructor.
/// We search for a default constructor so please provide one here. It won't be used for data, just to generate the "Factory".
///
public Bitcoin()
{
this.Symbol = "BTC";
}
///
/// 2. RETURN THE STRING URL SOURCE LOCATION FOR YOUR DATA:
/// This is a powerful and dynamic select source file method. If you have a large dataset, 10+mb we recommend you break it into smaller files. E.g. One zip per year.
/// We can accept raw text or ZIP files. We read the file extension to determine if it is a zip file.
///
/// Subscription data, symbol name, data type
/// Current date we're requesting. This allows you to break up the data source into daily files.
/// Datafeed type: Backtesting or the Live data broker who will provide live data. You can specify a different source for live trading!
/// string URL end point.
public override string GetSource(SubscriptionDataConfig config, DateTime date, DataFeedEndpoint datafeed)
{
switch (datafeed)
{
//Backtesting Data Source: Example of a data source which varies by day (commented out)
default:
case DataFeedEndpoint.Backtesting:
//return "http://my-ftp-server.com/futures-data-" + date.ToString("Ymd") + ".zip";
// OR simply return a fixed small data file. Large files will slow down your backtest
return "http://www.quandl.com/api/v1/datasets/BITCOIN/BITSTAMPUSD.csv?sort_order=asc";
case DataFeedEndpoint.LiveTrading:
//Alternative live socket data source for live trading (soon)/
return "....";
}
}
///
/// 3. READER METHOD: Read 1 line from data source and convert it into Object.
/// Each line of the CSV File is presented in here. The backend downloads your file, loads it into memory and then line by line
/// feeds it into your algorithm
///
/// string line from the data source file submitted above
/// Subscription data, symbol name, data type
/// Current date we're requesting. This allows you to break up the data source into daily files.
/// Datafeed type - Backtesting or LiveTrading
/// New Bitcoin Object which extends BaseData.
public override BaseData Reader(SubscriptionDataConfig config, string line, DateTime date, DataFeedEndpoint datafeed)
{
//New bitcoin object
Bitcoin coin = new Bitcoin();
try
{
//Example File Format:
//Date, Open High Low Close Volume (BTC) Volume (Currency) Weighted Price
//2011-09-13 5.8 6.0 5.65 5.97 58.37138238, 346.0973893944 5.929230648356
string[] data = line.Split(',');
coin.Time = DateTime.Parse(data[0]);
coin.Open = Convert.ToDecimal(data[1], CultureInfo.InvariantCulture);
coin.High = Convert.ToDecimal(data[2], CultureInfo.InvariantCulture);
coin.Low = Convert.ToDecimal(data[3], CultureInfo.InvariantCulture);
coin.Close = Convert.ToDecimal(data[4], CultureInfo.InvariantCulture);
coin.VolumeBTC = Convert.ToDecimal(data[5], CultureInfo.InvariantCulture);
coin.VolumeUSD = Convert.ToDecimal(data[6], CultureInfo.InvariantCulture);
coin.WeightedPrice = Convert.ToDecimal(data[7], CultureInfo.InvariantCulture);
coin.Symbol = "BTC";
coin.Value = coin.Close;
}
catch { /* Do nothing, skip first title row */ }
return coin;
}
}
}