{ "cells": [ { "cell_type": "markdown", "id": "8e5c727b", "metadata": {}, "source": [ "# Implied Future & Discount From Option Prices\n", "\n", "This notebook computes the implied underlying future from option prices of a *single expiry*.\n", "\n", "* Computes an **implied future ** $F$ and a **discount range** $D$ that are **jointly consistent** with the quoted calls & puts.\n", "* Identifies and **excludes the fewest possible strikes** whose quotes prevent any consistent solution (likely stale/misquoted lines).\n", "* Visualizes per-strike **implied futures**." ] }, { "cell_type": "code", "execution_count": null, "id": "a7950be2", "metadata": {}, "outputs": [], "source": [ "%matplotlib inline\n", "import matplotlib.pyplot as plt\n", "plt.rcParams[\"figure.dpi\"] = 120\n", "\n", "from volkit import estimate_future_from_option_prices\n", "from volkit.datasets import spxw" ] }, { "cell_type": "markdown", "id": "c7191e82", "metadata": {}, "source": [ "Read a set op example option quotes. Weekly S&P options with 7 days to expiry. Use only quotes that have been trades at least once (min_vol=1)" ] }, { "cell_type": "code", "execution_count": 2, "id": "3ecb31a6", "metadata": {}, "outputs": [], "source": [ "df = spxw(min_volume=1, D=7)" ] }, { "cell_type": "code", "execution_count": null, "id": "535154b7", "metadata": {}, "outputs": [ { "data": { "text/html": [ "
F2918.894392
F_bid2918.846423
F_ask2918.939470
D0.999803
D_min0.99900000
D_max1.00000000
" ], "text/plain": [ "ImpliedFutureResult(F=2918.8944, F_bid=2918.8464, F_ask=2918.9395, D=0.9998, D_min=0.999000, D_max=1.000000)" ] }, "execution_count": 3, "metadata": {}, "output_type": "execute_result" }, { "data": { "image/png": "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tcY2UkLsZc2aVV544QXNzf7yyy+T2shPRERERBQywhCl+/tm3HAHd6jEDYRcmTJliowePVrOnTuXlGWkZBAVFaXVYVASEvXZiYiIiMga8VSSqrjgNvWosOKqpCDKCX799desMEJERERE5IMkpbigkgruuonqIqgsgrtgwsGDB7UaCcoUdu/eXUsM2qtevXpSPpaIiIiIKGglKUBHyT/T9u3bJSwsTP9vnzVjPw2GYxpPN/ohIiIiIgplSQrQZ8yYEbglISIiIiKipAXovXv3DtySEBERERFR0jqJEhERERGRhVrQ4ejRo3pb+8OHD8vFixcd8s8BOefff/99Uj+GiIiIiCgkJClA/+qrrzTNBSUVc+XKJTlz5kwwjdlxlIiIiIiIkjlAf+mll6R8+fKyaNEiKVu2bFJmRURERERESc1Bxx1C+/fvz+CciIiIiMgKAXrt2rXl2LFjgVoWIiIiIqKQl6QA/YMPPpA5c+ZoigsREREREaVyDvq9994r48aNk65du0rWrFnlrrvuknTp0iXoJLpnz56kLicRERERUUhIUoA+depUGTJkiGTKlElKlSrlsooLERERERGlUID+5ptvSr169WTp0qUMzomIiIiIUjsHPSYmRrp3787gnIiIiIjICgF6w4YNZe/evYFaFiIiIiKikJekAP3jjz+WdevWyYQJE+T8+fOBWyoiIiIiohCVpAC9YsWKcuTIEb2jaIECBbSSS44cORweTH8hIiIiIkqhTqKPPfaYllEkIiIiIiILBOgzZ84M0GIQEREREVGSU1yIiIiIiCiVW9B37drl84dUr17d5/cQEREREYUinwP0mjVrep13bhiGTnvnzh1/lo2IiIiIKOT4HKDPmDEjeZaEiIiIiIh8D9B79+6dPEtCRERERETsJEpEREREZCUM0ImIiIiILIQBOhERERGRhTBAJyIiIiKyEAboREREREQWwgCdiIiIiMhCGKATEREREVkIA3QiIiIiIgthgE5EREREZCEM0ImIiIiILIQBOhERERGRhTBAJyIiIiKyEAboREREREQWwgCdiIiIiMhCGKATEREREVkIA3QiIiIiIgthgE5EREREZCEM0ImIiIiILMSyAfr27dtl8ODBUqlSJcmaNasUK1ZMOnfuLAcOHEgw7eTJk6VChQqSMWNGKVq0qDz//PNy7dq1BNONGzdO2rZtKwULFpSwsDB57bXX3H7+qlWrpHHjxpIvXz7JlSuX1KpVS2bPnu3VssfHx8snn3wi1apVk2zZsunntWrVSn799Ve/17FPnz66zM6P8uXLe7VMRERERJQ2RIhFjR8/XjZt2iSdOnWSKlWqyOnTpzUQr169umzZskUqV66s040cOVImTJggHTt2lKFDh8q+fftk0qRJEhUVJStWrHCY56uvviqFChWS++67L8E4e0uWLJH27dtL3bp1NYhHIPz1119Lr1695Ny5c/Lcc895XPYXXnhB3nvvPenRo4cMHDhQLl26JNOmTZOGDRvqOiHY92UdTTgB+eyzzxyG5cyZ0+dtS0REREQWZljUpk2bjJs3bzoMO3DggJExY0aje/fu+vrkyZNGRESE0bNnT4fpJk2aZGDVlixZ4jD8yJEj+hwdHa3jR48e7fKzmzdvbhQpUsSIjY21DYuLizNKlSplVKlSxeNyY7rMmTMbHTt2dBh++PBh/cxnnnnGp3U09e7d28iaNasRKJGRkbo8eCYiIqLgdudOvLE88pQxcM5Oo/2UjfqM1xhO1ounLJviUq9ePcmQIYPDsDJlymg6yP79+/X15s2b5fbt29K1a1eH6czX8+fPdxheokQJrz778uXLkjt3bm2xNkVERGi6S+bMmT2+Ny4uTm7cuKFpLfYKFCgg4eHhDu/3Zh2d3blzR5ePiIiIyBvx8YaMXhIlLyzaIyv3nZbIEzH6jNcYjvFkLZYN0F0xDEPOnDmjgTLcvHlTn52D5ixZsujzzp07/fqcRo0aaYrMqFGj5NChQ/LXX3/J66+/Ljt27JARI0Z4fC+WpXbt2jJz5kyZO3euHDt2TH7//XfNIUfQ369fP5/W0d7169clR44cmtaSJ08eGTRokFy9ejXR9Tl79qyuj/0D60VERETBb+X+M/L9nhNyKy5ecmROL7mzZNBnvMZwjCdrsWwOuisIeE+cOCFjx47V1+XKldNn5HGjQ6dpw4YN+oxp/YHA/MiRI9qp9I033rAF/d988420a9cu0ffPmTNHunTpojnoppIlS+py4tmXdTQVLlxYTw6Qn45OqMuXL5epU6fKnj17ZO3atdrC7w6mGzNmjBdrTkRERMFmye6TEnvrjgbl4WFhOgzP2TJFyOUbcTr+oUqFUnsxKS0G6H/88Ye2GKPjZu/evXUYglW0VqOzJaq3IEhHasiAAQMkffr0mmriD6S2lC1bVjuedujQQdNKPv30Uw24V65cKXXq1PH4/uzZs2uaCpa1adOm2vnz7bff1o6nOHlw1Trubh1Nb731VoI0HizjK6+8IosWLUqQ5mMPHVXREdUeWtCxPERERBTcTsbcECSxmMG5Ca+Nf8eTtaSJAB0BbuvWrTW1A8FounTpbOPQqo3W6r59++prjEOZxXXr1smff/7p1+eh9CGqqOzatUvzxgHlDxF0o1LM1q1b3b4XOfHNmjXTNBlUkzFhGN4/ceJEPaHwZR3dQTUZtPajJKSnAB3573gQERFR6CmSM7NEnYiReMNwCNLxOuzf8WQtls9Bj4mJ0RriKFWItI4iRYo4jEfL+caNG7V2+Pr16+Wff/7RsovHjx/XFmZf3bp1Sz7//HMNls3gHNAij+VAHjqmcQfLEBkZqfXWnTt/olY70lx8XUdP+e558+aVCxcu+LSOREREFDraVisimTKkk6uxtzUoBzzjNYZjPFmLpVvQY2Nj5ZFHHtHgG63EFStWdDstAmA8ALXQT506pR0zfXX+/HltBUdai6sKLcj/djXOhA6e4O79mLe/6+jsypUrWpc9f/78Xr+HiIiIQkvzCgWlXdWi2iEUOecI0dFyjuAcwzGerMWyLegIcJG6glKKCxcu1LxsbyCARmdKdOrs37+/z5+LVBDcOfS7775zaClHtZQffvhB79xpXzUGeeOo1GIyW+2dSzwiXQYpN7hJkq/riCAewbgzVJZB1ZeWLVv6vJ5EREQUGsLDw2RM20oysWNVaV6xkFQumlOf8RrDMZ6sxbIt6MOGDdM7eqJ1GSkcqIxiz6yQgpxwBLDVqlXTFup58+bJtm3bZNasWVKsWDGH98yePVuOHj2q5QrNdBSzSkvPnj2lePHimvs9fPhwvesoOoPi7qEIpJH2gvQZ5+VA2gruEIpKKlCjRg1p3ry5fj7qlbdo0UJb85GPjsD+2Wef9XkdkZ+OwL5bt256ggC4E+qyZcs0OPemsgwRERGFLgThqNTCai1phGFRDRs21DszuXuYZsyYYVStWlXvspk9e3ajadOmxurVq32e55o1axymnTt3rlGrVi0jV65cemfQ2rVrG4sWLUowT7wX87V3/fp1Y+zYsUbFihX1vTlz5jTatGlj/Pbbb36t48WLF40ePXoYpUuXNrJkyaJ3Gq1UqZLx5ptvGrdu3fJr+/JOokRERERJk1zxVBj+Se2TBEp5uFlR5cqVtUMrqssQERERkTXiKcumuBARERFR2hQfb+gdSnETJNRZRylHVItBh1TmvCeOATol2ukWlWlu3ryp/yeiwAsLC9NSrjly5NAbneE1EVFaDs5HL4nSqjG4gylSNVCHfcOhaK0aw46pabiKC6U+BOSoUIP67Khow2woosDD9wrlV1Gp6cSJE/qdcy7HSkSUlqDlHMH5rbh4yZE5veTOkkGf8RrDMZ48Yws6uYWW8xs3bkiePHm0/CRb9YiSD4Lys2fP6o3LLl68yPsbEFGahbQWtJwjKDfvXIrnbJkitA47xrOajGdsQSe3kNaCspMMzomSX0REhBQuXFi/c7jvAhFRWoWcc1xzN4NzE14b/44nzxigk8cUFwQLDM6JUga+a/jOMZ2MiNIydAhF5BDvdCzD67B/x5NnDNDJIwbnRCmL3zkiSutQrSVThnRyNfa2LUjHM15jOMaTZwzQiYiIiChgUEoR1VoypA/XnPOL12/pM15jOMaTZ+wkSkREREQBgxKKKKVYv0w+1kH3E1vQiYJMo0aN9GFau3atpk0sWrRIrNzfAXdiGzdunG3YzJkzdbn//vtvn+dnrjOeTX369JESJUpIStu3b592AMVd5oiIQgWCcFRqmdK9unw38AF9xmsG595hgE5kUSdPnpTXXntNdu/eLVaH5URA7OrxySefJPr+r776So4fPy6DBw+WYFOxYkVp3bq1/Pe//03tRSEiojSCKS5EFg7Qx4wZo62+1apV8/p9P//8s6SWjz/+WLJly+YwrHbt2om+b+LEidK1a1fJmTOnbVjPnj11WMaMGQOybNOnT0+1u+H2799fHn74Yfnrr7+kVKlSqbIMRESUdjBAJ0pG169flyxZsqToZ2XIkEFSS8eOHSVfvnw+vee3336TPXv2yLvvvuswHOUG8QiU9OnTB2xeKIMYGxsrmTN7VyqsWbNmkjt3bpk1a5aMHTs2YMtBRETBiSkuFJLMlIw//vhDOnfuLDly5JC8efPK0KFDNfByNmfOHKlRo4YGZLizKlp2kZJhD3nfyKPeuXOnPPjggxosv/zyy26XYeXKlVK/fn3JlSuXtjqXK1fONj1yp++//379/xNPPGFLF0FedmKf5ZyD7u4mVG3atNEW619//VWHoXX5gw8+kEqVKkmmTJmkYMGC8vTTT+tdLZPT4sWL9aQC62HPVQ46riZguTdu3Ci1atXS5SxZsqR8+eWXiX6Oqxx0b9fZ/NwVK1ZIzZo1dT+YNm1aon9H+5MD/E2+//57v7YRERGFFragU4qKjzdk5f4zlunVjeAcwddbb70lW7ZskY8++kiDM/uADx0XR40apdM++eSTEh0dLZMmTdKAEq2/CMxM58+fl1atWmkA36NHDw34XImKitKAr0qVKtqiijSOQ4cOyaZNm3R8hQoVdDjylvv16ycNGjTQ4fXq1fP5s5zduHFD2rVrJzt27JBVq1bZTgQQmCIoxgnBM888I0eOHJHJkyfrOmK5vGmBvnDhgsNrtICj5dgTnCDgZMPbFm5sJ7TU/+c//5HevXvLF198ocE3TqAQaPvCl3X+888/pVu3bvqep556SgPxxP6O9rB8CNAvX76sJ4RERETuMECnFA3ORy+Jku/3nJDYW3f0dr9RJ2Jkw6ForYuKkkwpHaTfc889tlbNQYMGaeA0depUGT58uAZdR48eldGjR8sbb7zh0CraoUMHue+++3Ra++GnT5/WTpEI4jxBq+utW7fkp59+cpkSgmAbwTcC9Lp162oA7szbz7KHW8gjoERguXr1altuO1qkP/vsM5k7d648/vjjtukbN24sLVu2lIULFzoMdwdBq73ixYsnWoUFVzG8yVO3D5TXr19vO2nBidPdd98tM2bMkHfeecfr+fi6zgi8ly9fLg899JBtGFrfPf0d7aGlHy32WF+0/hMREbnDFBdKMWg5R3B+Ky5ecmROL7mzZNBnvMZwjE9pCMrtDRkyRJ+XLVumz99++60GVQgCz507Z3sUKlRIypQpI2vWrHF4P1pQ0RqbGLPVHScH/nZc9PazTDExMdKiRQsNEJFCY9/xFMEo0l2aN2/usJ5o9UXahvN6uvPNN9/oyYf5QPCbGFwJSKyV3bkqihmcQ/78+fXE4PDhw+ILX9cZJ3P2wbmvf0dzHfEZREREnrAFnVIM0lrQco6gPPzf25njOVumCL3DGMajRmpKQpBtDxU2wsPDba2+Bw8e1A6BztOZnNMyihYt6tBJE0ExUkpMGIcc9i5dumjrLVJmXnzxRWnatKm2yiN1A5/vDefPSsyzzz6r+fVI33BOBcF6YlkLFCjg8r1nz5716jOQ9uNrJ1HANvZWsWLFXAa/vubK+7rOCNCd+fJ3NNcRefVERESeMECnFIOcc4QoZnBuwmvj3/GpzTl4QqsohiGFwVVFEeeSgs5VPdDpFJU7TA0bNtTWa0yHNA200v7444+aOrFgwQJp0qSJlkn0pnqJtxVETMg7nz9/vrz99tuaY28fQGI9Eai6a/FGK3VyQedcX4Jrd9vGlyDfn3V2tb19+Tua6+jPCQwREYUWBuiUYtAhFDnn8YbhEKTjddi/41MaWlHtW0aRZ4zAzaz2gRZ1BH6YpmzZsj7Pf8SIEQ754/apHAiQ0eKKx3vvvSdvvvmmvPLKKxrsoSxfoFta27dvryku6FCZPXt2rVluwnqiw+gDDzzgc+CfVOXLl9fOmSktUOuc2N/RhHXEtP7sR0REFFqYg04pBtVaMmVIJ1djb2tQDnjGawzH+JQ2ZcoUh9eozgLooAlIV0ArKG4Y5NxCi9fIn04sXxpBmvlAfrOraidg5oSjBCJkzZpVny9duiSB0qtXL61Ug86lI0eOtA1Hjv2dO3fk9ddfT/Ce27dvB3QZnKETbGRkpG29U0og1tmbv6MJJTGRWmR/MyYiIiJX2IJOKQalFFGtBR1CkXOOcBdtxAjOMRzjUxpaNdu2batVOzZv3qz1zlG5o2rVqrZWVlRweemllzQvHa3QaH3G+7777jstgYiKL75CST6kRuAW8Kh0gnxnVIS56667tKa2+dnohIhgGp+JgB3VTlzlQvti8ODBWuoPrbwIFlGFBqk3qAaDcpO7d+/Wlnbk1+MKAzpTfvjhh5pXnRyQeoMged26dfq5KSUQ6+zN3xHi4uJ0/QYOHJgCa0ZERGkdA3RKMSihiFKK9cvks0wddOQLo5QhOvhFRERo8IrbztvDOKQlvP/++9qSDijrh4AOwb0/8D4E/KjhjaoeyEtGwIj5my2sCBaRv46TA9wqHq26KCWY1AAdEJSjg6QZpKOaDU4E0MKPG/BgPLYHUn2QooM0kOSCz0RJy6+//jpFA3RI6jp783eEX375RVvbUbediIgoMWGGrz2rKCigDjZuDoPUAnc3dzHL1qF+czDeSRRBFG46xE57qW/27Nl6knDs2DGHGz8FC1x5QZ8CXHVJTDB/74iIQjGe8gdz0Iko1XXv3l3LJzr3CQgG+/fvl6VLl7rMdSciInKFKS5ElOpQ3QStD8GoQoUKmp5ERETkLbagExERERFZCAN0CknIQUf3C+afExERkdUwQCciIiIishAG6EREREREFsIAnYiIiIjIQhigExERERFZCAN0IiIiIiILYYBORERERGQhDNCJiIiIiCyEAToRERERkYUwQCdKgj59+ki2bNm8mjYsLExvkJQYTINpiYiIKDQxQKeQNXPmTA2EXT1efPHF1F48IiIiClERqb0ARKlt7Nixcs899zgMq1y5csA/58aNGxIRwa8cERERecZogUJeq1atpGbNmsn+OZkyZUr2zyAiIqK0jykuRAFw+PBheeihhyRr1qxSpEgRbZU3DCPRHPSNGzfK/fffr8F7qVKlZNq0aSm85ERERGQ1bEGnkBcTEyPnzp1zGJYvXz6v33/nzh1p2bKl1KlTRyZMmCDLly+X0aNHy+3btzVQd2fv3r3SokULyZ8/vwbumB7vK1iwYJLWh4iIiNI2BujkFwSVrlSvXl1WrFih/1+1apV069bN5XQvvPCCjBgxQv//8ssvy/Tp011Oh2C3Ro0a+v/atWtrS7W96OhoSapmzZolGObc+u1JbGysBugfffSRvh44cKA88sgjMn78eHnmmWfcBvv//e9/9XM2bNggxYoV02GPPfaY3HvvvX6vCxEREaV9DNAp5E2ZMkXKli2bpHkMHjzYIZUFr3/88Uc9SenatavLVnecyLRv394WnEOFChU0VWbZsmVJWh4iIiJKuxigk1+8ablGy7Q307355pv6SMzWrVslOdSqVStJnUTDw8OlZMmSDsPMgP/vv/92+R5sF1R1KVOmTIJx5cqVY4BOREQUwizbSXT79u3aClmpUiXteIdWxs6dO8uBAwcSTDt58mRtecyYMaMULVpUnn/+ebl27VqC6caNGydt27bVHN/EbhqDls/GjRtrekKuXLk0iJs9e7ZXyx4fHy+ffPKJVKtWTW9ig89DpZBff/01wbQ3b96UkSNHasfCzJkzaxrHypUrXc4X769fv75kyZJFChUqpOkTV69e9WqZiIiIiChtsGyAjvzdb775Rpo2bSoffvih9OvXT9avX685zpGRkbbpENwOGTJE61ZjOuTwTpo0STp06JBgnq+++qoG/vfdd5/Hz16yZIl23rt165YG8QjsETz36tVL3n///USXHfnVAwYM0Fzi9957T4YNG6YnFg0bNpRt27YluBMlpunevbsuf7p06eThhx/W6h72du/erdvi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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Compute mid prices\n", "C_mid = (df['C_bid'] + df['C_ask']) / 2\n", "P_mid = (df['P_bid'] + df['P_ask']) / 2\n", "\n", "res, valid_mask = estimate_future_from_option_prices(\n", " df['K'], \n", " C_mid, \n", " P_mid,\n", " plot=True\n", ")\n", "\n", "res" ] } ], "metadata": { "kernelspec": { "display_name": "volkit-eeDo8oXc-py3.11", "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.11.8" } }, "nbformat": 4, "nbformat_minor": 5 }