<!-- omit in toc -->

Stockstir

Easily gather stock data of any company in any of your Python projects

<p align="center"> <img src="https://img.shields.io/badge/License-MIT-brightgreen" height="23"> <img src="https://img.shields.io/badge/Creator-PatzEdi-brightgreen" height="23"> <img src="https://readthedocs.org/projects/stockstir/badge/?version=latest" height="23"> </p> <p align = "center"> <img src="https://static.pepy.tech/badge/stockstir" height="23"> <img src="https://static.pepy.tech/badge/Stockstir/week" height="23"> <img src="https://static.pepy.tech/badge/Stockstir/month" height="23"> </p> <p align = "center"> <img src="https://img.shields.io/pypi/v/Stockstir?style=flat&color=%23FFA500" height="23"> </p> <!-- omit in toc -->

Index

• Quick Usage
• Documentation:
• Changelog
• Features
• Why?
• How?
• User notice
• Build Instructions
• Services used (Credits):

<br/> <details> <summary><strong>Thank you for the support!</strong></summary> <br/>

Starrers: @inxgodmode, @Monibee-Fudgekins, @NodeGPTjs, @waltherg, @anthonyporzio, @mboliveira2006, @JorneVL, @ddkasa, @pythoninthegrass, @jeffcarrico, @kehoecj, @jftuga, @branislavhesko, @drtiwari, @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 50+ Stars! Thank you for 35K+ 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.

</details> <br/> <details> <summary><strong>A few important notes (Expand to View)</strong></summary> <br/>

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!

</details> <!-- omit in toc -->

Stockstir allows you to reliably gather data of any stock company from any of your Python projects.

Quick Usage

Installation:

pip3 install Stockstir

Python API Usage

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)

Command Line Usage

You can also use Stockstir directly from the command line:

stockstir TSLA

This will display the current price of Tesla stock in your terminal.

Additional options:

stockstir --help                       # Show all available options
stockstir AAPL --provider=insider      # Use a specific provider
stockstir MSFT --random-user-agent     # Use a random user agent for requests

<details> <summary><strong>Stockstir Object Instantiation (Expand to View)</strong></summary>

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

</details> <br/>

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.

Documentation:

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.

Changelog

• Latest Version:
• Changelog (Start Date : December 30, 2023)

Features

• 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).
• Command line interface (CLI) for quick stock price lookups directly from your terminal.
• Error handling in case of wrong inputs.
• Many more features listed in the documentation.

Why?

• 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.

How?

• 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).

User notice

• 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 prov