desprit / bicklebow

Monitoring tool for your Tinkoff Invest positions + Telegram bot to alert on market spikes.

Telegram bot that connects to your Tinkoff portoflio through the API, extracts open positions and allows you to create alerts on the market spikes. To obtain TinkoffAPI token you have to be a client of Tinkoff Invest. More info here

Installation (tested on Ubuntu 18.04)

First of all, make sure python3.8 is installed. If not, follow this article.

# Install PIP
sudo apt-get install python-pip
# Install virtualenv
sudo pip install virtualenv
# Create virtual environment
virtualenv -p python3.8 venv
# Activate it
source venv/bin/activate
# Install dependencies
pip install -r api/requirements.txt
# Initialize database
python api/src/database.py

Optionally create .env file in the root folder with the following content:

PYTHONPATH=PATH_TO_ROOT_FOLDER
ENVIRONMENT=testing
BOT_TOKEN=TOKEN_OBTAINED_FROM_BOT_FATHER
SERVER_IP=IP_ADDRESS_OF_YOUR_SERVER (only needed when using webhooks)

If you want to launch your bot on a remote server, consider using Telegram webhooks. More info on how to setup Nginx and create certificate in this Medium article.

Usage

# Run bot
python api/src/bot.py

Now connect to your bot though telegam, type /start to start conversation.

# Check triggers
python api/src/triggers.py USER_ID