{"id":42610357,"url":"https://github.com/maxisoft/yahoo-finance-data-downloader","last_synced_at":"2026-01-29T02:33:07.838Z","repository":{"id":149328972,"uuid":"564870819","full_name":"maxisoft/yahoo-finance-data-downloader","owner":"maxisoft","description":"Automate downloading historical and recent stock data from Yahoo Finance.","archived":false,"fork":false,"pushed_at":"2025-06-22T07:14:38.000Z","size":162,"stargazers_count":0,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-22T08:20:53.201Z","etag":null,"topics":["data","stock-market","yahoo-finance"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maxisoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-11-11T17:42:37.000Z","updated_at":"2025-06-22T07:14:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"d82e6be8-8cef-49e5-81a7-8e28751ab984","html_url":"https://github.com/maxisoft/yahoo-finance-data-downloader","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/maxisoft/yahoo-finance-data-downloader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisoft%2Fyahoo-finance-data-downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisoft%2Fyahoo-finance-data-downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisoft%2Fyahoo-finance-data-downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisoft%2Fyahoo-finance-data-downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxisoft","download_url":"https://codeload.github.com/maxisoft/yahoo-finance-data-downloader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisoft%2Fyahoo-finance-data-downloader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28861107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T22:56:21.783Z","status":"online","status_checked_at":"2026-01-29T02:00:06.714Z","response_time":59,"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":["data","stock-market","yahoo-finance"],"created_at":"2026-01-29T02:33:06.193Z","updated_at":"2026-01-29T02:33:07.831Z","avatar_url":"https://github.com/maxisoft.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Stock Data Downloader\n\nThis script automates the process, efficiently downloading historical and recent OHLCV (Open, High, Low, Close, Volume)\ndata for your desired stock symbols from Yahoo Finance.\n\nEffortlessly build comprehensive datasets for analysis and upload them to platforms like Kaggle!\n\n**Key Features:**\n\n- **Efficient Downloading:** Downloads minute-level data using `yfinance`. ⚡\n- **Historical \u0026 Recent Data:** Combines historical and recent data for a complete picture.\n- **Multithreading:** Leverages multithreading for faster downloads on multi-core systems. ️\n- **Error Handling:** Logs exceptions for troubleshooting.\n- **Customizable:** Set the desired stock symbols in a separate `symbols.txt` file.\n\n**Getting Started:**\n\n1. **Prerequisites:**\n    - Python 3.x\n    - Required libraries: `pandas`, `yfinance`, `pathvalidate`, `numba` (for optimization, optional)\n    - Install dependencies with `pip install -r requirements.txt`\n\n2. **Create a `symbols.txt` file:**\n    - List each stock symbol you want to download data for, one per line. (e.g., AAPL, TSLA, GOOG)\n\n3. **Schedule Automatic Download:** (optional)\n\n   This script is designed to be run automatically on a schedule using GitHub Actions. To configure this:\n\n    - Go to your GitHub repository settings -\u003e Actions.\n    - Create secrets in your repository settings to store sensitive information like your Kaggle credentials (\n      KAGGLE_USERNAME and KAGGLE_KEY).\n    - Enable the workflow `python-app.yml` to run in your fork's GitHub actions page\n\n**Technical Details (for the curious):**\n\n- The script utilizes [`yfinance`](https://github.com/ranaroussi/yfinance) for data retrieval.\n- `pandas` is used for efficient data manipulation and storage as CSV files.\n- `pathvalidate` ensures valid filenames for downloaded data.\n- The `numba` library (optional) can be used for performance optimization (requires installation).\n\n**Contributing \u0026 Further Development:**\n\n- We welcome contributions and suggestions! Feel free to open pull requests.\n\n**Let's automate your stock data collection!**\n\n## Setting Up GitHub Secrets for Kaggle Upload:\n\n**Here's a table outlining the secrets required for uploading your downloaded data to Kaggle:**\n\n| Secret Name     | Description                                        |\n|-----------------|----------------------------------------------------|\n| KAGGLE_USERNAME | Your Kaggle username                               |\n| KAGGLE_KEY      | Your Kaggle API key (create one from your profile) |\n| KAGGLE_DATASET  | The remote dataset name                            |\n\n\n**Note:** These secrets should not be directly added to your code. Instead, create them securely within your GitHub\nrepository settings -\u003e Secrets.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxisoft%2Fyahoo-finance-data-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxisoft%2Fyahoo-finance-data-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxisoft%2Fyahoo-finance-data-downloader/lists"}