Easily gather stock data of any company in any of your Python projects
- Quick Usage
- Documentation:
- Changelog
- Features
- Why?
- How?
- User notice
- Build Instructions
- Services used (Credits):
Thank you for the support!
Starrers: @poa00, @gusdanielson, @joolybugg, @BHX2, @electronicjude, @zdrummond, @JamesSullivan, @mptsolutions, @FrankD412, @fumbles, @shunsock, @verystealthy, @agarcialeon, @hassan-surmount, @DeflateAwning, @ThinkCode, @stvnksslr,@rawberg, @z1001123, @soundtrackgeek, @Giddu, @T31M, @somas1, @rexzhang, @arturo-zarzilla, @dfd, @ArcturusMajere, @LambertusDekker, @508chris, @PandaStacker, @piksu, @cameronhptdev, @bazfire, @AceofSpades5757, @georgettica, @LeonardPuettmann, @Shrhawk, @builderjer
Thank you for 35+ Stars! Thank you for 10K+ Downloads! If you do not wish to be in the list above, please let me know by either creating an issue or messaging me through reddit (linked on my website https://patzedi.github.io). Also, it may take me a while (depending on the time) to put new stargazers on the README, but it will be done nonetheless :) Also, if you are viewing on PyPi, this list above will most likely not be updated to the latest amount of starrers, as I would have to create a new release every time. Commits for new starrers will take place on the GitHub page.
A few important notes (Expand to View)
Verified commits are now being used (Verified commits are used to make sure you know the real developer/trusted person is comitting to the branch/project)
Automatic provider integrity/validity checks have now been implemented on my side through crontab! Checks run 5 times a day, and a notification is sent to my phone and desktop to notify me of the status. This way, if any provider fails, I will be notified much sooner than before
As a reminder, if any errors are found in the documentation, codebase, etc. feel free to create an issue on the Github page. We are all here to learn and improve. Thanks!
Installation:
pip3 install Stockstir
Importing:
from stockstir import Stockstir
Simple example to gather stock data from any script:
price = Stockstir().tools.get_single_price("AMZN") # As an example, we can get the Amazon stock value.
print(price)
Stockstir Object Instantiation (Expand to View)
stockstir = Stockstir()
# Below, as an example, we can instantiate the classes within the Stockstir object, which is in this case called stockstir.
tools = stockstir.tools
providers = stockstir.providers
api = stockstir.api
You can also customize certain aspects of each Stockstir object you instantiate:
stockstir = Stockstir(provider = 'cnbc', random_user_agent=True, print_output = True) # default provider = 'cnbc' (can be set to 'insider' or 'zacks' as well (cnbc recommended)), random_user_agent defaults to False, print_output defaults to False. (Note: print_output is only used for certain funcs such as multi_data_gathering)
# Below, as an example, we can instantiate the classes within the Stockstir object, which is in this case called stockstir.
tools = stockstir.tools
providers = stockstir.providers
api = stockstir.api
Since this library has many more features (too many to explain here in a neat way), you can take a look at the Documentation hosted by readthedocs.io.
Access the Stockstir ReadtheDocs Documentation to explore the features of Stockstir and how to use them, as well as getting to know how Stockstir works in a detailed way. The documentation is now updated to the latest version.
- Latest Version:
- Changelog (Start Date : December 30, 2023)
- A complete fail-safe system with three providers (Read documentation for more information on providers).
- Gather stock data of any company using cnbc, insiders, or zacks as the current providers (alternative to yfinance)
- Includes a single price gathering tool to get the price of any company once.
- Includes a multi data gathering tool which has features like anti ban, random user agents, delay for each request, and of course how much data to gather.
- Get the trend of the gathered data determining whether the stock price went up, down, or stayed neutral throughout that time period.
- Ability to return the time spent in the total process of gathering the data. This can be useful in order to analyze data and comparing it to the time spent overall. Not only that, but getting the trend also comes with an optional option to get the change between the first and the last value of the gathered data.
- Includes a tool to create logs of the data gathered if needed, and does so by writing the data to a file at a specified directory of your choice.
- Includes the ability to make requests with random user agents (up to 24 different agents).
- Parameter customization of Stockstir objects (more information in the documentation).
- Error handling in case of wrong inputs.
- Many more features listed in the documentation.
- As an alternative to other systems like yfinance, Stockstir insures that you can always gather stock company data no matter what. It is a simple way to gather stock data without the need to learn full-fledged systems.
- Real time stock data can be used to look at a specific price of any company and determine what to do with that data later on. For example, if you wanted to get notified once the price of stock goes above or below a value, it is a simple task to do something like that.
- Stockstir mainly works by sending a request to providers (view documentation for more information), and parsing the request via a regex pattern to gather the price. It currently has three providers with a fail-safe mechanism that switches provider if the selected one fails. (Again, view documentation to learn more about providers and their functionality).
- Please be aware that using a rotating IP address (for example a VPN with a rotating IP) could help you not get banned from a provider when making a lot of requests. If you want to use the multi data gathering tool, you can use the anti ban function to try to avoid getting banned from the website and being recognized as a potential "bot" making automatic requests.
- This project is still a work in progress. Adding new features is very easy, but so far I have started with it simple.
- Please note that the README file briefly goes into the details of how the project works. If you want more in depth details of what each and every function and parameter does, take a look at the Documentation hosted on readthedocs.io.
- Also, I am not responsible for any inappropriate use of this library, such as being used for spam or mass-collection purposes. This project is strictly for educational purposes only.
To build Stockstir directly onto your local machine without installing from pypi, you can follow these steps below:
- Clone the repository:
git clone https://github.com/PatzEdi/Stockstir
- Enter the project files directory (assuming you are in the same directory as when you cloned Stockstir):
cd Stockstir
- Build and install Stockstir via pip3:
pip3 install -e .
- Done! Stockstir is now installed on your local machine.
Contributors (Expand to View)
Thank you all for your suggestions for improving Stockstir!-
striata for the suggestions on following PEP guidelines and code efficiency enhancements in this post, thank you!
-
PandaStacker for taking the time to suggest new functions for Stockstir in this pull request. Thanks for the contributions!
-
suvanbanerjee in pull request #8 for adding new error handling to the api class. Thanks!
Contributors in this list gave me permission to put them on the README
- Thank you for your interest in Stockstir. If you like this project, please leave a star :)