mirror of
https://github.com/OpenBB-finance/OpenBB.git
synced 2026-11-01 23:12:21 +00:00
* implement user and change is guest * replace User methods * move remaining functions to user * fix bug * portfolio test * fix tests * fix tests * uncomment skip * ruff * start credentials model implementation * change deault structure * refacto quandl * change default struct and file names * bug * start using global user * add comments * move update flair * change cfg references in keys model * reddit & fmp * refactore additional keys * remaing config keys * remove unsude imports and fix hub keys * ruff * fix line too long * unblock unittests * fix keys model tests * remove os patch * fix account controller tests * fix account controller tests * fix account model * account fixed * fix user tests * User Model * User Model * User Model * Move session folder * User Model : grouping the models * User Model : fix bugs * Config Plot + bug fix * User Model : Refactoring plots * Feature flags * Remove dup * clean comments a fix some vars * fix feature flags controller * refactor obbff from settings controller * refactor a bunch of obbff variables * fix bug blocking terminal * fix integration tests * refactor controllers with obbff * refactor remaining ffs * remove comments * log not started * mispelled variable * set current user on local model * User Model : moving files + updating * User Preferences * User : Refactor is_guest function + bug fix * User : refactor is_guest function * Fix conftest.py * remove lost obbffs * typo on fileoverwrite * Plot config: move variables and start plot dpi * User : tests * refactor plot dpi references * remove plot dpi imports * refactor some config terminal leftover * /account/sync : fix bug * remove configs reload * start path refactor * installation paths vs user paths * remove cfg_plot * Tests : User Refactoring * user prefix only for preferences * user prefix only for preferences * move user paths * remove comment * update apply remote configs * fix tz not updating * save some copys * small fix * create interface for credentials and preferences * wrong docstrings fixed * ruff core * fix some pref setting * login is better * ruff * ruff * remove Literal * add small comment * Tests : User Refactoring * Credentials Model : add DataBento * Fix helper_funcs * Fixing code * Tests : fixing * User Model : freezing the models * Fixed Income + Databento * Tests : fixing keys * black * ruff * Tests : user model * Tests : user model * Fix linting * Fix linting * Linting * Linting * Fixing code and tests * Fix tests * mypy * SDK * Clean ruff cache * Fix syntax issue * Update fred_view * Black * Linting * Update code * Update tests * Linting * Linting * Tests * Black * Linting * Linting * Mock os.listdir to avoid looking for file that doesnt exist * Mock options paths * lint * Tests : fix * Code : update * Tests + Linting * Tests * Ruff * Code : update * Tests * Code : update * Fix workflow * Code : update --------- Co-authored-by: Chavithra PARANA <chavithra@gmail.com> Co-authored-by: luqazino@gmail.com <luqazino@gmail.com> Co-authored-by: James Maslek <jmaslek11@gmail.com>
567 lines
21 KiB
Python
567 lines
21 KiB
Python
""" Hedge Controller Module """
|
|
__docformat__ = "numpy"
|
|
|
|
import argparse
|
|
import logging
|
|
from datetime import datetime
|
|
from typing import Dict, List, Optional
|
|
|
|
import pandas as pd
|
|
|
|
from openbb_terminal.core.session.current_user import get_current_user
|
|
from openbb_terminal.custom_prompt_toolkit import NestedCompleter
|
|
from openbb_terminal.decorators import log_start_end
|
|
from openbb_terminal.helper_funcs import print_rich_table
|
|
from openbb_terminal.menu import session
|
|
from openbb_terminal.parent_classes import BaseController
|
|
from openbb_terminal.rich_config import MenuText, console
|
|
from openbb_terminal.stocks import stocks_helper
|
|
from openbb_terminal.stocks.options.hedge import hedge_view
|
|
from openbb_terminal.stocks.options.hedge.hedge_model import add_hedge_option
|
|
from openbb_terminal.stocks.options.yfinance_model import get_option_chain, get_price
|
|
from openbb_terminal.stocks.options.yfinance_view import plot_payoff
|
|
|
|
# pylint: disable=R0902
|
|
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
class HedgeController(BaseController):
|
|
"""Hedge Controller class"""
|
|
|
|
CHOICES_COMMANDS = [
|
|
"list",
|
|
"add",
|
|
"rmv",
|
|
"pick",
|
|
"sop",
|
|
"plot",
|
|
]
|
|
|
|
PATH = "/stocks/options/hedge/"
|
|
CHOICES_GENERATION = True
|
|
|
|
def __init__(self, ticker: str, expiration: str, queue: Optional[List[str]] = None):
|
|
"""Constructor"""
|
|
super().__init__(queue)
|
|
|
|
self.underlying_asset_position: str = ""
|
|
self.chain = get_option_chain(ticker, expiration)
|
|
self.calls = list(
|
|
zip(
|
|
self.chain.calls["strike"].tolist(),
|
|
self.chain.calls["impliedVolatility"].tolist(),
|
|
self.chain.calls["lastPrice"].tolist(),
|
|
self.chain.calls["currency"].tolist(),
|
|
)
|
|
)
|
|
self.puts = list(
|
|
zip(
|
|
self.chain.puts["strike"].tolist(),
|
|
self.chain.puts["impliedVolatility"].tolist(),
|
|
self.chain.puts["lastPrice"].tolist(),
|
|
self.chain.calls["currency"].tolist(),
|
|
)
|
|
)
|
|
|
|
self.PICK_CHOICES = [
|
|
f"{strike} {position} {side}"
|
|
for strike in range(int(self.calls[0][0]), int(self.calls[-1][0]), 5)
|
|
for position in ["Long", "Short"]
|
|
for side in ["Call", "Put"]
|
|
]
|
|
|
|
self.ticker = ticker
|
|
self.current_price: float = get_price(ticker)
|
|
self.expiration = expiration
|
|
self.implied_volatility = self.chain.calls["impliedVolatility"]
|
|
self.options: Dict = {"Portfolio": {}, "Option A": {}, "Option B": {}}
|
|
self.underlying = 0.0
|
|
self.side: str = ""
|
|
self.amount = 0.0
|
|
self.strike = 0.0
|
|
self.call_index_choices = range(len(self.calls))
|
|
self.put_index_choices = range(len(self.puts))
|
|
self.greeks: Dict = {"Portfolio": {}, "Option A": {}, "Option B": {}}
|
|
|
|
if session and get_current_user().preferences.USE_PROMPT_TOOLKIT:
|
|
choices: dict = self.choices_default
|
|
# This menu contains dynamic choices that may change during runtime
|
|
self.choices = choices
|
|
self.completer = NestedCompleter.from_nested_dict(choices)
|
|
|
|
def update_runtime_choices(self):
|
|
"""Update runtime choices"""
|
|
if (
|
|
self.options
|
|
and session
|
|
and get_current_user().preferences.USE_PROMPT_TOOLKIT
|
|
):
|
|
self.choices["rmv"] = {c: None for c in ["Option A", "Option B"]}
|
|
self.choices["rmv"]["--all"] = {}
|
|
self.choices["rmv"]["-a"] = "--all"
|
|
self.completer = NestedCompleter.from_nested_dict(self.choices)
|
|
|
|
def print_help(self):
|
|
"""Print help"""
|
|
mt = MenuText("stocks/options/hedge/")
|
|
mt.add_param("_ticker", self.ticker or "")
|
|
mt.add_param("_expiry", self.expiration or "")
|
|
mt.add_raw("\n")
|
|
mt.add_cmd("pick")
|
|
mt.add_raw("\n")
|
|
mt.add_param("_underlying", self.underlying_asset_position)
|
|
mt.add_raw("\n")
|
|
mt.add_cmd("list")
|
|
mt.add_cmd("add", "Delta" in self.greeks["Portfolio"])
|
|
mt.add_cmd(
|
|
"rmv",
|
|
"Delta" in self.greeks["Option A"] or "Delta" in self.greeks["Option B"],
|
|
)
|
|
mt.add_cmd(
|
|
"sop",
|
|
"Delta" in self.greeks["Option A"] or "Delta" in self.greeks["Option B"],
|
|
)
|
|
mt.add_cmd(
|
|
"plot",
|
|
"Delta" in self.greeks["Option A"] or "Delta" in self.greeks["Option B"],
|
|
)
|
|
console.print(text=mt.menu_text, menu="Stocks - Options - Hedge")
|
|
|
|
def custom_reset(self):
|
|
"""Class specific component of reset command"""
|
|
if self.ticker:
|
|
if self.expiration:
|
|
return [
|
|
"stocks",
|
|
f"load {self.ticker}",
|
|
"options",
|
|
f"exp -d {self.expiration}",
|
|
"hedge",
|
|
]
|
|
return ["stocks", f"load {self.ticker}", "options", "hedge"]
|
|
return []
|
|
|
|
@log_start_end(log=logger)
|
|
def call_list(self, other_args):
|
|
"""Lists available calls and puts"""
|
|
parser = argparse.ArgumentParser(
|
|
add_help=False,
|
|
prog="list",
|
|
description="""Lists available calls and puts.""",
|
|
)
|
|
ns_parser = self.parse_known_args_and_warn(parser, other_args)
|
|
|
|
if ns_parser:
|
|
calls = pd.DataFrame([call[0] for call in self.calls])
|
|
puts = pd.DataFrame([put[0] for put in self.puts])
|
|
|
|
options = pd.concat([calls, puts], axis=1).fillna("-")
|
|
|
|
print_rich_table(
|
|
options,
|
|
title="Available Calls and Puts",
|
|
headers=list(["Calls", "Puts"]),
|
|
show_index=True,
|
|
index_name="Identifier",
|
|
)
|
|
|
|
@log_start_end(log=logger)
|
|
def call_add(self, other_args: List[str]):
|
|
"""Process add command"""
|
|
parser = argparse.ArgumentParser(
|
|
add_help=False,
|
|
prog="add",
|
|
description="""Add options to the diagram.""",
|
|
)
|
|
parser.add_argument(
|
|
"-p",
|
|
"--put",
|
|
dest="put",
|
|
action="store_true",
|
|
help="Buy a put instead of a call",
|
|
default=False,
|
|
)
|
|
parser.add_argument(
|
|
"-s",
|
|
"--short",
|
|
dest="short",
|
|
action="store_true",
|
|
help="Short the option instead of buying it",
|
|
default=False,
|
|
)
|
|
option_type = (
|
|
self.put_index_choices if "-p" in other_args else self.call_index_choices
|
|
)
|
|
parser.add_argument(
|
|
"-i",
|
|
"--identifier",
|
|
dest="identifier",
|
|
help="The identifier of the option as found in the list command",
|
|
required="-h" not in other_args and "-k" not in other_args,
|
|
type=int,
|
|
choices=option_type,
|
|
)
|
|
if other_args and "-" not in other_args[0][0]:
|
|
other_args.insert(0, "-i")
|
|
ns_parser = self.parse_known_args_and_warn(parser, other_args)
|
|
|
|
if ns_parser:
|
|
if not self.greeks["Portfolio"]:
|
|
console.print(
|
|
"Please set the Underlying Asset Position by using the 'pick' command.\n"
|
|
)
|
|
else:
|
|
opt_type = "Put" if ns_parser.put else "Call"
|
|
sign = -1 if ns_parser.short else 1
|
|
options_list = self.puts if ns_parser.put else self.calls
|
|
|
|
if ns_parser.identifier < len(options_list):
|
|
strike = options_list[ns_parser.identifier][0]
|
|
implied_volatility = options_list[ns_parser.identifier][1]
|
|
cost = options_list[ns_parser.identifier][2]
|
|
currency = options_list[ns_parser.identifier][3]
|
|
|
|
option = {
|
|
"type": opt_type,
|
|
"sign": sign,
|
|
"strike": strike,
|
|
"implied_volatility": implied_volatility,
|
|
"cost": cost,
|
|
"currency": currency,
|
|
}
|
|
|
|
side = 1 if opt_type == "Call" else -1
|
|
|
|
date_obj = datetime.strptime(self.expiration, "%Y-%m-%d")
|
|
days = float((date_obj - datetime.now()).days + 1)
|
|
|
|
if days == 0.0:
|
|
days = 0.01
|
|
|
|
if "Delta" not in self.greeks["Option A"]:
|
|
self.options["Option A"] = option
|
|
(
|
|
self.greeks["Option A"]["Delta"],
|
|
self.greeks["Option A"]["Gamma"],
|
|
self.greeks["Option A"]["Vega"],
|
|
) = hedge_view.add_and_show_greeks(
|
|
self.current_price,
|
|
implied_volatility,
|
|
strike,
|
|
days / 365,
|
|
side,
|
|
)
|
|
elif "Delta" not in self.greeks["Option B"]:
|
|
self.options["Option B"] = option
|
|
(
|
|
self.greeks["Option B"]["Delta"],
|
|
self.greeks["Option B"]["Gamma"],
|
|
self.greeks["Option B"]["Vega"],
|
|
) = hedge_view.add_and_show_greeks(
|
|
self.current_price,
|
|
implied_volatility,
|
|
strike,
|
|
days / 365,
|
|
side,
|
|
)
|
|
else:
|
|
console.print(
|
|
"[red]The functionality only accepts two options. Therefore, please remove an "
|
|
"option with 'rmv' before continuing.[/red]\n"
|
|
)
|
|
return
|
|
|
|
positions = pd.DataFrame()
|
|
|
|
for _, values in self.options.items():
|
|
# Loops over options in the dictionary. If a position is empty, skips the printing.
|
|
if values:
|
|
option_position: str = (
|
|
"Long" if values["sign"] == 1 else "Short"
|
|
)
|
|
positions = positions.append(
|
|
[
|
|
[
|
|
values["type"],
|
|
option_position,
|
|
values["strike"],
|
|
values["implied_volatility"],
|
|
values["cost"],
|
|
values["currency"],
|
|
]
|
|
]
|
|
)
|
|
|
|
positions.columns = [
|
|
"Type",
|
|
"Hold",
|
|
"Strike",
|
|
"Implied Volatility",
|
|
"Cost",
|
|
"Currency",
|
|
]
|
|
|
|
console.print("")
|
|
|
|
print_rich_table(
|
|
positions,
|
|
title="Current Option Positions",
|
|
headers=list(positions.columns),
|
|
show_index=False,
|
|
)
|
|
|
|
if (
|
|
"Delta" in self.greeks["Option A"]
|
|
and "Delta" in self.greeks["Option B"]
|
|
):
|
|
hedge_view.show_calculated_hedge(
|
|
self.amount, option["type"], self.greeks, sign
|
|
)
|
|
|
|
self.update_runtime_choices()
|
|
else:
|
|
console.print("Please use a valid index\n")
|
|
|
|
@log_start_end(log=logger)
|
|
def call_rmv(self, other_args: List[str]):
|
|
"""Process rmv command"""
|
|
parser = argparse.ArgumentParser(
|
|
add_help=False,
|
|
prog="rmv",
|
|
description="""Remove one of the options to be shown in the hedge.""",
|
|
)
|
|
parser.add_argument(
|
|
"-o",
|
|
"--option",
|
|
dest="option",
|
|
help="index of the option to remove",
|
|
nargs="+",
|
|
)
|
|
parser.add_argument(
|
|
"-a",
|
|
"--all",
|
|
dest="all",
|
|
action="store_true",
|
|
help="remove all of the options",
|
|
default=False,
|
|
)
|
|
if other_args and "-" not in other_args[0][0]:
|
|
other_args.insert(0, "-o")
|
|
ns_parser = self.parse_known_args_and_warn(parser, other_args)
|
|
if ns_parser:
|
|
if not self.options["Option A"] and not self.options["Option B"]:
|
|
console.print("Please add Options by using the 'add' command.\n")
|
|
else:
|
|
if ns_parser.all:
|
|
self.options = {"Option A": {}, "Option B": {}}
|
|
else:
|
|
option_name = " ".join(ns_parser.option)
|
|
|
|
if option_name in self.options:
|
|
self.options[option_name] = {}
|
|
self.greeks[option_name] = {}
|
|
|
|
self.update_runtime_choices()
|
|
else:
|
|
console.print(f"{option_name} is not an option.")
|
|
|
|
if self.options["Option A"] or self.options["Option B"]:
|
|
positions = pd.DataFrame()
|
|
|
|
for _, value in self.options.items():
|
|
if value:
|
|
option_side: str = "Long" if value["sign"] == 1 else "Short"
|
|
positions = positions.append(
|
|
[
|
|
[
|
|
value["type"],
|
|
option_side,
|
|
value["strike"],
|
|
value["implied_volatility"],
|
|
]
|
|
]
|
|
)
|
|
|
|
positions.columns = ["Type", "Hold", "Strike", "Implied Volatility"]
|
|
|
|
print_rich_table(
|
|
positions,
|
|
title="Current Option Positions",
|
|
headers=list(positions.columns),
|
|
show_index=False,
|
|
)
|
|
|
|
else:
|
|
console.print(
|
|
"No options have been selected, removing them is not possible\n"
|
|
)
|
|
|
|
@log_start_end(log=logger)
|
|
def call_pick(self, other_args: List[str]):
|
|
"""Process pick command"""
|
|
parser = argparse.ArgumentParser(
|
|
add_help=False,
|
|
formatter_class=argparse.ArgumentDefaultsHelpFormatter,
|
|
prog="pick",
|
|
description="This function plots option hedge diagrams",
|
|
)
|
|
parser.add_argument(
|
|
"-p",
|
|
"--pick",
|
|
dest="pick",
|
|
type=str.lower,
|
|
choices=stocks_helper.format_parse_choices(self.PICK_CHOICES),
|
|
help="Choose what you would like to pick",
|
|
required="-h" not in other_args,
|
|
)
|
|
|
|
parser.add_argument(
|
|
"-a",
|
|
"--amount",
|
|
dest="amount",
|
|
default=1000,
|
|
help="Choose the amount invested",
|
|
)
|
|
|
|
if other_args and "-" not in other_args[0][0]:
|
|
other_args.insert(0, "-p")
|
|
ns_parser = self.parse_known_args_and_warn(parser, other_args)
|
|
if ns_parser:
|
|
pick = stocks_helper.map_parse_choices(self.PICK_CHOICES)[ns_parser.pick]
|
|
strike_type, underlying_type, side_type = pick.split(" ")
|
|
amount_type = ns_parser.amount
|
|
|
|
self.underlying_asset_position = (
|
|
f"{underlying_type} {side_type} {amount_type} @ {strike_type}"
|
|
)
|
|
|
|
if underlying_type == "Short":
|
|
self.underlying = -1
|
|
else:
|
|
self.underlying = 1
|
|
|
|
if side_type == "Put":
|
|
self.side = "Put"
|
|
side = -1
|
|
else:
|
|
self.side = "Call"
|
|
side = 1
|
|
|
|
self.amount = float(amount_type)
|
|
self.strike = float(strike_type)
|
|
|
|
index = -1
|
|
date_obj = datetime.strptime(self.expiration, "%Y-%m-%d")
|
|
days = float((date_obj - datetime.now()).days + 1)
|
|
|
|
if days == 0.0:
|
|
days = 0.01
|
|
|
|
if side == -1:
|
|
for i in range(len(self.chain.puts["strike"])):
|
|
if self.chain.puts["strike"][i] == self.strike:
|
|
index = i
|
|
break
|
|
implied_volatility = self.chain.puts["impliedVolatility"].iloc[index]
|
|
else:
|
|
for i in range(len(self.chain.calls["strike"])):
|
|
if self.chain.calls["strike"][i] == self.strike:
|
|
index = i
|
|
break
|
|
implied_volatility = self.chain.calls["impliedVolatility"].iloc[index]
|
|
|
|
(
|
|
self.greeks["Portfolio"]["Delta"],
|
|
self.greeks["Portfolio"]["Gamma"],
|
|
self.greeks["Portfolio"]["Vega"],
|
|
) = add_hedge_option(
|
|
self.current_price,
|
|
implied_volatility,
|
|
float(self.strike),
|
|
days / 365,
|
|
side,
|
|
)
|
|
|
|
@log_start_end(log=logger)
|
|
def call_sop(self, other_args):
|
|
"""Process sop command"""
|
|
parser = argparse.ArgumentParser(
|
|
add_help=False,
|
|
formatter_class=argparse.ArgumentDefaultsHelpFormatter,
|
|
prog="sop",
|
|
description="Displays selected option",
|
|
)
|
|
ns_parser = self.parse_known_args_and_warn(parser, other_args)
|
|
if ns_parser:
|
|
if not self.options["Option A"] and not self.options["Option B"]:
|
|
console.print("Please add Options by using the 'add' command.\n")
|
|
else:
|
|
positions = pd.DataFrame()
|
|
|
|
for _, value in self.options.items():
|
|
if value:
|
|
option_side: str = "Long" if value["sign"] == 1 else "Short" # type: ignore
|
|
positions = positions.append(
|
|
[
|
|
[
|
|
value["type"],
|
|
option_side,
|
|
value["strike"],
|
|
value["implied_volatility"],
|
|
value["cost"],
|
|
value["currency"],
|
|
]
|
|
]
|
|
)
|
|
|
|
positions.columns = [
|
|
"Type",
|
|
"Hold",
|
|
"Strike",
|
|
"Implied Volatility",
|
|
"Cost",
|
|
"Currency",
|
|
]
|
|
|
|
print_rich_table(
|
|
positions,
|
|
title="Current Option Positions",
|
|
headers=list(positions.columns),
|
|
show_index=False,
|
|
)
|
|
|
|
if (
|
|
"Delta" in self.greeks["Option A"]
|
|
and "Delta" in self.greeks["Option B"]
|
|
):
|
|
hedge_view.show_calculated_hedge(
|
|
self.amount,
|
|
self.options["Option A"]["type"],
|
|
self.greeks,
|
|
self.options["Option A"]["sign"],
|
|
)
|
|
|
|
@log_start_end(log=logger)
|
|
def call_plot(self, other_args):
|
|
"""Process plot command"""
|
|
parser = argparse.ArgumentParser(
|
|
add_help=False,
|
|
formatter_class=argparse.ArgumentDefaultsHelpFormatter,
|
|
prog="plot",
|
|
description="This function plots option payoff diagrams",
|
|
)
|
|
ns_parser = self.parse_known_args_and_warn(parser, other_args)
|
|
if ns_parser:
|
|
if not self.options["Option A"] and not self.options["Option B"]:
|
|
console.print("Please add Options by using the 'add' command.\n")
|
|
else:
|
|
plot_payoff(
|
|
self.current_price,
|
|
[self.options["Option A"], self.options["Option B"]],
|
|
self.underlying,
|
|
self.ticker,
|
|
self.expiration,
|
|
)
|