ml-finance-python
python scripts for finance machine learning
git clone https://9o.is/git/ml-finance-python.git
notebook.ipynb
(66546B)
1 {
2 "cells": [
3 {
4 "cell_type": "markdown",
5 "metadata": {},
6 "source": [
7 "## Lesson 1: Hello Futures\n",
8 "The Getting Started with Futures Tutorial will walk you through the process of researching a quantitative strategy using futures, implementing that strategy in an algorithm, and backtesting it on Quantopian. It covers many of the basics of the Quantopian API, and is designed for those who are new to the platform. Each lesson focuses on a different part of the API and by the end, we will work up to a simple pairs trading algorithm.\n",
9 "\n",
10 "If you are unfamiliar with Futures trading, check out the Introduction to Futures Contracts lecture from our [Lecture Series](https://quanto-playground.herokuapp.com/lectures).\n",
11 "\n",
12 "### What is a Trading Algorithm?\n",
13 "On Quantopian, a trading algorithm is a Python program that defines a specific set of instructions on how to analyze, order, and manage assets. Most trading algorithms make desicions based on mathematical or statistical hypotheses that are derived by conducting research on historical data.\n",
14 "\n",
15 "### Coming Up With a Strategy\n",
16 "The first step to writing a trading algorithm is to find an economic relationship on which we can base our strategy. To do this, we can use Research to inspect and analyze pricing and volume data for 72 different US futures going as far back as 2002. Research is an IPython Notebook environment that allows us to run python code in units called 'cells'. The code below gets pricing and volume data for the Light Sweet Crude Oil contract with delivery in January 2016 and plots it. To run it, click on the grey box and press Shift + Enter to run the cell."
17 ]
18 },
19 {
20 "cell_type": "code",
21 "execution_count": 1,
22 "metadata": {
23 "collapsed": false
24 },
25 "outputs": [
26 {
27 "data": {
28 "image/png": "iVBORw0KGgoAAAANSUhEUgAAA0QAAAHSCAYAAADMuQtZAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAIABJREFUeJzs3Xd4FlXexvHv09J77xASIJRAYiCU0BUFrLAWXAQLa0dd\n1hU76uquC76IuKigu6xdVyzYQBCRIqEl9E5IKCEkpEAIpCfP+0cwAtLEJJNyf64rV57MzHPmN8cY\ncuecOWOy2+12REREREREWiCz0QWIiIiIiIgYRYFIRERERERaLAUiERERERFpsRSIRERERESkxVIg\nEhERERGRFkuBSEREREREWiyrUSdevXo1Dz30EG3btsVut9O+fXv+9Kc/8cgjj2C32/H392fy5MnY\nbDajShQRERERkWbOsEAEkJiYyLRp02q/fvzxxxk9ejSXX345U6dO5bPPPmPkyJEGVigiIiIiIs2Z\noVPmTn8m7OrVqxk4cCAAAwcOJDk52YiyRERERESkhTB0hGj37t3cd999FBYWcv/991NaWlo7Rc7X\n15fc3FwjyxMRERERkWbOsEDUqlUrxo0bx9ChQ9m/fz9jxoyhsrKydv/po0dnk5qaWl8lioiIiIhI\nM5GQkHDG7YYFosDAQIYOHQpAeHg4fn5+bN68mfLychwcHMjJySEgIOCC2jrbxdWl1NTUBjlPS6Y+\nbhjq54ahfq5/6uOGoX6uf+rjhqF+bhiNtZ/PNYhi2D1EX3/9NdOnTwcgPz+f/Px8RowYwXfffQfA\n/Pnz6du3r1HliYiIiIhIC2DYCNGgQYN4+OGHufnmm7Hb7Tz33HPExMTw6KOP8sknnxASEsLw4cON\nKk9ERERERFoAwwKRq6srM2bM+NX2WbNmGVCNiIiIiEjzZrfbKSsrq/fzlJaW1vs5zsXR0RGTyXTB\nxxu67LaIiIiIiDSMsrKyeg9EnTp1qtf2z+dirtHQZbdFRERERKThODo64uTkZHQZjYpGiERERERE\npMVSIBIRERERkRZLgUhERERERFosBSIREREREWkU3nzzTTZs2NCg59SiCiIiIiIi0ijcddddDX5O\nBSIREREREWkQX3zxBcuWLeP48eNkZ2dz6623MnPmTAYMGICnpyf79+9nyJAhJCUl8eijj5KVlYWT\nkxOTJk3Cz8+Pp59+mszMTCorK3nggQfo2bPn765JgUhEREREpAWa9fUWlm84UKdtJnUN5Y6rz/0s\n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\ndO7cmUceeYSUlBQeeughhgwZQklJCe+99x6BgYFmRRMREREREQdh2saso0aN4pFHHgEgJSWF4OBg\nABriN/0AACAASURBVN59911iYmJwdnY2K5qIiIiIiDgI0wqiChMmTOD5559n6tSpnDhxgqNHjzJy\n5EgMwzA7moiIiIiINHCmN1VYvHgxCQkJTJkyhZCQEF5++WWzI4mIiIiIiIOwGCZNxezfv5/GjRtf\nXCp3yy23YLVaady4MYZhcPDgQbp168ZHH3101evExcXVRlwREREREanHevToccXjps0Q7dy5k5SU\nFKZOnUpWVhaGYfDNN99c/PywYcMqLYbgl1+YiIiIiIhIZUx7hui+++4jOzub6OhoJk6cyJ///OdL\nPl+bfclFRERERMQxmbZkTkRERERExGymd5kTERERERExiwoiERERERFxWCqIRERERETEYakgEhER\nERERh6WCSEREREREHJYKIhERERERcVgqiERERERExGGpIBIREREREYelgkhERERERByWCiIRERER\nEXFYKohERERERMRhqSASERERERGHpYJIREREREQclgoiERERERFxWCqIRERERETEYakgEhERERER\nh6WCSEREREREHJYKIhERERERcVgqiERERERExGGpIBIREREREYelgkhERERERByWCiIREREREXFY\nKohERERERMRhqSASERERERGHpYJIREREREQclgoiERERERFxWCqIRERERETEYakgEhERERERh+VU\n2Qnbt2/n6aefpm3bthiGQfv27Xn00Ud57rnnMAyDgIAA3nzzTZydnVm+fDkLFizAZrMxduxYxowZ\nQ2lpKX/84x9JSUnBZrMxffp0QkNDSUhI4JVXXsFqtdK+fXv+/Oc/AzBv3jxWr16N1WrliSeeYPDg\nwTU+CCIiIiIi4pgqLYgAevfuzezZsy/+/YUXXiAmJoaRI0cya9Ysli1bxl133cWcOXNYtmwZTk5O\njBkzhpEjR7Ju3Tp8fHz4n//5HzZv3szMmTOZNWsW06ZN46WXXiIiIoLJkyezadMmWrZsycqVK1my\nZAlnz54lOjqaQYMGYbFYamwARERERETEcVVpyZxhGJf8ffv27QwdOhSAoUOHEhsby549e+jSpQue\nnp64uroSGRlJXFwcW7ZsYfjw4QD079+f+Ph47HY7ycnJREREADBs2DBiY2PZtm0bgwYNwmaz4e/v\nT7NmzTh69Gh1vl4REREREZGLqlQQHTt2jCeeeILo6GhiY2MpKirC2dkZgMaNG5ORkUF2djb+/v4X\nv8bf35/MzEyysrIuHrdYLFgsFrKysvD19b3k3KtdQ0REREREpCZUumSuefPmPPnkk9x+++0kJSXx\nwAMPUFpaevHz/3f2qCrHLRbLL36+Ktf4ubi4uErPERERERERx9ajR48rHq+0IAoKCuL2228HICws\njCZNmrB//35KSkpwcXEhPT2doKAgAgMDL5nNSU9Pp3v37gQGBpKVlUX79u0pLS292IghNzf3knMr\nrpGYmHjJ8cDAwOt+cdUpLi6uVu7jyDTGtUPjXDs0zjVPY1w7NM41T2NcOzTOtaOujvPVJlEqXTL3\n5Zdf8s477wCQnZ1NdnY299xzD6tWrQJg9erVDBw4kC5durB//37y8/M5f/488fHx9OjRgwEDBlw8\nd926dfTp0webzUarVq3YtWsXAGvWrGHgwIH06dOHjRs3UlpaSnp6OhkZGbRp0+aGB0BERERERORK\nKp0hGjZsGJMnT+a+++7DMAxeffVVOnTowB/+8AeWLFlCSEgId999NzabjcmTJ/Pwww9jtVqZNGkS\nXl5ejBo1is2bNxMVFYWrqyszZswAYOrUqbz88ssYhkHXrl3p168fAOPGjSM6OhqLxcKrr75as69e\nREREREQcWqUFkaenJ+++++5lxz/44IPLjo0cOZKRI0decsxqtTJ9+vTLzm3dujULFy687Hh0dDTR\n0dGVxRIRERERcXiGYVBcXGx2jEsUFRWZen9XV9dr2ranSl3mRERERESk7ikuLq5TBVHFtjpmuZ7x\nqNLGrCIiIiIiUje5urri5uZmdox6SzNEIiIiIiLisFQQiYiIiIiIw1JBJCIiIiIiDksFkYiIiIiI\n1Lhhw4ZRWFhodozLqCASEREREZEady2tsGuTusyJiIiIiMh1u+eee5gzZw5NmzYlJSWFJ598kvbt\n25OcnIzdbuepp56if//+F89/4YUXuO222xg8eDAbNmxg9erVPPnkkzz//POEh4cTHx/PhAkTOHz4\nMPv27SMqKoqoqCh27tzJrFmzcHZ2Jjg4mL/+9a84Od14OaOCSERERESkgfho9zK2Ju2q1mv2DYsk\nptu9v/j5ESNGsG7dOqKioli7di233HILWVlZfPTRR2RkZBATE8Pq1asrvU9CQgJz584lJyeHO+64\n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\nBuSNOHjwICkpKQBdcpKcb56MjAxefPFFVqxYgdlstv2/l4wvr8cfIercc7Bp0yZWrlzJpEmTyMrK\nYvPmzfz3f/+3bWXVKS0tjeDgYNvFQMvLy/nVr37F1KlT5crbV9CZc1ZWlq2h2bx5M6tXr+aNN96Q\nnG+Ci6e3fP3113n88cfJz8+nrKzMdhLjxXbt2sWwYcPQ6/WUl5dTXFzMkiVLKC8vJzAw0AlL0Lt8\n/PHHbNy4kfnz5/PWW2/R2trK448/fsmKXXK+Pp2f582bN/PBBx/w4IMP8uGHH1JSUsL8+fNxdXXt\n8nzJ+fo0NDTw97//neLiYh577DFSU1N/MjPJ+Pp0fpZVKhXu7u4cP34cDw8P9u3bx8iRI7scwQDI\nysoiIiICHx8fzpw5Q15eHv/1X/9FXV0dBoPBiUvSO7S1tfHaa6+hKAqxsbHExMTYjl5cTHK+fl9/\n/TVr1qzh0Ucf5cMPP6StrY1f//rX8lm+gh6/m6ilpQXoOAlsypQpPPHEEzz22GPExsbanmO1WlEU\nBcA2hG7r1q0sWLCAjIwMLBaLbKRfhdlsBjqOwoWFhfGb3/yG//f//h+lpaX88MMPtudJztevcyWU\nmZnJ8OHDufvuu3nmmWfw8/Pr8jyr1QqAp6cnAQEBfPLJJ/zud7+jpKQEQDZsuunMmTM89NBDTJs2\njd/85jfodLouP5ecb44jR44wYcIE7rrrLpYsWUJOTg5paWm2o8rt7e2A5Hy9SktLGTFiBP/617+Y\nOHEizc3Nl2Qmn+Ubc/EGYk1NDTExMcybN4+vv/7advFJuJCzRqPBzc2N1atX88ILL1BWVgZwy21A\nXg+r1UpmZiYxMTFMmjSJVatWAV2PWnZuZ0jO16+goIDJkydz++238+STT9La2gogn+Ur6LHTbufk\n5PDGG2+QmppKYGAgWq2W5ORkGhoaeOyxx/D09OTQoUMkJyfb9uxAR1f8j3/8AxcXF5544gnuuusu\nGR5wBTk5OSxbtoz09HTCwsIwm81UV1cTFRWFl5cX3t7erF27lgkTJuDm5iY5X4fvv/+ed955h6Ki\nImJjYzEajXz99dd4eHjw0ksvsWPHDnJycmzj+zszXrlyJV9++SX9+vXjhRdeIDEx0ZmL0eNt2LCB\nrKwsBg0aRHNzM97e3gwbNozs7GwWLVqEr68vubm5jBo1CpCcr9f69et59dVXbXvRfXx8OHHiBMOG\n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\nDTBoL74AAAAASUVORK5CYII=\n",
29 "text/plain": [
30 "<matplotlib.figure.Figure at 0x7f9aedf4db90>"
31 ]
32 },
33 "metadata": {},
34 "output_type": "display_data"
35 }
36 ],
37 "source": [
38 "# Click somewhere in this box and press Shift + Enter to run the code.\n",
39 "\n",
40 "from quantopian.research.experimental import history\n",
41 "\n",
42 "# Create a reference to the Light Sweet Crude Oil contract\n",
43 "# with delivery in January 2016\n",
44 "clf16 = symbols('CLF16')\n",
45 "\n",
46 "# Query historical pricing and volume data for \n",
47 "# the contract from October 21st, 2015 to December 21st, 2015\n",
48 "clf16_data = history(\n",
49 " clf16, \n",
50 " fields=['price', 'volume'], \n",
51 " frequency='daily', \n",
52 " start='2015-10-21', \n",
53 " end='2015-12-21'\n",
54 ")\n",
55 "\n",
56 "# Plot the data\n",
57 "clf16_data.plot(subplots=True);"
58 ]
59 },
60 {
61 "cell_type": "markdown",
62 "metadata": {},
63 "source": [
64 "Research is the perfect tool to test a hypothesis, so let's come up with an idea to test.\n",
65 "\n",
66 "**Strategy:** If a pair of commodities exist on the same supply chain, we expect the spread between the prices of their futures to remain consistent. As the spread increases or decreases, we can trade on the expectation that it will revert to the steady state.\n",
67 "\n",
68 "In the next few lessons we will learn how to use Research to test our hypothesis. If we find our hypothesis to be valid (spoiler alert: we will), we can use it as a starting point for implementing and backetsting an algorithm in the Interactive Development Environment (IDE)."
69 ]
70 }
71 ],
72 "metadata": {
73 "kernelspec": {
74 "display_name": "Python 2",
75 "language": "python",
76 "name": "python2"
77 },
78 "language_info": {
79 "codemirror_mode": {
80 "name": "ipython",
81 "version": 2
82 },
83 "file_extension": ".py",
84 "mimetype": "text/x-python",
85 "name": "python",
86 "nbconvert_exporter": "python",
87 "pygments_lexer": "ipython2",
88 "version": "2.7.12"
89 }
90 },
91 "nbformat": 4,
92 "nbformat_minor": 2
93 }