Package: thetagang
💬 Join the Matrix chat, we can get money together.Θ ThetaGang ΘBeat the capitalists at their own game with ThetaGang 📈ThetaGang is anIBKRtrading bot for
collecting premium by selling options using "The Wheel" strategy. The Wheel
is a strategy thatsurfaced 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.How it worksStart by readingthe Reddit
postto 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 swings. By reducing risk, one can increase leverage.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 (config parameters, 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 (although this is configurable). Once puts are in
the money, they will be ignored until they expire and are exercised (after which
you will own the underlying). When rolling puts, the strike of the new contracts
are capped at the old strike plus the premium received (to prevent your account
from blowing due to over-ratcheting up the buying power usage).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
strike or 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.VIX call hedgingThetaGang can optionally hedge your account by purchasing VIX calls for the
next month based on specified parameters. The strategy is based on theCboe
VIX Tail Hedge Index, which
you can read about on the internet. You can enable this feature inthetagang.tomlwith:[vix_call_hedge]enabled=trueDefault values are provided, based on the VXTH index, but you may configure
them to your taste (refer tothetagang.tomlfor details).Buying VIX calls is not free, and itwillcreate some drag on your portfolio,
but in times of extreme volatility–such as the COVID-related 2020 market
panic–VIX calls can provide outsized returns.Cash managementAt the time of writing, interest rates have reached yields that make bonds look
attractive. To squeeze a little more juice, thetagang can do some simple cash
management by purchasing a fund when you have extra cash. Although you do earn
a yield on your cash balance, it's not the juiciest yield you can get, so a
little optimization might help you earn 1 or 2 extra pennies to take the edge
off your rent payments.There are quite a few ETFs that might be a decent place to stash your cash, and
you should do some internet searches to find the most appropriate one for you
and your feelings. Here are some internet web searches that you can test out to
get some information on cash funds (ETFs):"cash etf reddit""sgov reddit""shv reddit""short term government bond etf reddit"You can enable cash management with:[cash_management]enabled=trueRefer tothetagang.tomlfor all the options.Project statusThis 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, pleasecreate 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. 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 a 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.💫RequirementsThe bot is based on theib_insynclibrary, and usesIBCfor 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 thepoetrypackage 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.InstallationBefore running ThetaGang, you should set up an IBKR paper account to test the
code.pip install thetagangIt's recommended you familiarize yourself withIBCso 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, considerrunning ThetaGang with Docker.Usagethetagang -hUp and running with DockerMy 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 aprebuilt Docker image
here.To run ThetaGang within Docker, you'll need to passconfig.iniforIBC
configurationandthetagang.tomlfor ThetaGang. There's a sampleibc-config.iniincluded 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 ofthetagang.tomlandconfig.ini:mkdir ~/thetagangcd ~/thetagangcurl -Lq https://raw.githubusercontent.com/brndnmtthws/thetagang/main/thetagang.toml -o ./thetagang.tomlcurl -Lq https://raw.githubusercontent.com/brndnmtthws/thetagang/main/ibc-config.ini -o ./config.iniEdit~/thetagang/thetagang.tomlto 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 --net host \-v ~/thetagang:/etc/thetagang \brndnmtthws/thetagang:main \--config /etc/thetagang/thetagang.tomlLastly, 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, usecrontab -eto edit your crontab):0 9 * * 1-5 docker run --rm -i -v ~/thetagang:/etc/thetagang brndnmtthws/thetagang:main --config /etc/thetagang/thetagang.tomlDetermining which ETFs or stocks to run ThetaGang withI leave this as an exercise to the reader, however I will provide a few
recommendations and resources:RecommendationsStick with high volume ETFs or stocksCareful with margin usage, you'll want to calculate the worst case scenario
and provide plenty of cushion for yourself based on your portfolioResourcesFor discussions about selling options, check outr/thetagangFor backtesting portfolios, you can usethis
toolandthis
toolto get an idea
of drawdown and typical volatilityDevelopmentCheck out the code to your local machine and install the Python dependencies:poetry installpoetry run autohooks activatepoetry run thetagang -hYou are now ready to make a splash! 🐳FAQErrorCauseResolutionRequested market data is not subscribed.Requisite market data subscriptions have not been set up on IBKR.Configureyour market data subscriptions. The default config that ships with this script uses theCboe One Add-On Bundleand theUS Equity and Options Add-On Streaming Bundle.Note: Youmustfund 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 sessionYour 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.ib_insync.wrapper ERROR Error 200, reqId 10: The contract description specified for SYMBOL is ambiguous.IBKR needs to know which exchange is the primary exchange for a given symbol.You need to specify the primary exchange for the stock. This is normal for companies, typically. For ETFs it usually isn't required. Specify theprimary_exchangeparameter for the symbol, i.e.,primary_exchange = "NYSE".Support and sponsorshipIf you get some value out of this, please considersponsoring meto 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