![Logo](/gafzan/Koyfin/raw/master/images/logo_share_fb.png)
A web bot launches koyfin.com, performs a screener and downloads the data automatically into csv files.
Table of Contents
This project is about automatizing parts of gathering data from koyfin.com while using their screener tool. Since the koyfin screener only displays data for the top 2000 stocks, in cases where you want to download data for more than that, this project allows you to break down the screening criteria in components to allow you to get all the data.
This requires that you have at least a "Plus" koyfin membership since it allows you to download data (the free membership does not).
-
Donwload chromedriver and make sure that it is the same version as your Chrome browser
-
You will need to store your koyfin.com credentials as well as the full path to your chromedriver.exe file as Environmental variables
- Clone the repo
git clone https://github.com/gafzan/Koyfin.git
- Install all required packages
pip install requirements.txt
As an example, let's say that we want to download data for all stocks in United States and Sweden that are either in the banking or energy industry (why not...?) using the Koyfinbot.
First step is to import what we need.
from koyfinbot import KoyfinBot
Next is to create a dictionary with the criteria. The values in the dictionary can either be strings or list of strings.
criteria = {
'country': ['United States', 'Sweden'],
'industry': ['Banks', 'Energy']
}
Next we will setup the workflow for the KoyfinBot. We will create an instance of the object and login with our credentials.
bot = KoyfinBot() # initialize an instance of a KoyfinBot object
bot.login() # insert your credentials
Next go to the 'My Screens' page, add a new screen and specify our criteria by inputting the above dictionary in
add_universe_criteria()
. We will also name the screen 'KoyfinBot demo'
bot.go_to_my_screens() # goes to the 'My Screens' page
bot.add_new_screen()
bot.name_screen(name='KoyfinBot demo')
bot.add_universe_criteria(criteria=criteria)
bot.run_screener()
Once we have our filtered universe of stocks we could download the results but the data for each stock will be dictated by the default data columns in Koyfin. We can customize the data columns by providing another dictionary. Assume that the desired data is to get the industry, total debt and revenue growth estimates for the next 1, 2 and 3 years (if available), then we can add columns like below and then download screener result.
data = {
'Industry': None,
'Total Debt': 'Last Twelve Months',
'Revenue Estimate CAGR': ['1 Year', '2 Year', '3 Year'],
}
bot.add_data_columns(data_columns_config=data)
bot.download_screener_result() # the csv file will be stored under 'Downloads'
bot.driver.close()
The entire script looks like this:
from koyfinbot import KoyfinBot
criteria = {
'country': ['United States', 'Sweden'],
'industry': ['Banks', 'Energy']
}
data = {
'Industry': None,
'Total Debt': 'Last Twelve Months',
'Revenue Estimate CAGR': ['1 Year', '2 Year', '3 Year'],
}
bot = KoyfinBot() # initialize an instance of a KoyfinBot object
bot.login() # insert your credentials
bot.go_to_my_screens() # goes to the 'My Screens' page
bot.add_new_screen()
bot.name_screen(name='KoyfinBot demo')
bot.add_universe_criteria(criteria=criteria)
bot.run_screener()
bot.add_data_columns(data_columns_config=data)
bot.download_screener_result() # the csv file will be stored under 'Downloads'
bot.driver.close()
This script worked for simple sets of criteria. If criteria is more complex where we need to have several
dictionaries we can use the KoyfinDataDownloader
class. This object downloads data according to several criteria configurations and
merges the data. Below is an example of an implementation where we want data for only bank stocks in United States and energy stocks in Sweden:
from koyfinbot import KoyfinDataDownloader
criteria = [
{
'country': 'United States',
'industry': 'Banks'
},
{
'country': 'Sweden',
'industry': 'Energy'
}
]
data = {
'Industry': None,
'Total Debt': 'Last Twelve Months',
'Revenue Estimate CAGR': ['1 Year', '2 Year', '3 Year'],
}
bot = KoyfinDataDownloader(screen_criteria=criteria)
bot.download_data(data_config=data)
bot.save_data()
By default, the merged data will be saved in your downloads folder. You can change the save location
by changing KOYFIN_DATA_FOLDER_PATH
variable in config.py
.