{"id":17030106,"url":"https://github.com/alvarobartt/investiny","last_synced_at":"2025-10-03T22:52:30.997Z","repository":{"id":60509141,"uuid":"543635264","full_name":"alvarobartt/investiny","owner":"alvarobartt","description":"🤏🏻 `investpy` but made tiny","archived":false,"fork":false,"pushed_at":"2023-01-08T15:37:59.000Z","size":633,"stargazers_count":394,"open_issues_count":17,"forks_count":42,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-09-01T09:56:37.467Z","etag":null,"topics":["free-api","hacktoberfest","historical-data","intraday-data","investing","investing-api","investing-com","investpy","python"],"latest_commit_sha":null,"homepage":"https://alvarobartt.github.io/investiny","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alvarobartt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"alvarobartt"}},"created_at":"2022-09-30T14:16:37.000Z","updated_at":"2025-08-31T18:55:29.000Z","dependencies_parsed_at":"2023-02-08T06:31:51.181Z","dependency_job_id":null,"html_url":"https://github.com/alvarobartt/investiny","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":"alvarobartt/python-package-template","purl":"pkg:github/alvarobartt/investiny","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvarobartt%2Finvestiny","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvarobartt%2Finvestiny/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvarobartt%2Finvestiny/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvarobartt%2Finvestiny/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alvarobartt","download_url":"https://codeload.github.com/alvarobartt/investiny/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvarobartt%2Finvestiny/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278239970,"owners_count":25954097,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["free-api","hacktoberfest","historical-data","intraday-data","investing","investing-api","investing-com","investpy","python"],"created_at":"2024-10-14T08:04:20.707Z","updated_at":"2025-10-03T22:52:30.949Z","avatar_url":"https://github.com/alvarobartt.png","language":"Python","funding_links":["https://github.com/sponsors/alvarobartt"],"categories":[],"sub_categories":[],"readme":"# 🤏🏻 `investiny` is `investpy` but made tiny\n\n**`investiny` is faster, lighter, and easier to use** than `investpy`.\n\n`investiny` has been created due to the latest Investing.com changes in their API protection protocols, as \nnow their main APIs are Cloudflare V2 protected. Anyway, there are still some APIs working fine, so this package\nhas been created as a temporary replacement for `investpy` while we get to an agreement to continue the development\nof `investpy`. In the meantime, anyone can use `investiny` as I'm actively working on it, and ideally, it should support\nmost of the functionality provided by `investpy`.\n\n\n---\n\n## 🤔 What are the differences with `investpy`?\n\n**`investiny` is faster, lighter and easier to use**, but with reduced functionality for the moment. `investiny` \nlets you retrieve historical data from Investing.com through `historical_data` and search any available asset\nthrough `search_assets`, while `investpy` offers more functions to also retrieve technical indicators, economic\ncalendars, dividends, etc. but those will come at some point to `investiny` too.\n\n`investiny` introduces intraday data, so the specified intervals when retrieving historical data for any asset\navailable at Investing.com goes from 1 minute to monthly data.\n\n`investpy` uses Investing.com's APIs at https://www.investing.com/instruments/HistoricalDataAjax and at\nhttps://api.investing.com/api/financialdata/historical, that are Cloudflare protected and not working any more,\nas you'll end up getting blocked with 403 Forbidden HTTP code; while `investiny` is using https://tvc6.investing.com/,\nwhich seems to be more reliable right now according to the ran tests, as well as providing intraday data.\n\n| | Intraday Data | Any Range Historical Data | Search Assets/Quotes | Dividends | Economic Calendar | Technical Indicators | Economic News |\n|:--:|--:|--:|--:|--:|--:|--:|--:|\n| **investiny** | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |\n| **investpy**  | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n\n---\n\n## 🛠️ Installation\n\n`investiny` requires Python 3.8+ and can be installed with `pip` as it follows:\n\n`pip install investiny`\n\n---\n\n## 💻 Usage\n\nRetrieve historical data from Investing.com using the Investing.com ID of the asset\nthat you want to retrieve the data from.\n\n```python\nfrom investiny import historical_data\n\ndata = historical_data(investing_id=6408, from_date=\"09/01/2022\", to_date=\"10/01/2022\") # Returns AAPL historical data as JSON (without date)\n```\n\nThere's also a function to look for assets in Investing.com, that also lets you retrieve\nthe Investing.com ID that you can, later on, use in `historical_data` as an input parameter.\n\n```python\nfrom investiny import search_assets\n\nresults = search_assets(query=\"AAPL\", limit=1, type=\"Stock\", exchange=\"NASDAQ\") # Returns a list with all the results found in Investing.com\n```\n\nAs `search_assets` returns a list of results, you can check each of them, retrieve the `ticker` from the\nasset that you want to retrieve historical data from and pass it as a parameter to `historical_data`. So on, the\ncombination of both functions should look like the following:\n\n```python\nfrom investiny import historical_data, search_assets\n\nsearch_results = search_assets(query=\"AAPL\", limit=1, type=\"Stock\", exchange=\"NASDAQ\")\ninvesting_id = int(search_results[0][\"ticker\"]) # Assuming the first entry is the desired one (top result in Investing.com)\n\ndata = historical_data(investing_id=investing_id, from_date=\"09/01/2022\", to_date=\"10/01/2022\")\n```\n\n\n## ⚠️ Disclaimer\n\nInvesting.com is a registered trademark of Investing.com, and its services are offered by Fusion Media Limited.\n\nNeither `investpy` nor `investiny` is affiliated, endorsed, or vetted by Investing.com.\n\nBoth `investpy` and `investiny` are open-source packages that use Investing.com's available data, intended for research and educational purposes only.\n\nYou 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falvarobartt%2Finvestiny","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falvarobartt%2Finvestiny","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falvarobartt%2Finvestiny/lists"}