{"id":38440620,"url":"https://github.com/aoki-h-jp/binance-bulk-downloader","last_synced_at":"2026-01-17T04:34:43.449Z","repository":{"id":189756564,"uuid":"675864145","full_name":"aoki-h-jp/binance-bulk-downloader","owner":"aoki-h-jp","description":"A Python library to efficiently and concurrently download historical data files from Binance. Supports all asset types (spot, USDT-M, COIN-M, options)  and all data frequencies.","archived":false,"fork":false,"pushed_at":"2025-01-13T11:11:12.000Z","size":111,"stargazers_count":40,"open_issues_count":0,"forks_count":11,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-13T12:25:34.438Z","etag":null,"topics":["binance","bulk-download","cryptocurrency","downloader","fundingrate","historical-data","klines","liquidation","openinterest","orderbook-tick-data"],"latest_commit_sha":null,"homepage":"","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/aoki-h-jp.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}},"created_at":"2023-08-07T23:07:42.000Z","updated_at":"2025-01-13T06:38:04.000Z","dependencies_parsed_at":"2025-01-13T12:23:19.943Z","dependency_job_id":"9b8dfd3e-b990-4291-9874-18a8312f89c8","html_url":"https://github.com/aoki-h-jp/binance-bulk-downloader","commit_stats":{"total_commits":56,"total_committers":1,"mean_commits":56.0,"dds":0.0,"last_synced_commit":"e8783cc724fe6085b8fff10a5453efe870949089"},"previous_names":["aoki-h-jp/binance-bulk-downloader"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/aoki-h-jp/binance-bulk-downloader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aoki-h-jp%2Fbinance-bulk-downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aoki-h-jp%2Fbinance-bulk-downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aoki-h-jp%2Fbinance-bulk-downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aoki-h-jp%2Fbinance-bulk-downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aoki-h-jp","download_url":"https://codeload.github.com/aoki-h-jp/binance-bulk-downloader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aoki-h-jp%2Fbinance-bulk-downloader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28495200,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T04:31:57.058Z","status":"ssl_error","status_checked_at":"2026-01-17T04:31:45.816Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["binance","bulk-download","cryptocurrency","downloader","fundingrate","historical-data","klines","liquidation","openinterest","orderbook-tick-data"],"created_at":"2026-01-17T04:34:43.376Z","updated_at":"2026-01-17T04:34:43.439Z","avatar_url":"https://github.com/aoki-h-jp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# binance-bulk-downloader\n\n[![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)](https://www.python.org/downloads/release/python-3110//)\n[![pytest](https://github.com/aoki-h-jp/binance-bulk-downloader/actions/workflows/pytest.yaml/badge.svg)](https://github.com/aoki-h-jp/binance-bulk-downloader/actions/workflows/pytest.yaml)\n[![Github All Releases](https://img.shields.io/github/downloads/aoki-h-jp/binance-liquidation-feeder/total.svg)]()\n\n## Python library for bulk downloading Binance historical data\n\nA Python library to efficiently and concurrently download historical data files from Binance. Supports all asset types (spot, USDT-M, COIN-M, options) and all data frequencies.\n\n## Installation\n\n```bash\npip install binance-bulk-downloader\n```\n\n## Usage\n\n### Download all klines 1m data (USDT-M futures)\n\n```python\nfrom binance_bulk_downloader.downloader import BinanceBulkDownloader\n\ndownloader = BinanceBulkDownloader()\ndownloader.run_download()\n```\n\n### Download all klines 1h data (Spot)\n\n```python\nfrom binance_bulk_downloader.downloader import BinanceBulkDownloader\n\ndownloader = BinanceBulkDownloader(data_frequency='1h', asset='spot')\ndownloader.run_download()\n```\n\n### Download specific symbols only\n\n```python\nfrom binance_bulk_downloader.downloader import BinanceBulkDownloader\n\n# Download single symbol\ndownloader = BinanceBulkDownloader(\n    data_type=\"klines\",\n    data_frequency=\"1h\",\n    asset=\"spot\",\n    timeperiod_per_file=\"daily\",\n    symbols=\"BTCUSDT\",\n)\ndownloader.run_download()\n\n# Download multiple symbols\ndownloader = BinanceBulkDownloader(\n    data_type=\"trades\",\n    asset=\"spot\",\n    timeperiod_per_file=\"daily\",\n    symbols=[\"BTCUSDT\", \"ETHUSDT\"],\n)\ndownloader.run_download()\n```\n\n### Download all aggTrades data (USDT-M futures)\n\n```python\nfrom binance_bulk_downloader.downloader import BinanceBulkDownloader\n\ndownloader = BinanceBulkDownloader(data_type='aggTrades')\ndownloader.run_download()\n```\n\n### Other examples\n\nPlease see /example directory.\n\n```bash\npython -m example.download_klines\n```\n\n## pytest\n\n```bash\npython -m pytest\n```\n\n## Available data types\n\n✅: Implemented and tested. ❌: Not available on Binance.\n\n### by data_type\n\n| data_type           | spot | um   | cm   | options |\n| :------------------ | :--: | :--: | :--: | :-----: |\n| aggTrades           | ✅   | ✅   | ✅ | ❌      |\n| bookDepth           | ❌   | ✅   | ✅ | ❌      |\n| bookTicker          | ❌   | ✅   | ✅ | ❌      |\n| fundingRate         | ❌   | ✅   | ✅ | ❌      |\n| indexPriceKlines    | ❌   | ✅   | ✅ | ❌      |\n| klines              | ✅   | ✅   | ✅ | ❌      |\n| liquidationSnapshot | ❌   | ✅   | ✅ | ❌      |\n| markPriceKlines     | ❌   | ✅   | ✅ | ❌      |\n| metrics             | ❌   | ✅   | ✅ | ❌      |\n| premiumIndexKlines  | ❌   | ✅   | ✅ | ❌      |\n| trades              | ✅   | ✅   | ✅ | ❌      |\n| BVOLIndex           | ❌   | ❌   | ❌ | ✅      |\n| EOHSummary          | ❌   | ❌   | ❌ | ✅      |\n\n### by data_frequency (klines, indexPriceKlines, markPriceKlines, premiumIndexKlines)\n\n| data_frequency | spot | um   | cm   | options |\n| :------------- | :--: | :--: | :--: | :-----: |\n| 1s             | ✅   | ❌   | ❌ | ❌      |\n| 1m             | ✅   | ✅   | ✅ | ❌      |\n| 3m             | ✅   | ✅   | ✅ | ❌      |\n| 5m             | ✅   | ✅   | ✅ | ❌      |\n| 15m            | ✅   | ✅   | ✅ | ❌      |\n| 30m            | ✅   | ✅   | ✅ | ❌      |\n| 1h             | ✅   | ✅   | ✅ | ❌      |\n| 2h             | ✅   | ✅   | ✅ | ❌      |\n| 4h             | ✅   | ✅   | ✅ | ❌      |\n| 6h             | ✅   | ✅   | ✅ | ❌      |\n| 8h             | ✅   | ✅   | ✅ | ❌      |\n| 12h            | ✅   | ✅   | ✅ | ❌      |\n| 1d             | ✅   | ✅   | ✅ | ❌      |\n| 3d             | ✅   | ✅   | ✅ | ❌      |\n| 1w             | ✅   | ✅   | ✅ | ❌      |\n| 1mo            | ✅   | ✅   | ✅ | ❌      |\n\n## If you want to report a bug or request a feature\n\nPlease create an issue on this repository!\n\n## Disclaimer\n\nThis project is for educational purposes only. You should not construe any such information or other material as legal,\ntax, investment, financial, or other advice. Nothing contained here constitutes a solicitation, recommendation,\nendorsement, or offer by me or any third party service provider to buy or sell any securities or other financial\ninstruments in this or in any other jurisdiction in which such solicitation or offer would be unlawful under the\nsecurities laws of such jurisdiction.\n\nUnder no circumstances will I be held responsible or liable in any way for any claims, damages, losses, expenses, costs,\nor liabilities whatsoever, including, without limitation, any direct or indirect damages for loss of profits.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faoki-h-jp%2Fbinance-bulk-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faoki-h-jp%2Fbinance-bulk-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faoki-h-jp%2Fbinance-bulk-downloader/lists"}