API to fetch stock data fundamentals from finanzen.net
Finanzen-Fundamentals is a Python package that can be used to retrieve fundamentals of stocks. The data is fetched from finanzen.net, a German language financial news site. Note that the api is English but all data will be returned in German.
You can easily install finanzen-fundamentals via pip:
pip install finanzen-fundamentals
If you choose to download the source code, make sure that you have the following dependencies installed:
You can install all of them by running:
pip install requests bs4 lxml pandas numpy.
After you successfully installed the package, you can include it in your projects by importing it.
import finanzen_fundamentals.stocks as ff
You can retrieve the fundamentals of a single stock by running:
bmw_fundamentals = ff.get_fundamentals("bmw")
This will fetch the fundamentals of BMW and save it into a Pandas DataFrame called bmw_fundamentals. The data is split into the following categories:
- Key Ratios
- Income Statement
- Balance Sheet
Optionally, you can add the argument
output = "dict". Instead of a Pandas DataFrame, you will receive a dictionary. Every category will hold another dictionary.
bmw_fundamentals = ff.get_fundamentals("bmw", output = "dict")
You can also fetch estimates for expected values by using:
bmw_estimates = ff.get_estimates("bmw")
Again, the data will be saved as a Pandas DataFrame. If you want to receive the data as a dictionary, you could use
output = "dict" again.
bmw_estimates = ff.get_estimates("bmw", output = "dict")
Note that we use stock names not stock symbols when fetching data. You can search for stock names by using
ff.search_stock("bmw", limit = 3)
This will print the three most matching stock names for your search. You can increase the limit to 30. If you don't give a parameter, all available data will be printed (up to 30).
Thanks to the contribution of backster82, there is also a xml based alternative to the preceeding functions. All of the following functions will return a Pandas DataFrame. Note that get_fundamentals and get_estimates now incorporates the functionallity of the alternative implementation. Hence, you will receive deprecation warning upon using these functions.
You can obtain fundamentals like so:
bmw_fundamentals = ff.get_fundamentals_lxml("bmw")
Estimates can be loaded via:
bmw_estimates = ff.get_estimates_lxml("bmw")
Additionally, you can also load the current stock price for a vast selection of stock exchanges. For example, you can retrieve the current stock prices for BMW by using the following line of code:
bmw_price = ff.get_current_value_lxml("bmw")
This will give you the current price at Tradegate. However, you can change the stock exchange by entering its symbol for the "exchange" argument. If you want to obtain the current price of BMW stocks at the Frankfurt Stock Exchange, you can use the following command:
bmw_price_frankfurt = ff.get_current_value_lxml("bmw", exchange = "FSE")
You can find all available exchanges by inspecting the StockMarkets dictionary in
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size finanzen_fundamentals-0.0.42-py3-none-any.whl (9.7 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size finanzen-fundamentals-0.0.42.tar.gz (9.6 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for finanzen_fundamentals-0.0.42-py3-none-any.whl
Hashes for finanzen-fundamentals-0.0.42.tar.gz