Skip to content
This repository has been archived by the owner on May 29, 2020. It is now read-only.

Jordan396/JEN-stocktracker-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JEN-stocktracker-bot

Project Status: Inactive – The project has reached a stable, usable state but is no longer being actively developed; support/maintenance will be provided as time allows. Project License Latest Commit Repo Size GitHub Followers

JEN_logo

JEN is a telegram bot which notifies users when prices of their favourite stocks fall.

To use JEN:

  1. Click on this link; or
  2. Search for @stocktracker_JENbot on Telegram

Project Overview

“Opportunities come infrequently. When it rains gold, put out the bucket, not the thimble.” - Warren Buffet

Stock prices may fall drastically when market participants are pessimistic. This presents fantastic buying opportunities for investors. However, for passive investors who do not monitor stock prices on a daily basis, it is easy to miss out on such opportunities.

JEN was created to tackle this issue. Using statistical theory, JEN formulates various 3/15MA thresholds for users. At the end of each day, if the latest stock price changes exceed the user's selected threshold, JEN sends a notification. Each threshold corresponds to a sensitivity level and this affects the frequency of notifications sent.

Currently, JEN only supports stocks traded on the NYSE and NASDAQ as of 16 March 2019.


Installation

1) Obtaining Credentials

To access the AlphaVantage API, you'll need an API key which can be obtained here. You'll also need to obtain a token from Telegram's BotFather.

2) Setting up Environment

Clone this repository.

git clone https://github.com/Jordan396/JEN-stocktracker-bot.git
cd JEN-stocktracker-bot/

Create virual environment and install dependencies.

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

You'll need to create a config.py file to store your API keys and other configuration settings.

vim config.py

Add the following lines.

TELEGRAM_BOT_SECRET_KEY = [TELEGRAM BOT TOKEN]
ALPHA_VANTAGE_SECRET_KEY = [ALPHAVANTAGE API KEY]

3) Start JEN bot

The last thing we'll have to do is start JEN!

python JEN.py

Future Improvements

  • Add support for same ticker symbols on different exchanges
  • Implement flexible X/Y moving average thresholds for stocks of different volatilities

If you'd like to contribute to JEN, or to improve anything at all really, I'd love to have a chat with you! Please feel free to contact me at jordan.chyehong@gmail.com.


Disclaimer

Do your Own Research. JEN is intended to be used and must be used for informational purposes only. It is very important to do your own analysis before making any investment based on your own personal circumstances. You should take independent financial advice from a professional in connection with, or independently research and verify, any information that you find using JEN and wish to rely upon, whether for the purpose of making an investment decision or otherwise.

This disclaimer has been adapted from stockopedia.