Metadata-Version: 2.1
Name: investpy
Version: 0.5
Summary: investpy - is a financial tool for stock analysis that retrieves historical data from Investing.com
Home-page: UNKNOWN
Author: Alvaro Bartolome
Author-email: alvarob96@usal.es
License: MIT License
Download-URL: https://github.com/alvarob96/investpy/archive/0.5.tar.gz
Description: # Investing Scraper of historical data from continuous spanish stock market
        
        [![Python Version](https://img.shields.io/pypi/pyversions/investpy.svg)](https://pypi.org/project/investpy/)
        [![PyPi Version](https://img.shields.io/pypi/v/investpy.svg)](https://pypi.org/project/investpy/)
        [![Build Status](https://travis-ci.org/alvarob96/investpy.svg?branch=master)](https://pypi.org/project/investpy/)
        
        ## Introduction
        
        Since [**Investing**](https://es.investing.com/) does not have an API to retrieve historical data of the **Continuous Spanish Stock Market**, I decided to develop a scraper to retrieve that information.
        
        I developed this scraper in order to get the data from Investing for my Final Degree Project at the University of Salamanca titled "**Machine Learning for stock investment recommendation systems**".
        
        To sum up this is not the final version of this scraper since this is just the pre-alpha version of it. So I will continue scraping information indexed in investing so you can be able to retrieve more data, as soon as I can.
        
        ## Installation
        
        In order to get this package working you will need to install [**investpy**](https://pypi.org/project/investpy/) from PyPi via Terminal:
        
        ``pip install investpy``
        
        All the dependencies are already listed on the setup file of the package, but to sum it up, you will need this requirements:
        
        * [**pandas 0.23.4**](https://pypi.org/project/pandas/)
        * [**requests 2.20.0**](https://pypi.org/project/requests/)
        * [**pytest 4.0.2**](https://pypi.org/project/pytest/)
        * [**beautifulsoup4 4.6.3**](https://pypi.org/project/beautifulsoup4/)
        
        ## Use
        
        Currently you just have two possible options to retrieve data with this scraper:
        
        * **Retrieve the recent data of a stock**: it retrieves the historical data from a stock from the last month. The function also checks if the introduced equity name is correct and then retrieves the data.
        ```
        import investpy as ivs
        
        df = ivs.get_recent_data('bbva')
        ```
        
        * **Retrieve the historical data of a stock from a specific range of time**: it retrieves the historical data from a stock from a range of time between the start date and the end date, specified in dd/mm/YY format. This function also checks is the introduced equity name is correct and then retrieves the data.
        ```
        import investpy as ivs
        
        df = ivs.get_historical_data('bbva', '10/10/2018', '10/12/2018')
        ```
        
        You can check all the available equities for the **Spanish Stock Market** in this list from Investing: https://es.investing.com/equities/spain
        
        (**NOTE**: you will need an active HTTP connection in order to get the scraper working. As a temporary solution, you can just store the retrieved pandas.DataFrame in a CSV so you can work with that data offline.)
        
        ## Development
        
        * Spanish ETFs -> https://es.investing.com/etfs/spain-etfs
        * Spanish Funds -> https://es.investing.com/funds/spain-funds **(In progress)**
        * Output as a JSON file (API like)
        * Latest Spanish Stock News -> https://es.investing.com/search/?q=ticker&tab=news
        * Allow multiple date formats
        * Improve performance
        
        ## Information
        
        For further information or any question feel free to contact me via email at alvarob96@usal.es
        
        **Disclaimer:** this is just for personal use, I am not related at all with Investing or any similar company. This is just a tool for the research project I am working on. I get no profit or economic benefit from this scraper. I also contacted Investing.com and they gave me permission to develop this project with the condition of mentioning the source where I get the data from.
        
Keywords: investing-api,spanish-stock-market,scraper,historical-data,financial-data,stock
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/markdown
