Awesome Open Source
Awesome Open Source

Docker publish Python Publish Docker Pulls PyPI download month

๐Ÿ’ฌ Join the Matrix chat, we can get money together.

ฮ˜ ThetaGang ฮ˜

Beat the capitalists at their own game with ThetaGang ๐Ÿ“ˆ

Decay my sweet babies

ThetaGang is an IBKR trading bot for collecting premium by selling options using "The Wheel" strategy. The Wheel is a strategy that surfaced on Reddit, but has been used by many in the past. This bot implements a slightly modified version of The Wheel, with my own personal tweaks.

I've been streaming most of the work on this project on Twitch, so follow me over there.

How it works

Start by reading the Reddit post to get some background.

The strategy, as implemented here, does a few things differently from the one described in the post above. For one, it's intended to be used to augment a typical index-fund based portfolio with specific asset allocations. For example, you might want to use a 60/40 portfolio with SPY (S&P500 fund) and TLT (20 year treasury fund). This strategy reduces risk, but may also limit gains from big market swingsn.

The main difference between ThetaGang and simply buying and holding index funds is that this script will attempt to harvest volatility by selling options, rather than buying shares directly. This works because implied volatility is typically higher than realized volatility on average. Instead of buying shares, you write puts. This has pros and cons, which are outside the scope of this README.

You could use this tool on individual stocks, but I personally don't recommend it because I am not smart enough to understand which stocks to buy. That's why I just buy index funds.

ThetaGang will try to acquire your desired allocation of each stock or ETF according to the weights you specify in the config. To acquire the positions, the script will write puts when conditions are met (adequate buying power, acceptable contracts are available, enough shares needed, etc).

ThetaGang will continue to roll any open option positions indefinitely, with the only exception being ITM puts. Once puts are in the money, they will be ignored until they expire and are exercised (after which you will own the underlying).

If puts are exercised due to being ITM at expiration, you will own the stock, and ThetaGang switches from writing puts to writing calls at a strike at least as high as the average cost of the stock held.

Please note: this strategy is based on the assumption that implied volatility is, on average, always higher than realized volatility. In cases where this is not true, this strategy will cause you to lose money.

In the case of deep ITM calls, the bot will prefer to roll the calls to next expiration rather than allowing the underlying to get called away. If you don't have adequate buying power available in your account, it's possible that the options may get exercised instead of rolling forward and the process starts back at the beginning. Please keep in mind this may have tax implications, but that is outside the scope of this README.

In normal usage, you would run the script as a cronjob on a daily, weekly, or monthly basis according to your preferences. Running more frequently than daily is not recommended, but the choice is yours.

Paper account sample output

Project status

This project is, in its current state, considered to be complete. I'm open to contributions, but I am unlikely to accept PRs or feature requests that involve significant changes to the underlying algorithm.

If you find something that you think is a bug, or some other issue, please create a new issue.

"Show me your gains bro" โ€“ i.e., what are the returns?

As discussed elsewhere in this README, you must conduct your own research, and I suggest starting with resources such as CBOE's BXM and BXDM indices, and comparing those to SPX. I've had a lot of people complain because "that strategy isn't better than buy and hold BRUH"โ€“let me assure you, that is not my goal with this.

There are conflicting opinions about whether selling options is good or bad, more or less risky, yadda yadda, but generally the risk profile for covered calls and naked puts is no worse than the worst case for simply holding an ETF or stock. In fact, I'd argue that selling a naked put is better than buying SPY with a limit order, because at least if SPY goes to zero you keep the premium from selling the option. The main downside is that returns are capped on the upside. Depending on your goals, this may not matter. If you're like me, then you'd rather have consistent returns and give up a little bit of potential upside.

Generally speaking, the point of selling options is not to exceed the returns of the underlying, but rather to reduce risk. Reducing risk is an important feature because it, in turn, allows one to increase risk in other ways (i.e., allocate higher percentage to stocks or buy riskier assets).

Whether you use this or not is up to you. I have not one single fuck to give, whether you use it or not. I am not here to convince you to use it, I merely want to share knowledge and perhaps help create a little bit of wealth redistribution.



The bot is based on the ib_insync library, and uses IBC for managing the API gateway.

To use the bot, you'll need an Interactive Brokers account with a working installation of IBC. If you want to modify the bot, you'll need an installation of Python 3.8 or newer with the poetry package manager.

One more thing: to run this on a live account, you'll require enough capital to purchase at least 100 shares of the stocks or ETFs you choose. For example, if SPY is trading at $300/share you'd need $30,000 available. You can search for lower priced alternatives, but these tend to have low volume on options which may not be appropriate for this strategy. You should generally avoid low volume ETFs/stocks. If you don't have that kind of capital, you'll need to keep renting out your time to the capitalists until you can become a capitalist yourself. That's the way the pyramid scheme we call capitalism works.


Before running ThetaGang, you should set up an IBKR paper account to test the code.

$ pip install thetagang

It's recommended you familiarize yourself with IBC so you know how it works. You'll need to know how to configure the various knows and settings, and make sure things like API ports are configured correctly. If you don't want to mess around too much, consider running ThetaGang with Docker.


$ thetagang -h

Up and Running with Docker

My preferred way for running ThetaGang is to use a cronjob to execute Docker commands. I've built a Docker image as part of this project, which you can use with your installation. There's a prebuilt Docker image here.

To run ThetaGang within Docker, you'll need to pass config.ini for IBC configuration and thetagang.toml for ThetaGang. There's a sample ibc-config.ini included in this repo for your convenience.

The easiest way to get the config files into the container is by mounting a volume.

To get started, grab a copy of thetagang.toml and config.ini:

$ mkdir ~/thetagang
$ cd ~/thetagang
$ curl -Lq -o ~/thetagang/thetagang.toml
$ curl -Lq -o ~/thetagang/config.ini

Edit ~/thetagang/thetagang.toml to suit your needs. Pay particular attention to the symbols and weights. At a minimum, you must change the username, password, and account number. You may also want to change the trading move from paper to live when needed.

Now, to run ThetaGang with Docker:

$ docker run --rm -i \
    -v ~/thetagang:/etc/thetagang \
    brndnmtthws/thetagang:latest \
    --config /etc/thetagang/thetagang.toml

Lastly, to run ThetaGang as a daily cronjob Monday to Friday at 9am, add something like this to your crontab (on systems with a cron installation, use crontab -e to edit your crontab):

0 9 * * 1-5 docker run --rm -i -v ~/ibc:/etc/thetagang brndnmtthws/thetagang:latest --config /etc/thetagang/thetagang.toml

Determining which ETFs or stocks to run ThetaGang with

I leave this as an exercise to the reader, however I will provide a few recommendations and resources:


  • Stick with high volume ETFs or stocks
  • Careful with margin usage, you'll want to calculate the worst case scenario and provide plenty of cushion for yourself based on your portfolio


  • For discussions about selling options, check out r/thetagang
  • For backtesting portfolios, you can use this tool and this tool to get an idea of drawdown and typical volatility


Check out the code to your local machine and install the Python dependencies:

$ poetry install
$ poetry run autohooks activate
$ poetry run thetagang -h

You are now ready to make a splash! ๐Ÿณ


Error Cause Resolution
Requested market data is not subscribed. Requisite market data subscriptions have not been set up on IBKR. Configure your market data subscriptions. The default config that ships with this script uses the Cboe One Add-On Bundle and the US Equity and Options Add-On Streaming Bundle. Note: You must fund your account before IBKR will send data for subscriptions. Without funding you can still subscribe but you will get an error from ibc.
No market data during competing live session Your account is logged in somewhere else, such as the IBKR web portal, the desktop app, or even another instance of this script. Log out of all sessions and then re-run the script.

Support and sponsorship.

If you get some value out of this, please consider sponsoring me to continue maintaining this project well into the future. Like everyone else in the world, I'm just trying to survive.

If you like what you see but want something different, I am willing to work on bespoke or custom trading bots for a fee. Reach out to me directly through my GitHub profile.

Stargazers over time

Stargazers over time

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (51,962)ย 
bot (728)ย 
trading-bot (105)ย 
money (75)ย 
strategy (45)ย 

Find Open Source By Browsing 7,000 Topics Across 59 Categories

Advertising ๐Ÿ“ฆย 10
All Projects
Application Programming Interfaces ๐Ÿ“ฆย 124
Applications ๐Ÿ“ฆย 192
Artificial Intelligence ๐Ÿ“ฆย 78
Blockchain ๐Ÿ“ฆย 73
Build Tools ๐Ÿ“ฆย 113
Cloud Computing ๐Ÿ“ฆย 80
Code Quality ๐Ÿ“ฆย 28
Collaboration ๐Ÿ“ฆย 32
Command Line Interface ๐Ÿ“ฆย 49
Community ๐Ÿ“ฆย 83
Companies ๐Ÿ“ฆย 60
Compilers ๐Ÿ“ฆย 63
Computer Science ๐Ÿ“ฆย 80
Configuration Management ๐Ÿ“ฆย 42
Content Management ๐Ÿ“ฆย 175
Control Flow ๐Ÿ“ฆย 213
Data Formats ๐Ÿ“ฆย 78
Data Processing ๐Ÿ“ฆย 276
Data Storage ๐Ÿ“ฆย 135
Economics ๐Ÿ“ฆย 64
Frameworks ๐Ÿ“ฆย 215
Games ๐Ÿ“ฆย 129
Graphics ๐Ÿ“ฆย 110
Hardware ๐Ÿ“ฆย 152
Integrated Development Environments ๐Ÿ“ฆย 49
Learning Resources ๐Ÿ“ฆย 166
Legal ๐Ÿ“ฆย 29
Libraries ๐Ÿ“ฆย 129
Lists Of Projects ๐Ÿ“ฆย 22
Machine Learning ๐Ÿ“ฆย 347
Mapping ๐Ÿ“ฆย 64
Marketing ๐Ÿ“ฆย 15
Mathematics ๐Ÿ“ฆย 55
Media ๐Ÿ“ฆย 239
Messaging ๐Ÿ“ฆย 98
Networking ๐Ÿ“ฆย 315
Operating Systems ๐Ÿ“ฆย 89
Operations ๐Ÿ“ฆย 121
Package Managers ๐Ÿ“ฆย 55
Programming Languages ๐Ÿ“ฆย 245
Runtime Environments ๐Ÿ“ฆย 100
Science ๐Ÿ“ฆย 42
Security ๐Ÿ“ฆย 396
Social Media ๐Ÿ“ฆย 27
Software Architecture ๐Ÿ“ฆย 72
Software Development ๐Ÿ“ฆย 72
Software Performance ๐Ÿ“ฆย 58
Software Quality ๐Ÿ“ฆย 133
Text Editors ๐Ÿ“ฆย 49
Text Processing ๐Ÿ“ฆย 136
User Interface ๐Ÿ“ฆย 330
User Interface Components ๐Ÿ“ฆย 514
Version Control ๐Ÿ“ฆย 30
Virtualization ๐Ÿ“ฆย 71
Web Browsers ๐Ÿ“ฆย 42
Web Servers ๐Ÿ“ฆย 26
Web User Interface ๐Ÿ“ฆย 210