tastytrade-cli

An easy-to-use command line interface for Tastytrade!

https://github.com/user-attachments/assets/4a9db5c3-26c1-4b1a-a014-8c3f0fdbb754

Installation

The best way to install the CLI is by using uv. This will install tt to your path.

$ uv tool install tastytrade-cli

You can also install in a virtual environment:

$ pip install tastytrade-cli

Usage

Available commands:

tt option              view chains, buy or sell equities and futures options
tt pf (portfolio)      view and close positions, check margin and analyze BP usage
tt trade               buy or sell stocks/ETFs, crypto, and futures
tt order               view, replace, and cancel orders
tt plot                plot charts directly in the terminal! requires `gnuplot` installed
tt wl (watchlist)      view prices and metrics for symbols in your watchlists

For more options, run tt --help or tt <subcommand> --help.

Configuration

Many aspects of the CLI's behavior can be customized using the ttcli.cfg file generated upon the first usage of the CLI. The file is located in your OS's home directory followed by the path .config/ttcli/ttcli.cfg. If you don't know where that is, you can just run python -c "from ttcli.utils import config_path; print(config_path)".

The default configuration file contains lots of options along with explanations of what they do.

Development/Contributing

This project includes a number of helpers in the Makefile to streamline common development tasks. Make sure you already have uv installed!

Creating a virtualenv for development:

$ uv sync

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.