examples/features/data-feeds/Using TraderMade FX spot price data in LUSID.ipynb

{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "\n",
       "    <form action=\"javascript:code_toggle()\"><input type=\"submit\" id=\"toggleButton\" value=\"Toggle Docstring\"></form>\n",
       "    \n",
       "         <script>\n",
       "         function code_toggle() {\n",
       "             if ($('div.cell.code_cell.rendered.selected div.input').css('display')!='none'){\n",
       "                 $('div.cell.code_cell.rendered.selected div.input').hide();\n",
       "             } else {\n",
       "                 $('div.cell.code_cell.rendered.selected div.input').show();\n",
       "             }\n",
       "         }\n",
       "         </script>\n",
       "\n",
       "     "
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from lusidtools.jupyter_tools import toggle_code\n",
    "\n",
    "\"\"\"Using TraderMade FX spot price data in LUSID\n",
    "\n",
    "This notebook shows you how to access TraderMade spot FX data in LUSID\n",
    "\n",
    "Attributes\n",
    "----------\n",
    "quotes\n",
    "\"\"\"\n",
    "\n",
    "toggle_code(\"Toggle Docstring\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Using TraderMade FX spot price data in LUSID\n",
    "\n",
    "This notebook shows you how to access TraderMade spot FX data in LUSID. For some background, [TraderMade](https://tradermade.com/about) is a vendor of FX data who provide this FX data into your LUSID environment. Each day we load spot prices for 280+ currency pairs."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "LUSID Environment Initialised\n",
      "LUSID SDK Version:  0.6.5888.0\n"
     ]
    }
   ],
   "source": [
    "# Import LUSID APIs and Models\n",
    "import lusid\n",
    "import lusid.models as models\n",
    "\n",
    "# Import LUSID Python tools \n",
    "from lusidtools.pandas_utils.lusid_pandas import lusid_response_to_data_frame\n",
    "from lusidjam.refreshing_token import RefreshingToken\n",
    "\n",
    "# Import general system libraries\n",
    "from datetime import datetime, timedelta, time, date\n",
    "import pytz\n",
    "import uuid\n",
    "import os\n",
    "from datetime import datetime\n",
    "\n",
    "# Import data wrangling packages\n",
    "import pandas as pd\n",
    "import numpy as np\n",
    "import json\n",
    "\n",
    "# Authenticate our user and create our API client\n",
    "secrets_path = os.getenv(\"FBN_SECRETS_PATH\")\n",
    "\n",
    "# Create API factory\n",
    "api_factory = lusid.utilities.ApiClientFactory(\n",
    "    token=RefreshingToken(),\n",
    "    api_secrets_filename = secrets_path,\n",
    "    app_name=\"LusidJupyterNotebook\")\n",
    "\n",
    "print ('LUSID Environment Initialised')\n",
    "print ('LUSID SDK Version: ', api_factory.build(lusid.api.ApplicationMetadataApi).get_lusid_versions().build_version)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Setup notebook configuration"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Import ploting libraries and configuration\n",
    "import matplotlib.pyplot as plt\n",
    "\n",
    "# Use line magic function to enable matplotlib to work interactively with iPython\n",
    "\n",
    "%matplotlib inline\n",
    "\n",
    "# Set style to fivethirtyeight to create clean and clear looking graphs\n",
    "\n",
    "plt.style.use('fivethirtyeight')\n",
    "\n",
    "# Define a dictionary containing default plotting configurations\n",
    "\n",
    "params = {'legend.fontsize': 'small',\n",
    "          'figure.figsize': (12, 4.5),\n",
    "         'axes.labelsize': 'small',\n",
    "         'axes.titlesize': 'medium',\n",
    "         'xtick.labelsize': 'small',\n",
    "         'ytick.labelsize': 'small'}\n",
    "\n",
    "plt.rcParams.update(params)\n",
    "\n",
    "with open(r\"config/tm_dataframe_mappings.json\") as mappings_file:\n",
    "    json_mappings = json.load(mappings_file)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Declare a scope which contains TraderMade FX data\n",
    "\n",
    "The TraderMade FX data is loaded into LUSID each night into the <b>TraderMadeFxData</b> scope. You will need to make LUSID calls against this scope to access the TraderMade data. Please see this [page](https://support.finbourne.com/what-is-a-scope-in-lusid-and-how-is-it-used) for more information on scopes."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [],
   "source": [
    "scope = \"TraderMadeFxData\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Call FX spot data using LUSID's APIs\n",
    "\n",
    "We can call the TraderMade data using the QuotesApi passing the <b>TraderMadeFxData</b> scope."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Declare a QuotesApi object\n",
    "quotes_api = api_factory.build(lusid.api.QuotesApi)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Declare start date and end date string\n",
    "start_date = \"2019-12-27\" \n",
    "end_date = \"2020-03-27\""
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Provider</th>\n",
       "      <th>InstrumentID</th>\n",
       "      <th>InstrumentType</th>\n",
       "      <th>QuoteType</th>\n",
       "      <th>Field</th>\n",
       "      <th>EffectiveAt</th>\n",
       "      <th>Value</th>\n",
       "      <th>Unit</th>\n",
       "      <th>Lineage</th>\n",
       "      <th>CutLabel</th>\n",
       "      <th>UploadedBy</th>\n",
       "      <th>AsAt</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>TraderMade</td>\n",
       "      <td>USD/JPY</td>\n",
       "      <td>CurrencyPair</td>\n",
       "      <td>Price</td>\n",
       "      <td>close</td>\n",
       "      <td>2020-03-24T00:00:00.0000000+00:00</td>\n",
       "      <td>111.19600</td>\n",
       "      <td>USD</td>\n",
       "      <td></td>\n",
       "      <td></td>\n",
       "      <td>00u4edvyh4xFY1Yei2p7</td>\n",
       "      <td>2020-03-25 16:26:47.115868+00:00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>TraderMade</td>\n",
       "      <td>USD/JPY</td>\n",
       "      <td>CurrencyPair</td>\n",
       "      <td>Price</td>\n",
       "      <td>close</td>\n",
       "      <td>2020-03-23T00:00:00.0000000+00:00</td>\n",
       "      <td>111.24736</td>\n",
       "      <td>USD</td>\n",
       "      <td></td>\n",
       "      <td></td>\n",
       "      <td>00u4edvyh4xFY1Yei2p7</td>\n",
       "      <td>2020-03-25 16:26:47.115868+00:00</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     Provider InstrumentID InstrumentType QuoteType  Field  \\\n",
       "0  TraderMade      USD/JPY   CurrencyPair     Price  close   \n",
       "1  TraderMade      USD/JPY   CurrencyPair     Price  close   \n",
       "\n",
       "                         EffectiveAt      Value Unit Lineage CutLabel  \\\n",
       "0  2020-03-24T00:00:00.0000000+00:00  111.19600  USD                    \n",
       "1  2020-03-23T00:00:00.0000000+00:00  111.24736  USD                    \n",
       "\n",
       "             UploadedBy                             AsAt  \n",
       "0  00u4edvyh4xFY1Yei2p7 2020-03-25 16:26:47.115868+00:00  \n",
       "1  00u4edvyh4xFY1Yei2p7 2020-03-25 16:26:47.115868+00:00  "
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Call list_quotes to list out some quotes for 7 days in March 2020\n",
    "quotes_response = quotes_api.list_quotes(scope=scope, filter = f\"QuoteId.EffectiveAt gte 2020-03-19 and QuoteId.EffectiveAt lte {end_date}\" )\n",
    "quotes_df = lusid_response_to_data_frame(quotes_response, column_name_mapping=json_mappings)\n",
    "quotes_df.head(2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Note - please contact support@lusid.com if you have no FX data in the <b>TraderMadeFxData</b> scope."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### We load quotes for 280+ currency pairs a day "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "      <th>CurrencyPair</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>AED/EUR</td>\n",
       "      <td>AED/GBP</td>\n",
       "      <td>AED/USD</td>\n",
       "      <td>ARS/USD</td>\n",
       "      <td>AUD/BRL</td>\n",
       "      <td>AUD/CAD</td>\n",
       "      <td>AUD/CHF</td>\n",
       "      <td>AUD/DKK</td>\n",
       "      <td>AUD/EUR</td>\n",
       "      <td>AUD/GBP</td>\n",
       "      <td>AUD/JPY</td>\n",
       "      <td>AUD/MXN</td>\n",
       "      <td>AUD/NOK</td>\n",
       "      <td>AUD/NZD</td>\n",
       "      <td>AUD/RUB</td>\n",
       "      <td>AUD/SEK</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>AUD/SGD</td>\n",
       "      <td>AUD/USD</td>\n",
       "      <td>BRL/AUD</td>\n",
       "      <td>BRL/COP</td>\n",
       "      <td>BRL/EUR</td>\n",
       "      <td>BRL/GBP</td>\n",
       "      <td>BRL/JPY</td>\n",
       "      <td>BRL/MXN</td>\n",
       "      <td>BRL/USD</td>\n",
       "      <td>CAD/AUD</td>\n",
       "      <td>CAD/CHF</td>\n",
       "      <td>CAD/EUR</td>\n",
       "      <td>CAD/GBP</td>\n",
       "      <td>CAD/JPY</td>\n",
       "      <td>CAD/MXN</td>\n",
       "      <td>CAD/NOK</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>CAD/NZD</td>\n",
       "      <td>CAD/SEK</td>\n",
       "      <td>CAD/USD</td>\n",
       "      <td>CHF/AUD</td>\n",
       "      <td>CHF/CAD</td>\n",
       "      <td>CHF/DKK</td>\n",
       "      <td>CHF/EUR</td>\n",
       "      <td>CHF/GBP</td>\n",
       "      <td>CHF/ISK</td>\n",
       "      <td>CHF/JPY</td>\n",
       "      <td>CHF/NOK</td>\n",
       "      <td>CHF/NZD</td>\n",
       "      <td>CHF/PLN</td>\n",
       "      <td>CHF/SEK</td>\n",
       "      <td>CHF/TRY</td>\n",
       "      <td>CHF/USD</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>CHF/ZAR</td>\n",
       "      <td>CLP/EUR</td>\n",
       "      <td>CLP/USD</td>\n",
       "      <td>CNY/USD</td>\n",
       "      <td>COP/BRL</td>\n",
       "      <td>COP/EUR</td>\n",
       "      <td>COP/USD</td>\n",
       "      <td>CZK/EUR</td>\n",
       "      <td>CZK/GBP</td>\n",
       "      <td>CZK/SEK</td>\n",
       "      <td>CZK/USD</td>\n",
       "      <td>DKK/AUD</td>\n",
       "      <td>DKK/CHF</td>\n",
       "      <td>DKK/EUR</td>\n",
       "      <td>DKK/GBP</td>\n",
       "      <td>DKK/JPY</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>DKK/NOK</td>\n",
       "      <td>DKK/NZD</td>\n",
       "      <td>DKK/SEK</td>\n",
       "      <td>DKK/USD</td>\n",
       "      <td>EUR/AED</td>\n",
       "      <td>EUR/AUD</td>\n",
       "      <td>EUR/BRL</td>\n",
       "      <td>EUR/CAD</td>\n",
       "      <td>EUR/CHF</td>\n",
       "      <td>EUR/CLP</td>\n",
       "      <td>EUR/COP</td>\n",
       "      <td>EUR/CZK</td>\n",
       "      <td>EUR/DKK</td>\n",
       "      <td>EUR/GBP</td>\n",
       "      <td>EUR/HKD</td>\n",
       "      <td>EUR/HRK</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>EUR/HUF</td>\n",
       "      <td>EUR/IDR</td>\n",
       "      <td>EUR/ILS</td>\n",
       "      <td>EUR/INR</td>\n",
       "      <td>EUR/ISK</td>\n",
       "      <td>EUR/JPY</td>\n",
       "      <td>EUR/KRW</td>\n",
       "      <td>EUR/MAD</td>\n",
       "      <td>EUR/MXN</td>\n",
       "      <td>EUR/MYR</td>\n",
       "      <td>EUR/NOK</td>\n",
       "      <td>EUR/NZD</td>\n",
       "      <td>EUR/PEN</td>\n",
       "      <td>EUR/PHP</td>\n",
       "      <td>EUR/PLN</td>\n",
       "      <td>EUR/RON</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>EUR/RUB</td>\n",
       "      <td>EUR/SEK</td>\n",
       "      <td>EUR/SGD</td>\n",
       "      <td>EUR/THB</td>\n",
       "      <td>EUR/TRY</td>\n",
       "      <td>EUR/TWD</td>\n",
       "      <td>EUR/USD</td>\n",
       "      <td>EUR/ZAR</td>\n",
       "      <td>GBP/AED</td>\n",
       "      <td>GBP/AUD</td>\n",
       "      <td>GBP/BRL</td>\n",
       "      <td>GBP/CAD</td>\n",
       "      <td>GBP/CHF</td>\n",
       "      <td>GBP/CZK</td>\n",
       "      <td>GBP/DKK</td>\n",
       "      <td>GBP/EUR</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7</th>\n",
       "      <td>GBP/HKD</td>\n",
       "      <td>GBP/HUF</td>\n",
       "      <td>GBP/INR</td>\n",
       "      <td>GBP/JPY</td>\n",
       "      <td>GBP/KRW</td>\n",
       "      <td>GBP/MXN</td>\n",
       "      <td>GBP/MYR</td>\n",
       "      <td>GBP/NOK</td>\n",
       "      <td>GBP/NZD</td>\n",
       "      <td>GBP/PLN</td>\n",
       "      <td>GBP/SEK</td>\n",
       "      <td>GBP/SGD</td>\n",
       "      <td>GBP/THB</td>\n",
       "      <td>GBP/TRY</td>\n",
       "      <td>GBP/USD</td>\n",
       "      <td>GBP/ZAR</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>8</th>\n",
       "      <td>HKD/EUR</td>\n",
       "      <td>HKD/GBP</td>\n",
       "      <td>HKD/JPY</td>\n",
       "      <td>HKD/USD</td>\n",
       "      <td>HRK/EUR</td>\n",
       "      <td>HRK/USD</td>\n",
       "      <td>HUF/EUR</td>\n",
       "      <td>HUF/GBP</td>\n",
       "      <td>HUF/USD</td>\n",
       "      <td>ILS/EUR</td>\n",
       "      <td>ILS/USD</td>\n",
       "      <td>INR/EUR</td>\n",
       "      <td>INR/GBP</td>\n",
       "      <td>INR/USD</td>\n",
       "      <td>ISK/CHF</td>\n",
       "      <td>ISK/EUR</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>9</th>\n",
       "      <td>ISK/USD</td>\n",
       "      <td>JPY/AUD</td>\n",
       "      <td>JPY/BRL</td>\n",
       "      <td>JPY/CAD</td>\n",
       "      <td>JPY/CHF</td>\n",
       "      <td>JPY/DKK</td>\n",
       "      <td>JPY/EUR</td>\n",
       "      <td>JPY/GBP</td>\n",
       "      <td>JPY/HKD</td>\n",
       "      <td>JPY/MXN</td>\n",
       "      <td>JPY/NOK</td>\n",
       "      <td>JPY/NZD</td>\n",
       "      <td>JPY/SEK</td>\n",
       "      <td>JPY/SGD</td>\n",
       "      <td>JPY/TRY</td>\n",
       "      <td>JPY/USD</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>10</th>\n",
       "      <td>JPY/ZAR</td>\n",
       "      <td>KRW/EUR</td>\n",
       "      <td>KRW/GBP</td>\n",
       "      <td>KRW/USD</td>\n",
       "      <td>KWD/USD</td>\n",
       "      <td>MAD/EUR</td>\n",
       "      <td>MAD/USD</td>\n",
       "      <td>MXN/AUD</td>\n",
       "      <td>MXN/BRL</td>\n",
       "      <td>MXN/CAD</td>\n",
       "      <td>MXN/EUR</td>\n",
       "      <td>MXN/GBP</td>\n",
       "      <td>MXN/JPY</td>\n",
       "      <td>MXN/USD</td>\n",
       "      <td>MXN/ZAR</td>\n",
       "      <td>MYR/EUR</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>11</th>\n",
       "      <td>MYR/GBP</td>\n",
       "      <td>MYR/USD</td>\n",
       "      <td>NOK/AUD</td>\n",
       "      <td>NOK/CAD</td>\n",
       "      <td>NOK/CHF</td>\n",
       "      <td>NOK/DKK</td>\n",
       "      <td>NOK/EUR</td>\n",
       "      <td>NOK/GBP</td>\n",
       "      <td>NOK/JPY</td>\n",
       "      <td>NOK/NZD</td>\n",
       "      <td>NOK/SEK</td>\n",
       "      <td>NOK/USD</td>\n",
       "      <td>NZD/AUD</td>\n",
       "      <td>NZD/CAD</td>\n",
       "      <td>NZD/CHF</td>\n",
       "      <td>NZD/DKK</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>12</th>\n",
       "      <td>NZD/EUR</td>\n",
       "      <td>NZD/GBP</td>\n",
       "      <td>NZD/JPY</td>\n",
       "      <td>NZD/NOK</td>\n",
       "      <td>NZD/SEK</td>\n",
       "      <td>NZD/TRY</td>\n",
       "      <td>NZD/USD</td>\n",
       "      <td>PEN/EUR</td>\n",
       "      <td>PEN/USD</td>\n",
       "      <td>PHP/EUR</td>\n",
       "      <td>PHP/USD</td>\n",
       "      <td>PLN/CHF</td>\n",
       "      <td>PLN/EUR</td>\n",
       "      <td>PLN/GBP</td>\n",
       "      <td>PLN/USD</td>\n",
       "      <td>RON/EUR</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>13</th>\n",
       "      <td>RON/USD</td>\n",
       "      <td>RUB/AUD</td>\n",
       "      <td>RUB/EUR</td>\n",
       "      <td>RUB/USD</td>\n",
       "      <td>SEK/AUD</td>\n",
       "      <td>SEK/CAD</td>\n",
       "      <td>SEK/CHF</td>\n",
       "      <td>SEK/CZK</td>\n",
       "      <td>SEK/DKK</td>\n",
       "      <td>SEK/EUR</td>\n",
       "      <td>SEK/GBP</td>\n",
       "      <td>SEK/JPY</td>\n",
       "      <td>SEK/NOK</td>\n",
       "      <td>SEK/NZD</td>\n",
       "      <td>SEK/USD</td>\n",
       "      <td>SGD/AUD</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>14</th>\n",
       "      <td>SGD/EUR</td>\n",
       "      <td>SGD/GBP</td>\n",
       "      <td>SGD/JPY</td>\n",
       "      <td>SGD/USD</td>\n",
       "      <td>THB/EUR</td>\n",
       "      <td>THB/GBP</td>\n",
       "      <td>THB/USD</td>\n",
       "      <td>TRY/CHF</td>\n",
       "      <td>TRY/EUR</td>\n",
       "      <td>TRY/GBP</td>\n",
       "      <td>TRY/JPY</td>\n",
       "      <td>TRY/NZD</td>\n",
       "      <td>TRY/USD</td>\n",
       "      <td>TRY/ZAR</td>\n",
       "      <td>TWD/EUR</td>\n",
       "      <td>TWD/USD</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>15</th>\n",
       "      <td>USD/AED</td>\n",
       "      <td>USD/ARS</td>\n",
       "      <td>USD/AUD</td>\n",
       "      <td>USD/BRL</td>\n",
       "      <td>USD/CAD</td>\n",
       "      <td>USD/CHF</td>\n",
       "      <td>USD/CLP</td>\n",
       "      <td>USD/CNY</td>\n",
       "      <td>USD/COP</td>\n",
       "      <td>USD/CZK</td>\n",
       "      <td>USD/DKK</td>\n",
       "      <td>USD/EUR</td>\n",
       "      <td>USD/GBP</td>\n",
       "      <td>USD/HKD</td>\n",
       "      <td>USD/HRK</td>\n",
       "      <td>USD/HUF</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>16</th>\n",
       "      <td>USD/IDR</td>\n",
       "      <td>USD/ILS</td>\n",
       "      <td>USD/INR</td>\n",
       "      <td>USD/ISK</td>\n",
       "      <td>USD/JPY</td>\n",
       "      <td>USD/KRW</td>\n",
       "      <td>USD/KWD</td>\n",
       "      <td>USD/MAD</td>\n",
       "      <td>USD/MXN</td>\n",
       "      <td>USD/MYR</td>\n",
       "      <td>USD/NOK</td>\n",
       "      <td>USD/NZD</td>\n",
       "      <td>USD/PEN</td>\n",
       "      <td>USD/PHP</td>\n",
       "      <td>USD/PLN</td>\n",
       "      <td>None</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>17</th>\n",
       "      <td>USD/RON</td>\n",
       "      <td>USD/RUB</td>\n",
       "      <td>USD/SEK</td>\n",
       "      <td>USD/SGD</td>\n",
       "      <td>USD/THB</td>\n",
       "      <td>USD/TRY</td>\n",
       "      <td>USD/TWD</td>\n",
       "      <td>USD/ZAR</td>\n",
       "      <td>ZAR/CHF</td>\n",
       "      <td>ZAR/EUR</td>\n",
       "      <td>ZAR/GBP</td>\n",
       "      <td>ZAR/JPY</td>\n",
       "      <td>ZAR/MXN</td>\n",
       "      <td>ZAR/TRY</td>\n",
       "      <td>ZAR/USD</td>\n",
       "      <td>None</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   CurrencyPair CurrencyPair CurrencyPair CurrencyPair CurrencyPair  \\\n",
       "0       AED/EUR      AED/GBP      AED/USD      ARS/USD      AUD/BRL   \n",
       "1       AUD/SGD      AUD/USD      BRL/AUD      BRL/COP      BRL/EUR   \n",
       "2       CAD/NZD      CAD/SEK      CAD/USD      CHF/AUD      CHF/CAD   \n",
       "3       CHF/ZAR      CLP/EUR      CLP/USD      CNY/USD      COP/BRL   \n",
       "4       DKK/NOK      DKK/NZD      DKK/SEK      DKK/USD      EUR/AED   \n",
       "5       EUR/HUF      EUR/IDR      EUR/ILS      EUR/INR      EUR/ISK   \n",
       "6       EUR/RUB      EUR/SEK      EUR/SGD      EUR/THB      EUR/TRY   \n",
       "7       GBP/HKD      GBP/HUF      GBP/INR      GBP/JPY      GBP/KRW   \n",
       "8       HKD/EUR      HKD/GBP      HKD/JPY      HKD/USD      HRK/EUR   \n",
       "9       ISK/USD      JPY/AUD      JPY/BRL      JPY/CAD      JPY/CHF   \n",
       "10      JPY/ZAR      KRW/EUR      KRW/GBP      KRW/USD      KWD/USD   \n",
       "11      MYR/GBP      MYR/USD      NOK/AUD      NOK/CAD      NOK/CHF   \n",
       "12      NZD/EUR      NZD/GBP      NZD/JPY      NZD/NOK      NZD/SEK   \n",
       "13      RON/USD      RUB/AUD      RUB/EUR      RUB/USD      SEK/AUD   \n",
       "14      SGD/EUR      SGD/GBP      SGD/JPY      SGD/USD      THB/EUR   \n",
       "15      USD/AED      USD/ARS      USD/AUD      USD/BRL      USD/CAD   \n",
       "16      USD/IDR      USD/ILS      USD/INR      USD/ISK      USD/JPY   \n",
       "17      USD/RON      USD/RUB      USD/SEK      USD/SGD      USD/THB   \n",
       "\n",
       "   CurrencyPair CurrencyPair CurrencyPair CurrencyPair CurrencyPair  \\\n",
       "0       AUD/CAD      AUD/CHF      AUD/DKK      AUD/EUR      AUD/GBP   \n",
       "1       BRL/GBP      BRL/JPY      BRL/MXN      BRL/USD      CAD/AUD   \n",
       "2       CHF/DKK      CHF/EUR      CHF/GBP      CHF/ISK      CHF/JPY   \n",
       "3       COP/EUR      COP/USD      CZK/EUR      CZK/GBP      CZK/SEK   \n",
       "4       EUR/AUD      EUR/BRL      EUR/CAD      EUR/CHF      EUR/CLP   \n",
       "5       EUR/JPY      EUR/KRW      EUR/MAD      EUR/MXN      EUR/MYR   \n",
       "6       EUR/TWD      EUR/USD      EUR/ZAR      GBP/AED      GBP/AUD   \n",
       "7       GBP/MXN      GBP/MYR      GBP/NOK      GBP/NZD      GBP/PLN   \n",
       "8       HRK/USD      HUF/EUR      HUF/GBP      HUF/USD      ILS/EUR   \n",
       "9       JPY/DKK      JPY/EUR      JPY/GBP      JPY/HKD      JPY/MXN   \n",
       "10      MAD/EUR      MAD/USD      MXN/AUD      MXN/BRL      MXN/CAD   \n",
       "11      NOK/DKK      NOK/EUR      NOK/GBP      NOK/JPY      NOK/NZD   \n",
       "12      NZD/TRY      NZD/USD      PEN/EUR      PEN/USD      PHP/EUR   \n",
       "13      SEK/CAD      SEK/CHF      SEK/CZK      SEK/DKK      SEK/EUR   \n",
       "14      THB/GBP      THB/USD      TRY/CHF      TRY/EUR      TRY/GBP   \n",
       "15      USD/CHF      USD/CLP      USD/CNY      USD/COP      USD/CZK   \n",
       "16      USD/KRW      USD/KWD      USD/MAD      USD/MXN      USD/MYR   \n",
       "17      USD/TRY      USD/TWD      USD/ZAR      ZAR/CHF      ZAR/EUR   \n",
       "\n",
       "   CurrencyPair CurrencyPair CurrencyPair CurrencyPair CurrencyPair  \\\n",
       "0       AUD/JPY      AUD/MXN      AUD/NOK      AUD/NZD      AUD/RUB   \n",
       "1       CAD/CHF      CAD/EUR      CAD/GBP      CAD/JPY      CAD/MXN   \n",
       "2       CHF/NOK      CHF/NZD      CHF/PLN      CHF/SEK      CHF/TRY   \n",
       "3       CZK/USD      DKK/AUD      DKK/CHF      DKK/EUR      DKK/GBP   \n",
       "4       EUR/COP      EUR/CZK      EUR/DKK      EUR/GBP      EUR/HKD   \n",
       "5       EUR/NOK      EUR/NZD      EUR/PEN      EUR/PHP      EUR/PLN   \n",
       "6       GBP/BRL      GBP/CAD      GBP/CHF      GBP/CZK      GBP/DKK   \n",
       "7       GBP/SEK      GBP/SGD      GBP/THB      GBP/TRY      GBP/USD   \n",
       "8       ILS/USD      INR/EUR      INR/GBP      INR/USD      ISK/CHF   \n",
       "9       JPY/NOK      JPY/NZD      JPY/SEK      JPY/SGD      JPY/TRY   \n",
       "10      MXN/EUR      MXN/GBP      MXN/JPY      MXN/USD      MXN/ZAR   \n",
       "11      NOK/SEK      NOK/USD      NZD/AUD      NZD/CAD      NZD/CHF   \n",
       "12      PHP/USD      PLN/CHF      PLN/EUR      PLN/GBP      PLN/USD   \n",
       "13      SEK/GBP      SEK/JPY      SEK/NOK      SEK/NZD      SEK/USD   \n",
       "14      TRY/JPY      TRY/NZD      TRY/USD      TRY/ZAR      TWD/EUR   \n",
       "15      USD/DKK      USD/EUR      USD/GBP      USD/HKD      USD/HRK   \n",
       "16      USD/NOK      USD/NZD      USD/PEN      USD/PHP      USD/PLN   \n",
       "17      ZAR/GBP      ZAR/JPY      ZAR/MXN      ZAR/TRY      ZAR/USD   \n",
       "\n",
       "   CurrencyPair  \n",
       "0       AUD/SEK  \n",
       "1       CAD/NOK  \n",
       "2       CHF/USD  \n",
       "3       DKK/JPY  \n",
       "4       EUR/HRK  \n",
       "5       EUR/RON  \n",
       "6       GBP/EUR  \n",
       "7       GBP/ZAR  \n",
       "8       ISK/EUR  \n",
       "9       JPY/USD  \n",
       "10      MYR/EUR  \n",
       "11      NZD/DKK  \n",
       "12      RON/EUR  \n",
       "13      SGD/AUD  \n",
       "14      TWD/USD  \n",
       "15      USD/HUF  \n",
       "16         None  \n",
       "17         None  "
      ]
     },
     "execution_count": 14,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "quotes_response = quotes_api.list_quotes(scope=scope, filter=f\"QuoteId.EffectiveAt eq 2020-03-23\", limit=5000)\n",
    "quotes_df = lusid_response_to_data_frame(quotes_response, column_name_mapping=json_mappings)\n",
    "unique_ccy_pairs = sorted(quotes_df[\"InstrumentID\"].unique())\n",
    "pd.DataFrame(np.array_split(unique_ccy_pairs, 18), columns = ([\"CurrencyPair\"] * 16))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Get a time series of GBP/EUR for past 3 months\n",
    "\n",
    "You can use Python's plotting packages to plot a time series of quotes for a given currency pair between dates 27 December 2019 and 27 March 2020."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [],
   "source": [
    "currency_pair = \"GBP/EUR\""
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [],
   "source": [
    "response_filter = f\"QuoteId.EffectiveAt gte {start_date} and QuoteId.EffectiveAt lte {end_date} and QuoteId.QuoteSeriesId.InstrumentId eq '{currency_pair}'\"\n",
    "quotes_response_all = quotes_api.list_quotes(scope=scope, filter=response_filter)\n",
    "quotes_df = lusid_response_to_data_frame(quotes_response_all, column_name_mapping=json_mappings)\n",
    "quotes_df[\"EffectiveAt\"] = pd.to_datetime(quotes_df[\"EffectiveAt\"].str[:10], format='%Y/%m/%d')\n",
    "quotes_df.set_index(\"EffectiveAt\", inplace=True)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.legend.Legend at 0x7f2a4596cb70>"
      ]
     },
     "execution_count": 17,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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gSYh/lvUDzDEEBERERH5Lds2y7YhZv15aT1MXz+fhQEYYoiIiIiI/Fa0VYcy67oYURTxx3lpPUzfeP+uhwEYYoiIiIiI/JZ1XYz1TMyJPCPOFJRvgqmSAz3jAjwyNndiiCEiIiIi8lNVtVleZ7WUrEesChqF/0cA//8KiIiIiIjqKds2yybJ8TqrpWT+3pWsDEMMEREREZGfcrScTG8SseWStLVyvzpQDwMwxBARERER+S2bwn59eYjZflmPogq9lRtpZGgd7t+tlcswxBARERER+SlHLZb/sKqHuTE+EIIgoC5giCEiIiIi8lOOCvut62HqylIygCGGiIiIiMhvVVbYf7HIhEM5Rst5mQBc36huFPUDDDFERERERH7LeiYmU2eGKIo2szDXRQcgXFV33vrXna+EiIiIiKie0SgEVKztLzEDBUYR623qYerOLAzAEENERERE5LcEQbDpUHalyIz1VjMxfetQPQzAEENERERE5Nes62L+OK+DtqS8tXJ4gIBro5WeHpZbMcQQEREREfkx6zbL358okhzf0CgQclndaK1chiGGiIiIiMiPWRf37800SI77JtStehiAIYaIiIiIyK9ZLyezdmOjulUPAzDEEBERERH5NevC/opSwhVoFFT57f6KIYaIiIiIyI85monpm1D3ZmEAhhgiIiIiIr/mMMTUsf1hyjDEEBERERH5MevC/jIahYBuDRhiiIiIiIjIx1i3WC7TKy4AgYq61Vq5DEMMEREREZEfq2wm5sb4ulkPAzDEEBERERH5tXCVDHI7Ey796mg9DMAQQ0RERETk12SCgEirJWWJwXIkhSq8NCL3Y4ghIiIiIvJz1h3K+sUHQhDqZj0MwBBDREREROT3GmqkG1reWIeXkgEMMUREREREfu/uZI3lz63CFOhfRze5LFN3F8oREREREdUTtzfXoEmwAifzjRiQGIgAe5X+dQhDDBERERFRHdC5QQA6Nwjw9jA8gsvJiIiIiIjIrzDEEBERERGRX2GIISIiIiIiv8IQQ0REREREfoUhhoiIiIiI/ApDDBERERER+RWGGCIiIiIi8isMMURERERE5FcYYoiIiIiIyK8wxBARERERkV/xaoiZO3cu0tLSEB0djalTp1Z6ndlsxqRJk5CYmIjk5GTMnj1bcvvly5dx3333ITExEc2aNcObb77p7qETEREREZGX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7uTl5Rmc+Ok9qXZ3797N+++/T2xsrNk/hwpVj9fa2prly5eTkpLCiRMnaNGiBb179zYw7bPz8O9UFhYW9eJ3rCddd8v9lOuQmpindOvWLWJiYigoKKC4uJivvvqKhIQE+vXrh6+vLxs2bODChQtcu3aNiIgIs/8rWNOmTRk5ciShoaHcuXOHffv2cfr0aX79618zZcoUoqKiuHDhArdv3+ajjz7ilVdeMTpytRQXF3P37l1KSkooKSkxfb1v3z7OnTtHWVkZ2dnZ/PGPf2TQoEFGx622OXPmcOXKFTZu3IilpaVpeX08l6Hy8cKPP2hjYmLqxTih6trdvn07mZmZwI9zlFesWGH253NltTthwgS+/vprjh8/zq1btwgLC6sX3+PKxlsuOjq6Xoyz3ONq187OjtTUVBISEkhISODjjz/G0dGRhISER6YnmZOqavfQoUPMnj2bLVu2mP2zMOWqGm9WVhZXrlyhtLSU5ORkwsLCCA4ONjpytVRWu76+vuzdu5eTJ09SVFTEsmXLGDhwoNnfaavsulud65BFbm6ueX/og0Hy8vKYMmUKJ0+eBMDV1ZXg4GDTW+WtWLGCVatWUVJSwtSpU/nggw/MvpO+fv06M2fO5MiRIzg4OBAWFmZ627/Vq1cTHh5OUVER3t7eLFu2zKz/ih0aGvrIWydHRERQUlJCWFgYP/zwA7a2tnh7e7NkyRJatGhhUNLqy8jIoHv37lhZWdGwYUPT8piYGPr161fvzuUnjffQoUO88cYbnD17lkaNGhmYtOZUVrvLli1jw4YN5Obm0qJFC8aMGcPvf/97rKysjI781CqrXX9/f6KiovjTn/5Efn4+Pj4+fPTRR6Z3mDRXVY33woULvPTSS6SkpNSLZ52eVLvlEhISePvtt/n3v/9tRMwaVVntjho1iqNHj1aoVV9fX7P/vJjKxnv48GFmzZrFjRs3cHV1ZdGiRQwfPtzouNVSVe1u27aNRYsWcevWLfr27Ut4eLhZT5+rqnaPHDny1NchNTEiIiIiImJWNJ1MRERERETMipoYERERERExK2piRERERETErKiJERERERERs6ImRkREREREzIqaGBERERERMStqYkRERERExKyoiREREREREbOiJkZERERERMyKmhgRERERETEramJERERERMSsqIkRERERERGzoiZGRERERETMipoYERERERExK2piRERERETErKiJERERERERs6ImRkREREREzIqaGBERERERMStqYkRERERExKyoiREREREREbOiJkZExIx169aNo0ePGh1DRESkVqmJMYh+8RCRx+nWrRtt27bF0dERR0dH3N3djY4kIjWgW7duODg4UFhYaFp2+/Zt2rVrR7du3QxMJmKe1MSIiNQx27ZtIysri6ysLP7zn/8YHUdEakjbtm3ZvXu36fWePXuwt7f/yccpLi6uyVgiZklNjMG+/fZbhgwZgpOTE56enqxZs8a0LjQ0lOnTpzN16lTatWvHyy+/zIULF4wLKyKGyMzMxNfXF1dXV/r06UN8fHyF9cnJyfTu3RtXV1fef/99SktLDUoqIlUZP348MTExptdbt25l4sSJptdhYWF4enri5OTEsGHDOHXqlGldt27dWLlyJX369KFnz561mlukLlITYzBLS0vCw8O5ePEimzdv5s9//jMnTpwwrd+1axdvvvkmFy5coGPHjnz44YcGphWR2lZaWoqfnx9Dhw7l3LlzrFq1ihkzZnDt2jXTNrGxsezZs4fExETi4+P5/PPPDUwsIpUZNGgQKSkpXL9+nevXr3P69Gm8vLxM6zt16sTBgwdJT0/Hy8uLwMDACvvv3LmTXbt2kZycXMvJReoeNTEG69GjBz169KBBgwb07NmTYcOGkZSUZFo/aNAgBg0ahKWlJePHj6/wVxkRqZ8mTpyIs7Mzzs7OjBkzhrt37xIYGIilpSV9+vShf//+7N+/37R9YGAg9vb2tG3bllmzZrF9+3YD04tIZRo2bMjo0aPZtm0b27Ztw8fHh4YNG5rWjx49mlatWtGoUSOCg4M5ffo0BQUFpvWBgYG0adMGa2trI+KL1CmWRgf4X5eamsqCBQv47rvvKCoq4u7du3Tq1Mm0vk2bNqavra2tKzwQKCL1U0xMDH379gVg+/btTJ8+HWdnZ9P6kpISevToYXrdrl0709eOjo5cvXq11rKKyE/j6+vL/PnzKSsrY+nSpZSUlJjWbdy4kcjISC5fvgxAWVkZN2/epGnTpgA4ODgYklmkLlITY7B58+bRt29ftmzZgrW1NW+++SZlZWVGxxKROqJt27a4u7uTmJhY6TaXLl0yfZ2VlfVUDwqLSO3o2bMnOTk5APTq1Yt//vOfAFy8eJEFCxawe/duXnzxRe7du4eDg0OF3wksLCwMySxSF2k6mcEKCgqws7PDysqKxMRE4uLijI4kInXIz3/+c8rKyli/fj3379/n/v37JCYmkpmZadpm7dq1XLt2jStXrhAZGcnYsWMNTCwiT7J582Y2b95cYVlhYSENGjSgZcuWFBcXExoaalA6EfOgJsZAFhYWfPDBB6xbtw4nJyciIyMZMWKE0bFEpA6xtLQkOjqaAwcO0LlzZzw8PAgLC6vwDmRjx45lxIgR9O3bFy8vL/z9/Q1MLCJP4uHhgYeHR4VlXbp0ISAggAEDBtC9e3fat29P48aNDUooUvdZ5Obmau6SAdzc3Ni3b58+yE5ERERE5CfSnRgDHD58mNLS0goP6oqIiIiIyH9HD/bXsjlz5nDgwAFWrlyJlZWV0XFERERERMyOppOJiIiIiIhZ0XQyERERERExK2piRERERETErKiJecbu3btHUFAQnp6eODk54e3tTXJysml9eHg4HTp0wMXFhT/84Q+mD7U6d+4ckyZNokOHDri5ufHqq6+SnZ1t2u/OnTu89dZbtGvXDk9PT2JjY2t9bCIiIiIiRlAT84wVFxfj7OzM3r17uXjxIjNnzsTPz4+CggLi4uJYt24d8fHxJCUlER8fb/rwq7y8PHx8fDh27Bipqak4ODgwa9Ys03FDQ0O5ceMGKSkpfPbZZwQHB3Pu3DmjhikiIiIiUmv0YL8BPDw8+PLLL/nkk0/w8PBg3rx5AERFRREVFcWePXse2SctLQ0vLy8uXboEwAsvvMCGDRvo27cvADNnzsTJyYmFCxfW3kBERERERAygOzG17Pz58+Tk5ODq6sqZM2fo2rWraV3Xrl05c+bMY/dLTEw0fbpvbm4uV69erbBvly5dKt1XRERERKQ+0efE1KLy51jmzp2LnZ0dhYWFNGvWzLS+WbNmFBYWPrJfeno6S5YsYf369QAUFBSYti9na2v72H1FREREROob3YmpJUVFRQQEBODm5sb8+fMBsLGxIT8/37RNfn4+NjY2FfbLzs5m7NixvPfeewwePBiApk2bmrYvl5eX98i+IiIiIiL1kZqYWlBaWsqMGTMAiIyMxMLCAvjx2ZiUlBTTdikpKaYpYwA3btzgN7/5DQEBAbzxxhum5c2bN8fe3r7CvqmpqRX2FRERERGpr9TE1II5c+Zw5coVNm7ciKXl/8/g8/X1ZcOGDVy4cIFr164RERGBn58f8OOdlXHjxjF8+HDmzp37yDF9fX35y1/+Qn5+PseOHWPPnj1MnDix1sYkIiIiImIUPRPzjGVkZLBp0yasrKzo0KGDaXlMTAzDhw/n9OnTDB06lJKSEqZOncprr70GwK5duzhx4gRpaWmmZ2EAsrKyAFi4cCFvv/02Hh4eNG/enOXLl9OpU6faHZyIiIiIiAH0FssiIiIiImJWNJ1MRERERETMipoYERERERExK2piRERERETErKiJERERERERs6ImRkREREREzIqaGBERERERMStqYkRERERExKyoiREREUNERUXRvHlz0z97e3s8PDwYN24cq1evJj8//6mOe+bMGUJDQ7l48WINJxYRkbrC0ugAIiLyvy0kJARXV1eKioq4du0aR44cYcGCBURERLBlyxY8PT1/0vHOnj3L0qVLGTBgAO3bt39GqUVExEhqYkRExFAvv/wyL730kun1O++8w6FDh/Dz82Py5MkkJydjbW1tYEIREalrNJ1MRETqnMGDBzNv3jwyMzPZunUrAKdOnWLWrFn06NEDe3t73NzcmDZtGpmZmab9oqKimDp1KgA+Pj6mqWpRUVGmbf71r38xceJEnJ2def755/nVr37F4cOHa3eAIiJSLWpiRESkTpo0aRIAf//73wH45ptvSEtLw8/Pj2XLlvH6668THx/PqFGjuH37NgD9+/dnxowZAAQHB7NmzRrWrFlD//79AThy5AgjRowgJyeHefPmsXjxYu7du8e4ceNISEgwYJQiIvI0LHJzc8uMDiEiIv97oqKiCAoKYv/+/RWmkz3I2dkZFxcXDh8+zO3bt2nSpEmF9UlJSQwfPpw1a9aYmp4dO3YwdepUdu7cycCBA03blpWV0adPHxwcHPjqq6+wsLAA4P79+wwaNAhbW1vi4uKe0WhFRKQm6U6MiIjUWU2bNqWgoACgQgNTUFDAzZs36dixI3Z2dhw/fvyJx/ruu+84d+4cEyZM4ObNm9y4cYMbN26Qn5+Pl5cX3377remOjoiI1G16sF9EROqsgoICWrVqBUBubi6LFy9mx44d5OTkVNguLy/vicc6f/48ALNnz2b27NmP3ebmzZuP3O0REZG6R02MiIjUSVlZWeTl5eHm5gZAQEAASUlJBAUF0b17d5o1a4aFhQXTpk2jtLT0iccr32bx4sX06NHjsduUN0wiIlK3qYkREZE6KTo6GoChQ4eSm5vLwYMHCQkJISQkxLTN3bt3yc3N/a+O5+rqCvw4Rc3Ly6um44qISC3SMzEiIlLnHDp0iOXLl9O+fXt8fX1p0ODHy1VZWcX3ovn0008fuQtjY2MD8Ehz06NHD9zc3IiIiCA/P/+R/+b169drcAQiIvIs6U6MiIgY6sCBA6Snp1NcXMwPP/zA4cOH+eabb3BycmLLli1YWVlhZWXFgAED+PjjjykqKsLJyYmjR4+SmJhIixYtKhyve/fuNGzYkPDwcG7duoW1tTW9e/fGxcWFTz75hAkTJvDLX/4Sf39/HB0dyc7O5h//+AdlZWXs2rXLoP8LIiLyU6iJERERQ3344YcANG7cmOeee44uXboQGhqKv78/zZo1M223bt06QkJC+OyzzyguLqZfv358/fXXjBkzpsLx2rRpw8qVK1mxYgW/+93vKCkpISIiAhcXF/r378/+/ftZvnw569evJz8/nzZt2tCrVy9ef/31Wh23iIg8PX1OjIiIiIiImBU9EyMiIiIiImZFTYyIiIiIiJgVNTEiIiIiImJW1MSIiIiIiIhZURMjIiIiIiJmRU2MiIiIiIiYFTUxIiIiIiJiVtTEiIiIiIiIWVETIyIiIiIiZuX/AMyQC17BpmV0AAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<Figure size 864x648 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "timeseries = quotes_df.plot(y=[\"Value\"], figsize=(12,9))\n",
    "timeseries.set_title(f\"Time series of {currency_pair} FX Spot rate\", fontsize=\"large\")\n",
    "timeseries.set_ylabel(f'{currency_pair} price', fontsize=\"large\")\n",
    "timeseries.set_xlabel('Date', fontsize=\"large\")\n",
    "timeseries.legend(prop={'size': 12})"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}