{ "info": { "author": "Lukas Budach", "author_email": "lukas.budach@student.hpi.de", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# Finance Scaper [![Build Status](https://travis-ci.org/LukasBudach/FinanceScraper.svg?branch=master)](https://travis-ci.org/LukasBudach/FinanceScraper) [![codecov](https://codecov.io/gh/LukasBudach/FinanceScraper/branch/master/graph/badge.svg)](https://codecov.io/gh/LukasBudach/FinanceScraper)\n\n\nThis project aims to provide an up-to-date data scraper for yahoo finance as a simple stock data API.\nFor an in-depth view on the project check out its [documentation](https://financescraper.readthedocs.io/en/latest/).\n\n## The purpose & why to use Finance Scraper\nThere are a lot of APIs allowing you to pull stock/market data available for python. \n[Pandas Data Reader](https://pandas-datareader.readthedocs.io/en/latest/), \n[googlefinance](https://pypi.org/project/googlefinance/),\n[IEXTrading](https://iextrading.com/developer/docs/#getting-started) are a just a few\nof the massive amounts of data sources you could use for your application. \n\nSo **why use the FinanceScraper API**? Well, there are a few issues with a lot of the\nAPIs readily available online:\n1. A lot of the APIs are out of date. Both Yahoo and Google have stepped back from\nproviding APIs for finance data during the last couple of years and a lot of the\nexisting project - especially on GitHub - were created before that happened and never\nmaintained properly afterwards.\n2. Those data sources that do work properly, often only provide access to a few\nselect markets, most of the time the American stock market. This obviously might\nrestrict your application, especially if you are planning to cater to an international\naudience.\n3. Another issue with commercially maintained APIs often comes with the usage. The free\naccess usually harshly restricts usage by limiting the quotes per minute or per day.\nIf you ever plan to provide your app to the general public, or just a couple of\nfriends, this could put you in a difficult situation of choosing between a free plan\nor a generally usable program.\n\nHowever, there are a couple of things other APIs can do better than this one. This is\nwhy I do want to also tell you when **not** to use this API:\n* You only need data from a **single market**. There are probably a bunch of APIs \nspecializing in data from the market you are looking at. Take a look at those before \njumping into FinanceScraper.\n* You want to write a little application for your **personal use only**. In this case\nthe free plans of commercially available APIs are probably enough for you. Maybe take\na look at [WorldTradingData](https://www.worldtradingdata.com/).\n* You need a lot of data very fast and have no means of parallel execution. In this \ncase you will probably want to use one of the well established APIs, as this project\nis doing full HTML requests to ensure the most recent quotes possible. If you however\nhave a lot of rapid requests on the same data you may want to check out this\nprojects data caching/buffering capabilities.\n\n## Project setup\n\nIf you simply want to use the API, I recommend using the latest stable version \nwhich can be acquired by running `` pip install FinanceScraper ``. For the API's\nusage take a look at the documentation. (I swear it will come soon, this is still\nin it's very beginning)\n\nIf you are looking to contribute to this project please go ahead! You're going to have\nto fork the project and do your work in your own repository. If you are seeing anything\nthat could/should be improved please put in an issue and I will assign you if you want\nto solve it yourself. In order to get your progress into this main project you just have\nto put in a pull request for a branch up-to-date with the current master.\n\n## ToDo\nNow I also want to tell you about what I am planning to add to this project for the\nnext major, minor and micro versions.\n\n### Micro\ncurrently no clear goals for the next micro version\n\n### Minor\n* [ ] introduce more data sources\n* [x] provide a class that forwards a request to multiple different scraper objects\nand collects the result, returning the first returned result or None\n\n### Major\n* look into performance improvements\n* as this will be 1.x.x should be well documented and very usable\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/LukasBudach/FinanceScraper", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "FinanceScraper", "package_url": "https://pypi.org/project/FinanceScraper/", "platform": "", "project_url": "https://pypi.org/project/FinanceScraper/", "project_urls": { "Homepage": "https://github.com/LukasBudach/FinanceScraper" }, "release_url": "https://pypi.org/project/FinanceScraper/0.2.1/", "requires_dist": [ "requests" ], "requires_python": "", "summary": "An up-to-date web scraper providing financial data from various sources", "version": "0.2.1" }, "last_serial": 4886907, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "e42817d53b2958e800ed0623393a8859", "sha256": "a532ea993f7a0a7b1f7fe201cfe8b2cdbdd52b6f071b025755a1be79fccf0278" }, "downloads": -1, "filename": "FinanceScraper-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "e42817d53b2958e800ed0623393a8859", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 3129, "upload_time": "2019-01-25T16:18:00", "url": "https://files.pythonhosted.org/packages/a9/c1/719a23b43d1ce1b3119bd2491e4730bdc278d77ff413c70f8ef17c916138/FinanceScraper-0.1.0-py3-none-any.whl" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "035bf8a30c505e60d497a007e3e679cc", "sha256": "787eebde60fb94472919c966a73c4b4813b278e8230bfaf26ed65181f89fa65d" }, "downloads": -1, "filename": "FinanceScraper-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "035bf8a30c505e60d497a007e3e679cc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4537, "upload_time": "2019-01-27T17:20:00", "url": "https://files.pythonhosted.org/packages/80/56/30fccd59c0b6ca1c58c58c8c9a7553a8e5e3948fa4efccdf3ce6690cf615/FinanceScraper-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2c4d9b32f1ef01cb9efb3255afd4a8d3", "sha256": "f053b632b24f406b6d63b64bad753678f2e21158ed958e7d2ceb376f523fef7f" }, "downloads": -1, "filename": "FinanceScraper-0.1.1.tar.gz", "has_sig": false, "md5_digest": "2c4d9b32f1ef01cb9efb3255afd4a8d3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11937, "upload_time": "2019-01-27T17:20:02", "url": "https://files.pythonhosted.org/packages/3f/b5/97befdc83125de803c923eb0c33faa98a5a4828169d231ceb9e473430236/FinanceScraper-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "a1bf00ae3b01cef5d800d8ba0f76bc1b", "sha256": "4bd500cd9cc7ab1a1af6ba2f3b9559b1df1d650ee62db5eb15800e5455862353" }, "downloads": -1, "filename": "FinanceScraper-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "a1bf00ae3b01cef5d800d8ba0f76bc1b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8176, "upload_time": "2019-01-27T17:36:33", "url": "https://files.pythonhosted.org/packages/39/e3/ab5631f692b30cfbc3dbe8dd8b8023738525700b28f3f9c84a94bdcb1133/FinanceScraper-0.1.2-py3-none-any.whl" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "c109a44f66aada4a71a8cc268a193424", "sha256": "1dd6a7724642e04cb5f66180c0809128ea228b69adaa0c5f6bb1bacc4b0faf42" }, "downloads": -1, "filename": "FinanceScraper-0.1.3-py3-none-any.whl", "has_sig": false, "md5_digest": "c109a44f66aada4a71a8cc268a193424", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8160, "upload_time": "2019-01-27T17:51:54", "url": "https://files.pythonhosted.org/packages/af/58/b8ade490dda856452c471937b4fe71b89d92c1d2d8fed37b78d1d6d9d9cd/FinanceScraper-0.1.3-py3-none-any.whl" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "84f213de4c55c59bc2211a4e6d31fb81", "sha256": "105eaf5d5a92ab9cd8b36fe1bf467b1097c6fe62d1491c2fb485a03ec9b935da" }, "downloads": -1, "filename": "FinanceScraper-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "84f213de4c55c59bc2211a4e6d31fb81", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 11951, "upload_time": "2019-01-31T17:31:31", "url": "https://files.pythonhosted.org/packages/82/b3/067fe872cc69fcc88189bd167deea6aeec37152ff2f6ee7faf410e1e54a2/FinanceScraper-0.2.0-py3-none-any.whl" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "9ea68fa90df6d1188c1a02e44d4f58c0", "sha256": "2b76d13d1f7aa14c9faac61c746b2cbb547f42965308a60ddd2987040f7151e2" }, "downloads": -1, "filename": "FinanceScraper-0.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "9ea68fa90df6d1188c1a02e44d4f58c0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 13636, "upload_time": "2019-03-01T22:28:52", "url": "https://files.pythonhosted.org/packages/11/12/6bdf9131a2c8f1cb564c025575f5735899afc62fe11a1595c1603c9c2d1e/FinanceScraper-0.2.1-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9ea68fa90df6d1188c1a02e44d4f58c0", "sha256": "2b76d13d1f7aa14c9faac61c746b2cbb547f42965308a60ddd2987040f7151e2" }, "downloads": -1, "filename": "FinanceScraper-0.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "9ea68fa90df6d1188c1a02e44d4f58c0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 13636, "upload_time": "2019-03-01T22:28:52", "url": "https://files.pythonhosted.org/packages/11/12/6bdf9131a2c8f1cb564c025575f5735899afc62fe11a1595c1603c9c2d1e/FinanceScraper-0.2.1-py3-none-any.whl" } ] }