Skip to main content

🤏🏻 `investpy` but made tiny.

Project description

🤏🏻 investiny is investpy but made tiny

investiny is faster, lighter, and easier to use than investpy.

investiny has been created due to the latest Investing.com changes in their API protection protocols, as now their main APIs are Cloudflare V2 protected. Anyway, there are still some APIs working fine, so this package has been created as a temporary replacement for investpy while we get to an agreement to continue the development of investpy. In the meantime, anyone can use investiny as I'm actively working on it, and ideally, it should support most of the functionality provided by investpy.


🤔 What are the differences with investpy?

investiny is faster, lighter and easier to use, but with reduced functionality for the moment. investiny lets you retrieve historical data from Investing.com through historical_data and search any available asset through search_assets, while investpy offers more functions to also retrieve technical indicators, economic calendars, dividends, etc. but those will come at some point to investiny too.

investiny introduces intraday data, so the specified intervals when retrieving historical data for any asset available at Investing.com goes from 1 minute to monthly data.

investpy uses Investing.com's APIs at https://www.investing.com/instruments/HistoricalDataAjax and at https://api.investing.com/api/financialdata/historical, that are Cloudflare protected and not working any more, as you'll end up getting blocked with 403 Forbidden HTTP code; while investiny is using https://tvc4.investing.com/, which seems to be more reliable right now according to the ran tests, as well as providing intraday data.

Intraday Data Any Range Historical Data Search Assets/Quotes Dividends Economic Calendar Technical Indicators Economic News
investiny
investpy

🛠️ Installation

investiny requires Python 3.8+ and can be installed with pip as it follows:

pip install investiny


💻 Usage

Retrieve historical data from Investing.com using the Investing.com ID of the asset that you want to retrieve the data from.

from investiny import historical_data

data = historical_data(investing_id=6408, from_date="09/01/2022", to_date="10/01/2022") # Returns AAPL historical data as JSON (without date)

There's also a function to look for assets in Investing.com, that also lets you retrieve the Investing.com ID that you can, later on, use in historical_data as an input parameter.

from investiny import search_assets

results = search_assets(query="AAPL", limit=1, type="Stock", exchange="NASDAQ") # Returns a list with all the results found in Investing.com

As search_assets returns a list of results, you can check each of them, retrieve the ticker from the asset that you want to retrieve historical data from and pass it as a parameter to historical_data. So on, the combination of both functions should look like the following:

from investiny import historical_data, search_assets

search_results = search_assets(query="AAPL", limit=1, type="Stock", exchange="NASDAQ")
investing_id = int(search_results[0]["ticker"]) # Assuming the first entry is the desired one (top result in Investing.com)

data = historical_data(investing_id=investing_id, from_date="09/01/2022", to_date="10/01/2022")

⚠️ Disclaimer

Investing.com is a registered trademark of Investing.com, and its services are offered by Fusion Media Limited.

Neither investpy nor investiny is affiliated, endorsed, or vetted by Investing.com.

Both investpy and investiny are open-source packages that use Investing.com's available data, intended for research and educational purposes only.

You should refer to Investing.com's terms and conditions at https://www.investing.com/about-us/terms-and-conditions for details on your rights to use the actual data, as it is intended for personal use only.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

investiny-0.7.1.tar.gz (9.6 kB view details)

Uploaded Source

Built Distribution

investiny-0.7.1-py3-none-any.whl (9.2 kB view details)

Uploaded Python 3

File details

Details for the file investiny-0.7.1.tar.gz.

File metadata

  • Download URL: investiny-0.7.1.tar.gz
  • Upload date:
  • Size: 9.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.2 CPython/3.9.15 Linux/5.15.0-1020-azure

File hashes

Hashes for investiny-0.7.1.tar.gz
Algorithm Hash digest
SHA256 e995b09217f6d8cb8eea0373178e7f491323ae7fd71dde8e07f149f426c9c4f4
MD5 fa6359d1be08080ada1cccab97a755cf
BLAKE2b-256 bb9bf2924161cb1168ef34028806b0cc2c38916f889e4eacf834aa717ddaa9aa

See more details on using hashes here.

File details

Details for the file investiny-0.7.1-py3-none-any.whl.

File metadata

  • Download URL: investiny-0.7.1-py3-none-any.whl
  • Upload date:
  • Size: 9.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.2 CPython/3.9.15 Linux/5.15.0-1020-azure

File hashes

Hashes for investiny-0.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c97ffbeb169c45f14f9de5c5582e5b4b2d497e306eed5c1038ef792db7775b9a
MD5 b37421597884787d11cf24712ae14241
BLAKE2b-256 efab7238346c423e758820ae65afe92c9e8bab4b142233ae356add0cf1a5480f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page