tastytrade-cli 0.1__tar.gz

tastytrade_cli-0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Graeme Holliday
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tastytrade_cli-0.1/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.1
+Name: tastytrade-cli
+Version: 0.1
+Summary: An easy-to-use command line interface for Tastytrade!
+Home-page: https://github.com/tastyware/tastytrade-cli
+Author: Graeme Holliday
+Author-email: graeme.holliday@pm.me
+License: MIT
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: asyncclick>=8.1.7.2
+Requires-Dist: rich>=13.7.1
+Requires-Dist: tastytrade>=7.7
+
+# tastytrade-cli
+
+An easy-to-use command line interface for Tastytrade!
+
+![Peek2024-07-0120-35-ezgif com-speed](https://github.com/tastyware/tastytrade-cli/assets/4185684/3d00731c-8f5e-40c5-973a-0f0357637083)
+
+## Installation
+
+```
+$ pip install tastytrade-cli
+```
+
+> [!WARNING]  
+> The CLI is still under active development. Please report any bugs, and contributions are always welcome!
+
+## Usage
+
+Available commands:
+```
+tt option              buy, sell, and analyze options
+```
+Unavailable commands pending development:
+```
+tt crypto              buy, sell, and analyze cryptocurrencies
+tt future              buy, sell, and analyze futures
+tt stock               buy, sell, and analyze stock
+tt order               view, replace, and cancel orders
+tt pf (portfolio)      view statistics and risk metrics for your portfolio
+tt wl (watchlist)      view current prices and other data for symbols in your watchlists
+```
+For more options, run `tt --help` or `tt <subcommand> --help`.
+
+## Development/Contributing
+
+This project includes a number of helpers in the `Makefile` to streamline common development tasks.
+
+Creating a virtualenv for development:
+```
+$ make venv
+$ source .venv/bin/activate
+```
+
+It's usually a good idea to make sure you're passing tests locally before submitting a PR:
+```
+$ make lint
+```
+
+If you have a feature suggestion, find a bug, or would like to contribute, feel free to open an issue or create a pull request.
+
+## Disclaimer
+
+tastyworks and tastytrade are not affiliated with the makers of this program and do not endorse this product. This program does not provide investment, tax, or legal advice. Stock trading involves risk and is not suitable for all investors. Options involve risk and are not suitable for all investors as the special risks inherent to options trading may expose investors to potentially significant losses. Futures and futures options trading is speculative and is not suitable for all investors. Cryptocurrency trading is speculative and is not suitable for all investors.

tastytrade_cli-0.1/README.md

@@ -0,0 +1,52 @@
+# tastytrade-cli
+
+An easy-to-use command line interface for Tastytrade!
+
+![Peek2024-07-0120-35-ezgif com-speed](https://github.com/tastyware/tastytrade-cli/assets/4185684/3d00731c-8f5e-40c5-973a-0f0357637083)
+
+## Installation
+
+```
+$ pip install tastytrade-cli
+```
+
+> [!WARNING]  
+> The CLI is still under active development. Please report any bugs, and contributions are always welcome!
+
+## Usage
+
+Available commands:
+```
+tt option              buy, sell, and analyze options
+```
+Unavailable commands pending development:
+```
+tt crypto              buy, sell, and analyze cryptocurrencies
+tt future              buy, sell, and analyze futures
+tt stock               buy, sell, and analyze stock
+tt order               view, replace, and cancel orders
+tt pf (portfolio)      view statistics and risk metrics for your portfolio
+tt wl (watchlist)      view current prices and other data for symbols in your watchlists
+```
+For more options, run `tt --help` or `tt <subcommand> --help`.
+
+## Development/Contributing
+
+This project includes a number of helpers in the `Makefile` to streamline common development tasks.
+
+Creating a virtualenv for development:
+```
+$ make venv
+$ source .venv/bin/activate
+```
+
+It's usually a good idea to make sure you're passing tests locally before submitting a PR:
+```
+$ make lint
+```
+
+If you have a feature suggestion, find a bug, or would like to contribute, feel free to open an issue or create a pull request.
+
+## Disclaimer
+
+tastyworks and tastytrade are not affiliated with the makers of this program and do not endorse this product. This program does not provide investment, tax, or legal advice. Stock trading involves risk and is not suitable for all investors. Options involve risk and are not suitable for all investors as the special risks inherent to options trading may expose investors to potentially significant losses. Futures and futures options trading is speculative and is not suitable for all investors. Cryptocurrency trading is speculative and is not suitable for all investors.

tastytrade_cli-0.1/etc/ttcli.cfg

@@ -0,0 +1,20 @@
+[general]
+# username = foo
+# password = bar
+# default-account = example
+
+[portfolio]
+bp-target-percent-vix-low = 15
+bp-target-percent-vix-high = 55
+bp-target-percent-variation = 5
+portfolio-delta-target = 0
+portfolio-delta-variation = 5
+
+[order]
+bp-warn-above-percent = 5
+
+[option]
+chain-show-delta = true
+chain-show-volume = false
+chain-show-open-interest = false
+chain-show-theta = false

tastytrade_cli-0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tastytrade_cli-0.1/setup.py

@@ -0,0 +1,29 @@
+from setuptools import find_packages, setup
+
+f = open('README.md', 'r')
+LONG_DESCRIPTION = f.read()
+f.close()
+
+setup(
+    name='tastytrade-cli',
+    version='0.1',
+    description='An easy-to-use command line interface for Tastytrade!',
+    long_description=LONG_DESCRIPTION,
+    long_description_content_type='text/markdown',
+    author='Graeme Holliday',
+    author_email='graeme.holliday@pm.me',
+    url='https://github.com/tastyware/tastytrade-cli',
+    license='MIT',
+    install_requires=[
+        'asyncclick>=8.1.7.2',
+        'rich>=13.7.1',
+        'tastytrade>=7.7',
+    ],
+    data_files = [('etc', ['etc/ttcli.cfg'])],
+    packages=find_packages(exclude=['ez_setup']),
+    include_package_data=True,
+    entry_points="""
+        [console_scripts]
+        tt = ttcli.app:main
+    """
+)

tastytrade_cli-0.1/tastytrade_cli.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.1
+Name: tastytrade-cli
+Version: 0.1
+Summary: An easy-to-use command line interface for Tastytrade!
+Home-page: https://github.com/tastyware/tastytrade-cli
+Author: Graeme Holliday
+Author-email: graeme.holliday@pm.me
+License: MIT
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: asyncclick>=8.1.7.2
+Requires-Dist: rich>=13.7.1
+Requires-Dist: tastytrade>=7.7
+
+# tastytrade-cli
+
+An easy-to-use command line interface for Tastytrade!
+
+![Peek2024-07-0120-35-ezgif com-speed](https://github.com/tastyware/tastytrade-cli/assets/4185684/3d00731c-8f5e-40c5-973a-0f0357637083)
+
+## Installation
+
+```
+$ pip install tastytrade-cli
+```
+
+> [!WARNING]  
+> The CLI is still under active development. Please report any bugs, and contributions are always welcome!
+
+## Usage
+
+Available commands:
+```
+tt option              buy, sell, and analyze options
+```
+Unavailable commands pending development:
+```
+tt crypto              buy, sell, and analyze cryptocurrencies
+tt future              buy, sell, and analyze futures
+tt stock               buy, sell, and analyze stock
+tt order               view, replace, and cancel orders
+tt pf (portfolio)      view statistics and risk metrics for your portfolio
+tt wl (watchlist)      view current prices and other data for symbols in your watchlists
+```
+For more options, run `tt --help` or `tt <subcommand> --help`.
+
+## Development/Contributing
+
+This project includes a number of helpers in the `Makefile` to streamline common development tasks.
+
+Creating a virtualenv for development:
+```
+$ make venv
+$ source .venv/bin/activate
+```
+
+It's usually a good idea to make sure you're passing tests locally before submitting a PR:
+```
+$ make lint
+```
+
+If you have a feature suggestion, find a bug, or would like to contribute, feel free to open an issue or create a pull request.
+
+## Disclaimer
+
+tastyworks and tastytrade are not affiliated with the makers of this program and do not endorse this product. This program does not provide investment, tax, or legal advice. Stock trading involves risk and is not suitable for all investors. Options involve risk and are not suitable for all investors as the special risks inherent to options trading may expose investors to potentially significant losses. Futures and futures options trading is speculative and is not suitable for all investors. Cryptocurrency trading is speculative and is not suitable for all investors.

tastytrade_cli-0.1/tastytrade_cli.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+setup.py
+etc/ttcli.cfg
+tastytrade_cli.egg-info/PKG-INFO
+tastytrade_cli.egg-info/SOURCES.txt
+tastytrade_cli.egg-info/dependency_links.txt
+tastytrade_cli.egg-info/entry_points.txt
+tastytrade_cli.egg-info/requires.txt
+tastytrade_cli.egg-info/top_level.txt
+ttcli/__init__.py
+ttcli/app.py
+ttcli/option.py
+ttcli/portfolio.py
+ttcli/utils.py

tastytrade_cli-0.1/tastytrade_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tastytrade_cli-0.1/tastytrade_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tt = ttcli.app:main

tastytrade_cli-0.1/tastytrade_cli.egg-info/requires.txt

@@ -0,0 +1,3 @@
+asyncclick>=8.1.7.2
+rich>=13.7.1
+tastytrade>=7.7

tastytrade_cli-0.1/tastytrade_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+ttcli

tastytrade_cli-0.1/ttcli/app.py

@@ -0,0 +1,25 @@
+import asyncio
+import sys
+
+import asyncclick as click
+
+from ttcli.option import option
+from ttcli.portfolio import portfolio
+from ttcli.utils import CONTEXT_SETTINGS, VERSION, logger
+
+
+@click.group(context_settings=CONTEXT_SETTINGS)
+@click.version_option(VERSION)
+async def app():
+    pass
+
+
+def main():
+    if sys.version_info[0] == 3 and sys.version_info[1] >= 8 and sys.platform.startswith('win'):
+        asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
+        logger.debug('Using Windows-specific event loop policy')
+
+    app.add_command(option)
+    app.add_command(portfolio, name='pf')
+
+    app(_anyio_backend='asyncio')

tastytrade_cli-0.1/ttcli/option.py

@@ -0,0 +1,706 @@
+from datetime import date
+from decimal import Decimal
+from typing import Optional
+
+import asyncclick as click
+from rich.console import Console
+from rich.table import Table
+from tastytrade import DXLinkStreamer
+from tastytrade.dxfeed import EventType, Greeks, Quote
+from tastytrade.instruments import Future, NestedFutureOptionChain, NestedFutureOptionChainExpiration, NestedOptionChain, NestedOptionChainExpiration, Option
+from tastytrade.order import (NewOrder, OrderAction, OrderTimeInForce,
+                              OrderType, PriceEffect)
+from tastytrade.utils import get_tasty_monthly
+
+from ttcli.utils import (ZERO, RenewableSession, get_confirmation, is_monthly,
+                         print_error, print_warning, test_order_handle_errors)
+
+
+def choose_expiration(
+    chain: NestedOptionChain,
+    include_weeklies: bool = False
+) -> NestedOptionChainExpiration:
+    exps = [e for e in chain.expirations]
+    if not include_weeklies:
+        exps = [e for e in exps if is_monthly(e.expiration_date)]
+    default = get_tasty_monthly()
+    default_option = None
+    for i, exp in enumerate(exps):
+        if exp.expiration_date == default:
+            default_option = exp
+            print(f'{i + 1}) {exp.expiration_date} (default)')
+        else:
+            print(f'{i + 1}) {exp.expiration_date}')
+    choice = 0
+    while choice not in range(1, len(exps) + 1):
+        try:
+            raw = input('Please choose an expiration: ')
+            choice = int(raw)
+        except ValueError:
+            if not raw:
+                return default_option
+
+    return exps[choice - 1]
+
+
+def choose_futures_expiration(
+    chain: NestedFutureOptionChain,
+    include_weeklies: bool = False
+) -> NestedFutureOptionChainExpiration:
+    chain = chain.option_chains[0]
+    if include_weeklies:
+        exps = [e for e in chain.expirations]
+    else:
+        exps = [e for e in chain.expirations if e.expiration_type != 'Weekly']
+    for i, exp in enumerate(exps):
+        if i == 0:
+            print(f'{i + 1}) {exp.expiration_date} [{exp.underlying_symbol}] (default)')
+        else:
+            print(f'{i + 1}) {exp.expiration_date} [{exp.underlying_symbol}]')
+    choice = 0
+    while choice not in range(1, len(exps) + 1):
+        try:
+            raw = input('Please choose an expiration: ')
+            choice = int(raw)
+        except ValueError:
+            if not raw:
+                return exps[0]
+
+    return exps[choice - 1]
+
+
+async def listen_quotes(
+    n_quotes: int,
+    streamer: DXLinkStreamer,
+    skip: str | None = None
+) -> dict[str, Quote]:
+    quote_dict = {}
+    async for quote in streamer.listen(EventType.QUOTE):
+        if quote.eventSymbol != skip:
+            quote_dict[quote.eventSymbol] = quote
+        if len(quote_dict) == n_quotes:
+            return quote_dict
+
+
+async def listen_greeks(
+    n_greeks: int,
+    streamer: DXLinkStreamer
+) -> dict[str, Greeks]:
+    greeks_dict = {}
+    async for greeks in streamer.listen(EventType.GREEKS):
+        greeks_dict[greeks.eventSymbol] = greeks
+        if len(greeks_dict) == n_greeks:
+            return greeks_dict
+
+
+async def listen_summaries(
+    n_summaries: int,
+    streamer: DXLinkStreamer
+) -> dict[str, Quote]:
+    summary_dict = {}
+    async for summary in streamer.listen(EventType.SUMMARY):
+        summary_dict[summary.eventSymbol] = summary
+        if len(summary_dict) == n_summaries:
+            return summary_dict
+
+
+async def listen_trades(
+    n_trades: int,
+    streamer: DXLinkStreamer
+) -> dict[str, Quote]:
+    trade_dict = {}
+    async for trade in streamer.listen(EventType.TRADE):
+        trade_dict[trade.eventSymbol] = trade
+        if len(trade_dict) == n_trades:
+            return trade_dict
+
+
+@click.group(chain=True, help='Buy, sell, and analyze options.')
+async def option():
+    pass
+
+
+@option.command(help='Buy or sell calls with the given parameters.')
+@click.option('-s', '--strike', type=Decimal, help='The chosen strike for the option.')
+@click.option('-d', '--delta', type=int, help='The chosen delta for the option.')
+@click.option('-w', '--width', type=int, help='Turns the order into a spread with the given width.')
+@click.option('--gtc', is_flag=True, help='Place a GTC order instead of a day order.')
+@click.option('--weeklies', is_flag=True, help='Show all expirations, not just monthlies.')
+@click.argument('symbol', type=str)
+@click.argument('quantity', type=int)
+async def call(symbol: str, quantity: int, strike: Optional[Decimal] = None, width: Optional[int] = None,
+               gtc: bool = False, weeklies: bool = False, delta: Optional[int] = None):
+    if strike is not None and delta is not None:
+        print_error('Must specify either delta or strike, but not both.')
+        return
+    elif not strike and not delta:
+        print_error('Please specify either delta or strike for the option.')
+        return
+    elif delta is not None and abs(delta) > 99:
+        print_error('Delta value is too high, -99 <= delta <= 99')
+        return
+
+    sesh = RenewableSession()
+    chain = NestedOptionChain.get_chain(sesh, symbol)
+    subchain = choose_expiration(chain, weeklies)
+
+    async with DXLinkStreamer(sesh) as streamer:
+        if not strike:
+            dxfeeds = [s.call_streamer_symbol for s in subchain.strikes]
+            await streamer.subscribe(EventType.GREEKS, dxfeeds)
+            greeks_dict = await listen_greeks(len(dxfeeds), streamer)
+            greeks = list(greeks_dict.values())
+
+            lowest = 100
+            selected = None
+            for g in greeks:
+                diff = abs(g.delta * Decimal(100) - delta)
+                if diff < lowest:
+                    selected = g
+                    lowest = diff
+            # set strike with the closest delta
+            strike = next(s.strike_price for s in subchain.strikes
+                          if s.call_streamer_symbol == selected.eventSymbol)
+
+        if width:
+            spread_strike = next(s for s in subchain.strikes if s.strike_price == strike + width)
+            await streamer.subscribe(EventType.QUOTE, [selected.eventSymbol, spread_strike.call_streamer_symbol])
+            quote_dict = await listen_quotes(2, streamer)
+            bid = quote_dict[selected.eventSymbol].bidPrice - quote_dict[spread_strike.call_streamer_symbol].askPrice
+            ask = quote_dict[selected.eventSymbol].askPrice - quote_dict[spread_strike.call_streamer_symbol].bidPrice
+            mid = (bid + ask) / Decimal(2)
+        else:
+            await streamer.subscribe(EventType.QUOTE, [selected.eventSymbol])
+            quote = await streamer.get_event(EventType.QUOTE)
+            bid = quote.bidPrice
+            ask = quote.askPrice
+            mid = (bid + ask) / Decimal(2)
+
+        console = Console()
+        if width:
+            table = Table(show_header=True, header_style='bold', title_style='bold',
+                          title=f'Quote for {symbol} call spread {subchain.expiration_date}')
+        else:
+            table = Table(show_header=True, header_style='bold', title_style='bold',
+                          title=f'Quote for {symbol} {strike}C {subchain.expiration_date}')
+        table.add_column('Bid', style='green', width=8, justify='center')
+        table.add_column('Mid', width=8, justify='center')
+        table.add_column('Ask', style='red', width=8, justify='center')
+        table.add_row(f'{bid:.2f}', f'{mid:.2f}', f'{ask:.2f}')
+        console.print(table)
+
+        price = input('Please enter a limit price per quantity (default mid): ')
+        if not price:
+            price = round(mid, 2)
+        price = Decimal(price)
+
+        short_symbol = next(s.call for s in subchain.strikes if s.strike_price == strike)
+        if width:
+            res = Option.get_options(sesh, [short_symbol, spread_strike.call])
+            res.sort(key=lambda x: x.strike_price)
+            legs = [
+                res[0].build_leg(abs(quantity), OrderAction.SELL_TO_OPEN if quantity < 0 else OrderAction.BUY_TO_OPEN),
+                res[1].build_leg(abs(quantity), OrderAction.BUY_TO_OPEN if quantity < 0 else OrderAction.SELL_TO_OPEN)
+            ]
+        else:
+            call = Option.get_option(sesh, short_symbol)
+            legs = [call.build_leg(abs(quantity), OrderAction.SELL_TO_OPEN if quantity < 0 else OrderAction.BUY_TO_OPEN)]
+        order = NewOrder(
+            time_in_force=OrderTimeInForce.GTC if gtc else OrderTimeInForce.DAY,
+            order_type=OrderType.LIMIT,
+            legs=legs,
+            price=price,
+            price_effect=PriceEffect.CREDIT if quantity < 0 else PriceEffect.DEBIT
+        )
+        acc = sesh.get_account()
+
+        data = test_order_handle_errors(acc, sesh, order)
+        if data is None:
+            return
+
+        nl = acc.get_balances(sesh).net_liquidating_value
+        bp = data.buying_power_effect.change_in_buying_power
+        percent = bp / nl * Decimal(100)
+        fees = data.fee_calculation.total_fees
+
+        table = Table(show_header=True, header_style='bold', title_style='bold', title='Order Review')
+        table.add_column('Quantity', width=8, justify='center')
+        table.add_column('Symbol', width=8, justify='center')
+        table.add_column('Strike', width=8, justify='center')
+        table.add_column('Type', width=8, justify='center')
+        table.add_column('Expiration', width=10, justify='center')
+        table.add_column('Price', width=8, justify='center')
+        table.add_column('BP', width=8, justify='center')
+        table.add_column('BP %', width=8, justify='center')
+        table.add_column('Fees', width=8, justify='center')
+        table.add_row(f'{quantity:+}', symbol, f'${strike:.2f}', 'CALL', f'{subchain.expiration_date}', f'${price:.2f}',
+                      f'${bp:.2f}', f'{percent:.2f}%', f'${fees:.2f}')
+        if width:
+            table.add_row(f'{-quantity:+}', symbol, f'${spread_strike.strike_price:.2f}',
+                          'CALL', f'{subchain.expiration_date}', '-', '-', '-', '-')
+        console.print(table)
+
+        if data.warnings:
+            for warning in data.warnings:
+                print_warning(warning.message)
+        warn_percent = sesh.config.getint('order', 'bp-warn-above-percent', fallback=None)
+        if warn_percent and percent > warn_percent:
+            print_warning(f'Buying power usage is above target of {warn_percent}%!')
+        if get_confirmation('Send order? Y/n '):
+            acc.place_order(sesh, order, dry_run=False)
+
+
+@option.command(help='Buy or sell puts with the given parameters.')
+@click.option('-s', '--strike', type=Decimal, help='The chosen strike for the option.')
+@click.option('-d', '--delta', type=int, help='The chosen delta for the option.')
+@click.option('-w', '--width', type=int, help='Turns the order into a spread with the given width.')
+@click.option('--gtc', is_flag=True, help='Place a GTC order instead of a day order.')
+@click.option('--weeklies', is_flag=True, help='Show all expirations, not just monthlies.')
+@click.argument('symbol', type=str)
+@click.argument('quantity', type=int)
+async def put(symbol: str, quantity: int, strike: Optional[int] = None, width: Optional[int] = None,
+              gtc: bool = False, weeklies: bool = False, delta: Optional[int] = None):
+    if strike is not None and delta is not None:
+        print_error('Must specify either delta or strike, but not both.')
+        return
+    elif not strike and not delta:
+        print_error('Please specify either delta or strike for the option.')
+        return
+    elif delta is not None and abs(delta) > 99:
+        print_error('Delta value is too high, -99 <= delta <= 99')
+        return
+
+    sesh = RenewableSession()
+    chain = NestedOptionChain.get_chain(sesh, symbol)
+    subchain = choose_expiration(chain, weeklies)
+
+    async with DXLinkStreamer(sesh) as streamer:
+        if not strike:
+            dxfeeds = [s.put_streamer_symbol for s in subchain.strikes]
+            await streamer.subscribe(EventType.GREEKS, dxfeeds)
+            greeks_dict = await listen_greeks(len(dxfeeds), streamer)
+            greeks = list(greeks_dict.values())
+
+            lowest = 100
+            selected = None
+            for g in greeks:
+                diff = abs(g.delta * Decimal(100) + delta)
+                if diff < lowest:
+                    selected = g
+                    lowest = diff
+            # set strike with the closest delta
+            strike = next(s.strike_price for s in subchain.strikes
+                          if s.put_streamer_symbol == selected.eventSymbol)
+
+        if width:
+            spread_strike = next(s for s in subchain.strikes if s.strike_price == strike - width)
+            await streamer.subscribe(EventType.QUOTE, [selected.eventSymbol, spread_strike.put_streamer_symbol])
+            quote_dict = await listen_quotes(2, streamer)
+            bid = quote_dict[selected.eventSymbol].bidPrice - quote_dict[spread_strike.put_streamer_symbol].askPrice
+            ask = quote_dict[selected.eventSymbol].askPrice - quote_dict[spread_strike.put_streamer_symbol].bidPrice
+            mid = (bid + ask) / Decimal(2)
+        else:
+            await streamer.subscribe(EventType.QUOTE, [selected.eventSymbol])
+            quote = await streamer.get_event(EventType.QUOTE)
+            bid = quote.bidPrice
+            ask = quote.askPrice
+            mid = (bid + ask) / Decimal(2)
+
+        console = Console()
+        if width:
+            table = Table(show_header=True, header_style='bold', title_style='bold',
+                          title=f'Quote for {symbol} put spread {subchain.expiration_date}')
+        else:
+            table = Table(show_header=True, header_style='bold', title_style='bold',
+                          title=f'Quote for {symbol} {strike}P {subchain.expiration_date}')
+        table.add_column('Bid', style='green', width=8, justify='center')
+        table.add_column('Mid', width=8, justify='center')
+        table.add_column('Ask', style='red', width=8, justify='center')
+        table.add_row(f'{bid:.2f}', f'{mid:.2f}', f'{ask:.2f}')
+        console.print(table)
+
+        price = input('Please enter a limit price per quantity (default mid): ')
+        if not price:
+            price = round(mid, 2)
+        price = Decimal(price)
+
+        short_symbol = next(s.put for s in subchain.strikes if s.strike_price == strike)
+        if width:
+            res = Option.get_options(sesh, [short_symbol, spread_strike.put])
+            res.sort(key=lambda x: x.strike_price, reverse=True)
+            legs = [
+                res[0].build_leg(abs(quantity), OrderAction.SELL_TO_OPEN if quantity < 0 else OrderAction.BUY_TO_OPEN),
+                res[1].build_leg(abs(quantity), OrderAction.BUY_TO_OPEN if quantity < 0 else OrderAction.SELL_TO_OPEN)
+            ]
+        else:
+            put = Option.get_option(sesh, short_symbol)
+            legs = [put.build_leg(abs(quantity), OrderAction.SELL_TO_OPEN if quantity < 0 else OrderAction.BUY_TO_OPEN)]
+        order = NewOrder(
+            time_in_force=OrderTimeInForce.GTC if gtc else OrderTimeInForce.DAY,
+            order_type=OrderType.LIMIT,
+            legs=legs,
+            price=price,
+            price_effect=PriceEffect.CREDIT if quantity < 0 else PriceEffect.DEBIT
+        )
+        acc = sesh.get_account()
+
+        data = test_order_handle_errors(acc, sesh, order)
+        if data is None:
+            return
+
+        nl = acc.get_balances(sesh).net_liquidating_value
+        bp = data.buying_power_effect.change_in_buying_power
+        percent = bp / nl * Decimal(100)
+        fees = data.fee_calculation.total_fees
+
+        table = Table(show_header=True, header_style='bold', title_style='bold', title='Order Review')
+        table.add_column('Quantity', width=8, justify='center')
+        table.add_column('Symbol', width=8, justify='center')
+        table.add_column('Strike', width=8, justify='center')
+        table.add_column('Type', width=8, justify='center')
+        table.add_column('Expiration', width=10, justify='center')
+        table.add_column('Price', width=8, justify='center')
+        table.add_column('BP', width=8, justify='center')
+        table.add_column('BP %', width=8, justify='center')
+        table.add_column('Fees', width=8, justify='center')
+        table.add_row(f'{quantity:+}', symbol, f'${strike:.2f}', 'PUT', f'{subchain.expiration_date}', f'${price:.2f}',
+                      f'${bp:.2f}', f'{percent:.2f}%', f'${fees:.2f}')
+        if width:
+            table.add_row(f'{-quantity:+}', symbol, f'${spread_strike.strike_price:.2f}',
+                          'PUT', f'{subchain.expiration_date}', '-', '-', '-', '-')
+        console.print(table)
+
+        if data.warnings:
+            for warning in data.warnings:
+                print_warning(warning.message)
+        warn_percent = sesh.config.getint('order', 'bp-warn-above-percent', fallback=None)
+        if warn_percent and percent > warn_percent:
+            print_warning(f'Buying power usage is above target of {warn_percent}%!')
+        if get_confirmation('Send order? Y/n '):
+            acc.place_order(sesh, order, dry_run=False)
+
+
+@option.command(help='Buy or sell strangles with the given parameters.')
+@click.option('-c', '--call', type=Decimal, help='The chosen strike for the call option.')
+@click.option('-p', '--put', type=Decimal, help='The chosen strike for the put option.')
+@click.option('-d', '--delta', type=int, help='The chosen delta for both options.')
+@click.option('-w', '--width', type=int, help='Turns the order into an iron condor with the given width.')
+@click.option('--gtc', is_flag=True, help='Place a GTC order instead of a day order.')
+@click.option('--weeklies', is_flag=True, help='Show all expirations, not just monthlies.')
+@click.argument('symbol', type=str)
+@click.argument('quantity', type=int)
+async def strangle(symbol: str, quantity: int, call: Optional[Decimal] = None, width: Optional[int] = None,
+              gtc: bool = False, weeklies: bool = False, delta: Optional[int] = None, put: Optional[Decimal] = None):
+    if (call is not None or put is not None) and delta is not None:
+        print_error('Must specify either delta or strike, but not both.')
+        return
+    elif delta is not None and (call is not None or put is not None):
+        print_error('Please specify either delta, or strikes for both options.')
+        return
+    elif delta is not None and abs(delta) > 99:
+        print_error('Delta value is too high, -99 <= delta <= 99')
+        return
+
+    sesh = RenewableSession()
+    chain = NestedOptionChain.get_chain(sesh, symbol)
+    subchain = choose_expiration(chain, weeklies)
+
+    async with DXLinkStreamer(sesh) as streamer:
+        if delta is not None:
+            put_dxf = [s.put_streamer_symbol for s in subchain.strikes]
+            call_dxf = [s.call_streamer_symbol for s in subchain.strikes]
+            dxfeeds = put_dxf + call_dxf
+            await streamer.subscribe(EventType.GREEKS, dxfeeds)
+            greeks_dict = await listen_greeks(len(dxfeeds), streamer)
+            put_greeks = [v for v in greeks_dict.values() if v.eventSymbol in put_dxf]
+            call_greeks = [v for v in greeks_dict.values() if v.eventSymbol in call_dxf]
+
+            lowest = 100
+            selected_put = None
+            for g in put_greeks:
+                diff = abs(g.delta * Decimal(100) + delta)
+                if diff < lowest:
+                    selected_put = g.eventSymbol
+                    lowest = diff
+            lowest = 100
+            selected_call = None
+            for g in call_greeks:
+                diff = abs(g.delta * Decimal(100) - delta)
+                if diff < lowest:
+                    selected_call = g.eventSymbol
+                    lowest = diff
+            # set strike with the closest delta
+            put_strike = next(s for s in subchain.strikes
+                          if s.put_streamer_symbol == selected_put)
+            call_strike = next(s for s in subchain.strikes
+                          if s.call_streamer_symbol == selected_call)
+        else:
+            put_strike = next(s for s in subchain.strikes if s.strike_price == put)
+            call_strike = next(s for s in subchain.strikes if s.strike_price == call)
+
+        if width:
+            put_spread_strike = next(s for s in subchain.strikes if s.strike_price == put_strike.strike_price - width)
+            call_spread_strike = next(s for s in subchain.strikes if s.strike_price == call_strike.strike_price + width)
+            await streamer.subscribe(
+                EventType.QUOTE,
+                [
+                    call_strike.call_streamer_symbol,
+                    put_strike.put_streamer_symbol,
+                    put_spread_strike.put_streamer_symbol,
+                    call_spread_strike.call_streamer_symbol
+                ]
+            )
+            quote_dict = await listen_quotes(4, streamer)
+            bid = (quote_dict[call_strike.call_streamer_symbol].bidPrice +
+                   quote_dict[put_strike.put_streamer_symbol].bidPrice -
+                   quote_dict[put_spread_strike.put_streamer_symbol].askPrice -
+                   quote_dict[call_spread_strike.call_streamer_symbol].askPrice)
+            ask = (quote_dict[call_strike.call_streamer_symbol].askPrice +
+                   quote_dict[put_strike.put_streamer_symbol].askPrice -
+                   quote_dict[put_spread_strike.put_streamer_symbol].bidPrice -
+                   quote_dict[call_spread_strike.call_streamer_symbol].bidPrice)
+            mid = (bid + ask) / Decimal(2)
+        else:
+            await streamer.subscribe(EventType.QUOTE, [put_strike.put_streamer_symbol, call_strike.call_streamer_symbol])
+            quote_dict = await listen_quotes(2, streamer)
+            bid = sum([q.bidPrice for q in quote_dict.values()])
+            ask = sum([q.askPrice for q in quote_dict.values()])
+            mid = (bid + ask) / Decimal(2)
+
+        console = Console()
+        if width:
+            table = Table(show_header=True, header_style='bold', title_style='bold',
+                          title=f'Quote for {symbol} iron condor {subchain.expiration_date}')
+        else:
+            table = Table(show_header=True, header_style='bold', title_style='bold',
+                          title=f'Quote for {symbol} {put_strike.strike_price}/{call_strike.strike_price} strangle {subchain.expiration_date}')
+        table.add_column('Bid', style='green', width=8, justify='center')
+        table.add_column('Mid', width=8, justify='center')
+        table.add_column('Ask', style='red', width=8, justify='center')
+        table.add_row(f'{bid:.2f}', f'{mid:.2f}', f'{ask:.2f}')
+        console.print(table)
+
+        price = input('Please enter a limit price per quantity (default mid): ')
+        if not price:
+            price = round(mid, 2)
+        price = Decimal(price)
+
+        tt_symbols = [put_strike.put, call_strike.call]
+        if width:
+            tt_symbols += [put_spread_strike.put, call_spread_strike.call]
+        options = Option.get_options(sesh, tt_symbols)
+        options.sort(key=lambda o: o.strike_price)
+        if width:
+            legs = [
+                options[0].build_leg(abs(quantity), OrderAction.BUY_TO_OPEN if quantity < 0 else OrderAction.SELL_TO_OPEN),
+                options[1].build_leg(abs(quantity), OrderAction.SELL_TO_OPEN if quantity < 0 else OrderAction.BUY_TO_OPEN),
+                options[2].build_leg(abs(quantity), OrderAction.SELL_TO_OPEN if quantity < 0 else OrderAction.BUY_TO_OPEN),
+                options[3].build_leg(abs(quantity), OrderAction.BUY_TO_OPEN if quantity < 0 else OrderAction.SELL_TO_OPEN)
+            ]
+        else:
+            legs = [
+                options[0].build_leg(abs(quantity), OrderAction.SELL_TO_OPEN if quantity < 0 else OrderAction.BUY_TO_OPEN),
+                options[1].build_leg(abs(quantity), OrderAction.SELL_TO_OPEN if quantity < 0 else OrderAction.BUY_TO_OPEN)
+            ]
+        order = NewOrder(
+            time_in_force=OrderTimeInForce.GTC if gtc else OrderTimeInForce.DAY,
+            order_type=OrderType.LIMIT,
+            legs=legs,
+            price=price,
+            price_effect=PriceEffect.CREDIT if quantity < 0 else PriceEffect.DEBIT
+        )
+        acc = sesh.get_account()
+
+        data = test_order_handle_errors(acc, sesh, order)
+        if data is None:
+            return
+
+        nl = acc.get_balances(sesh).net_liquidating_value
+        bp = data.buying_power_effect.change_in_buying_power
+        percent = bp / nl * Decimal(100)
+        fees = data.fee_calculation.total_fees
+
+        table = Table(header_style='bold', title_style='bold', title='Order Review')
+        table.add_column('Quantity', width=8, justify='center')
+        table.add_column('Symbol', width=8, justify='center')
+        table.add_column('Strike', width=8, justify='center')
+        table.add_column('Type', width=8, justify='center')
+        table.add_column('Expiration', width=10, justify='center')
+        table.add_column('Price', width=8, justify='center')
+        table.add_column('BP', width=8, justify='center')
+        table.add_column('BP %', width=8, justify='center')
+        table.add_column('Fees', width=8, justify='center')
+        table.add_row(
+            f'{quantity:+}',
+            symbol,
+            f'${put_strike.strike_price:.2f}',
+            'PUT',
+            f'{subchain.expiration_date}',
+            f'${price:.2f}',
+            f'${bp:.2f}',
+            f'{percent:.2f}%',
+            f'${fees:.2f}'
+        )
+        table.add_row(
+            f'{quantity:+}',
+            symbol,
+            f'${call_strike.strike_price:.2f}',
+            'CALL',
+            f'{subchain.expiration_date}',
+            '-',
+            '-',
+            '-',
+            '-'
+        )
+        if width:
+            table.add_row(
+                f'{-quantity:+}',
+                symbol,
+                f'${put_spread_strike.strike_price:.2f}',
+                'PUT',
+                f'{subchain.expiration_date}',
+                '-',
+                '-',
+                '-',
+                '-'
+            )
+            table.add_row(
+                f'{-quantity:+}',
+                symbol,
+                f'${call_spread_strike.strike_price:.2f}',
+                'CALL',
+                f'{subchain.expiration_date}',
+                '-',
+                '-',
+                '-',
+                '-'
+            )
+        console.print(table)
+
+        if data.warnings:
+            for warning in data.warnings:
+                print_warning(warning.message)
+        warn_percent = sesh.config.getint('order', 'bp-warn-above-percent', fallback=None)
+        if warn_percent and percent > warn_percent:
+            print_warning(f'Buying power usage is above target of {warn_percent}%!')
+        if get_confirmation('Send order? Y/n '):
+            acc.place_order(sesh, order, dry_run=False)
+
+
+@option.command(help='Fetch and display an options chain.')
+@click.option('-w', '--weeklies', is_flag=True,
+              help='Show all expirations, not just monthlies.')
+@click.option('-s', '--strikes', type=int, default=8,
+              help='The number of strikes to fetch above and below the spot price.')
+@click.argument('symbol', type=str)
+async def chain(symbol: str, strikes: int = 8, weeklies: bool = False):
+    sesh = RenewableSession()
+    async with DXLinkStreamer(sesh) as streamer:
+        if symbol[0] == '/':  # futures options
+            chain = NestedFutureOptionChain.get_chain(sesh, symbol)
+            subchain = choose_futures_expiration(chain, weeklies)
+            precision = subchain.tick_sizes[0].value.as_tuple().exponent
+        else:
+            chain = NestedOptionChain.get_chain(sesh, symbol)
+            precision = chain.tick_sizes[0].value.as_tuple().exponent
+            subchain = choose_expiration(chain, weeklies)
+        precision = abs(precision) if precision < 0 else ZERO
+        precision = f'.{precision}f'
+
+        console = Console()
+        table = Table(show_header=True, header_style='bold', title_style='bold',
+                      title=f'Options chain for {symbol} expiring {subchain.expiration_date}')
+
+        show_delta = sesh.config.getboolean('option', 'chain-show-delta', fallback=True)
+        show_theta = sesh.config.getboolean('option', 'chain-show-theta', fallback=False)
+        show_oi = sesh.config.getboolean('option', 'chain-show-open-interest', fallback=False)
+        show_volume = sesh.config.getboolean('option', 'chain-show-volume', fallback=False)
+        if show_volume:
+            table.add_column(u'Volume', justify='right')
+        if show_oi:
+            table.add_column(u'Open Int', justify='right')
+        if show_theta:
+            table.add_column(u'Call \u03B8', justify='center')
+        if show_delta:
+            table.add_column(u'Call \u0394', justify='center')
+        table.add_column('Bid', style='green', justify='center')
+        table.add_column('Ask', style='red', justify='center')
+        table.add_column('Strike', justify='center')
+        table.add_column('Bid', style='green', justify='center')
+        table.add_column('Ask', style='red', justify='center')
+        if show_delta:
+            table.add_column(u'Put \u0394', justify='center')
+        if show_theta:
+            table.add_column(u'Put \u03B8', justify='center')
+        if show_oi:
+            table.add_column(u'Open Int', justify='right')
+        if show_volume:
+            table.add_column(u'Volume', justify='right')
+
+        if symbol[0] == '/':  # futures options
+            future = Future.get_future(sesh, subchain.underlying_symbol)
+            await streamer.subscribe(EventType.QUOTE, [future.streamer_symbol])
+        else:
+            await streamer.subscribe(EventType.QUOTE, [symbol])
+        quote = await streamer.get_event(EventType.QUOTE)
+        strike_price = (quote.bidPrice + quote.askPrice) / 2
+
+        subchain.strikes.sort(key=lambda s: s.strike_price)
+        if strikes * 2 < len(subchain.strikes):
+            mid_index = 0
+            while subchain.strikes[mid_index].strike_price < strike_price:
+                mid_index += 1
+            all_strikes = subchain.strikes[mid_index - strikes:mid_index + strikes]
+        else:
+            all_strikes = subchain.strikes
+
+        dxfeeds = ([s.call_streamer_symbol for s in all_strikes] +
+                   [s.put_streamer_symbol for s in all_strikes])
+        await streamer.subscribe(EventType.QUOTE, dxfeeds)
+        await streamer.subscribe(EventType.GREEKS, dxfeeds)
+        if show_oi:
+            await streamer.subscribe(EventType.SUMMARY, dxfeeds)
+        if show_volume:
+            await streamer.subscribe(EventType.TRADE, dxfeeds)
+
+        greeks_dict = await listen_greeks(len(dxfeeds), streamer)
+        # take into account the symbol we subscribed to
+        quote_dict = await listen_quotes(len(dxfeeds), streamer, skip=symbol if symbol[0] != '/' else future.streamer_symbol)
+        if show_oi:
+            summary_dict = await listen_summaries(len(dxfeeds), streamer)
+        if show_volume:
+            trade_dict = await listen_trades(len(dxfeeds), streamer)
+
+        for i, strike in enumerate(all_strikes):
+            put_bid = quote_dict[strike.put_streamer_symbol].bidPrice
+            put_ask = quote_dict[strike.put_streamer_symbol].askPrice
+            call_bid = quote_dict[strike.call_streamer_symbol].bidPrice
+            call_ask = quote_dict[strike.call_streamer_symbol].askPrice
+            row = [
+                f'{call_bid:{precision}}',
+                f'{call_ask:{precision}}',
+                f'{strike.strike_price:{precision}}',
+                f'{put_bid:{precision}}',
+                f'{put_ask:{precision}}'
+            ]
+            prepend = []
+            if show_delta:
+                put_delta = int(greeks_dict[strike.put_streamer_symbol].delta * 100)
+                call_delta = int(greeks_dict[strike.call_streamer_symbol].delta * 100)
+                prepend.append(f'{call_delta:g}')
+                row.append(f'{put_delta:g}')
+                
+            if show_theta:
+                prepend.append(f'{abs(greeks_dict[strike.put_streamer_symbol].theta):.2f}')
+                row.append(f'{abs(greeks_dict[strike.call_streamer_symbol].theta):.2f}')
+            if show_oi:
+                prepend.append(f'{summary_dict[strike.put_streamer_symbol].openInterest}')
+                row.append(f'{summary_dict[strike.call_streamer_symbol].openInterest}')
+            if show_volume:
+                prepend.append(f'{trade_dict[strike.put_streamer_symbol].dayVolume}')
+                row.append(f'{trade_dict[strike.call_streamer_symbol].dayVolume}')
+
+            prepend.reverse()
+            table.add_row(*(prepend + row), end_section=(i == strikes - 1))
+
+        console.print(table)

tastytrade_cli-0.1/ttcli/portfolio.py

@@ -0,0 +1,6 @@
+import asyncclick as click
+
+
+@click.group(help='View positions and stats for your portfolio.')
+async def portfolio():
+    pass

tastytrade_cli-0.1/ttcli/utils.py

@@ -0,0 +1,152 @@
+import getpass
+import logging
+import os
+import pickle
+import shutil
+import sys
+from configparser import ConfigParser
+from datetime import date
+from decimal import Decimal
+from typing import Optional
+
+import requests
+from rich import print as rich_print
+from tastytrade import Account, ProductionSession
+from tastytrade.order import NewOrder, PlacedOrderResponse
+
+logger = logging.getLogger(__name__)
+VERSION = '0.1'
+ZERO = Decimal(0)
+
+CONTEXT_SETTINGS = {'help_option_names': ['-h', '--help']}
+
+CUSTOM_CONFIG_PATH = '.config/ttcli/ttcli.cfg'
+DEFAULT_CONFIG_PATH = 'etc/ttcli.cfg'
+TOKEN_PATH = '.config/ttcli/.session'
+
+
+def print_error(msg: str):
+    rich_print(f'[bold red]Error: {msg}[/bold red]')
+
+
+def print_warning(msg: str):
+    rich_print(f'[light_coral]Warning: {msg}[/light_coral]')
+
+
+def test_order_handle_errors(
+    account: Account,
+    session: 'RenewableSession',
+    order: NewOrder
+) -> Optional[PlacedOrderResponse]:
+    url = f'{session.base_url}/accounts/{account.account_number}/orders/dry-run'
+    json = order.model_dump_json(exclude_none=True, by_alias=True)
+
+    response = requests.post(url, headers=session.headers, data=json)
+    # modified to use our error handling
+    if response.status_code // 100 != 2:
+        content = response.json()['error']
+        print_error(f"{content['message']}")
+        errors = content.get('errors')
+        if errors is not None:
+            for error in errors:
+                if "code" in error:
+                    print_error(f"{error['message']}")
+                else:
+                    print_error(f"{error['reason']}")
+        return None
+    else:
+        data = response.json()['data']
+        return PlacedOrderResponse(**data)
+
+
+class RenewableSession(ProductionSession):
+    def __init__(self):
+        custom_path = os.path.join(os.path.expanduser('~'), CUSTOM_CONFIG_PATH)
+        default_path = os.path.join(sys.prefix, DEFAULT_CONFIG_PATH)
+        token_path = os.path.join(os.path.expanduser('~'), TOKEN_PATH)
+
+        logged_in = False
+        # try to load token
+        if os.path.exists(token_path):
+            with open(token_path, 'rb') as f:
+                self.__dict__ = pickle.load(f)
+
+            # make sure token hasn't expired
+            logged_in = self.validate()
+
+        # load config
+        self.config = ConfigParser()
+        if not os.path.exists(custom_path):
+            # copy default config to user home dir
+            os.makedirs(os.path.dirname(custom_path), exist_ok=True)
+            shutil.copyfile(default_path, custom_path)
+            self.config.read(default_path)
+        self.config.read(custom_path)
+
+        if not logged_in:
+            # either the token expired or doesn't exist
+            username, password = self._get_credentials()
+            ProductionSession.__init__(self, username, password)
+
+            accounts = Account.get_accounts(self)
+            self.accounts = [acc for acc in accounts if not acc.is_closed]
+            # write session token to cache
+            os.makedirs(os.path.dirname(token_path), exist_ok=True)
+            with open(token_path, 'wb') as f:
+                pickle.dump(self.__dict__, f)
+            logger.debug('Logged in with new session, cached for next login.')
+        else:
+            logger.debug('Logged in with cached session.')
+
+    def _get_credentials(self):
+        username = os.getenv('TT_USERNAME')
+        password = os.getenv('TT_PASSWORD')
+        if self.config.has_section('general'):
+            username = username or self.config['general'].get('username')
+            password = password or self.config['general'].get('password')
+
+        if not username:
+            username = getpass.getpass('Username: ')
+        if not password:
+            password = getpass.getpass('Password: ')
+
+        return username, password
+
+    def get_account(self) -> Account:
+        account = self.config['general'].get('default-account', None)
+        if account:
+            try:
+                return next(a for a in self.accounts if a.account_number == account)
+            except StopIteration:
+                print_warning('Default account is set, but the account doesn\'t appear to exist!')
+
+        for i in range(len(self.accounts)):
+            if i == 0:
+                print(f'{i + 1}) {self.accounts[i].account_number} '
+                      f'{self.accounts[i].nickname} (default)')
+            else:
+                print(f'{i + 1}) {self.accounts[i].account_number} {self.accounts[i].nickname}')
+        choice = 0
+        while choice not in range(1, len(self.accounts) + 1):
+            try:
+                raw = input('Please choose an account: ')
+                choice = int(raw)
+            except ValueError:
+                if not raw:
+                    return self.accounts[0]
+        return self.accounts[choice - 1]
+
+
+def is_monthly(day: date) -> bool:
+    return day.weekday() == 4 and 15 <= day.day <= 21
+
+
+def get_confirmation(prompt: str) -> bool:
+    while True:
+        answer = input(prompt).lower()
+        if not answer:
+            return True
+        if answer[0] == 'y':
+            return True
+        if answer[0] == 'n':
+            return False