{"id":15035104,"url":"https://github.com/binance/binance-public-data","last_synced_at":"2025-05-14T05:10:42.998Z","repository":{"id":37242856,"uuid":"289832303","full_name":"binance/binance-public-data","owner":"binance","description":"Details on how to get Binance public data","archived":false,"fork":false,"pushed_at":"2025-01-09T09:41:26.000Z","size":6649,"stargazers_count":1794,"open_issues_count":65,"forks_count":513,"subscribers_count":39,"default_branch":"master","last_synced_at":"2025-04-11T20:43:41.707Z","etag":null,"topics":["binance","futures","historical-data","market-data","options","public","spot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/binance.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2020-08-24T05:01:15.000Z","updated_at":"2025-04-11T16:48:24.000Z","dependencies_parsed_at":"2024-05-14T11:42:22.331Z","dependency_job_id":"82b00f24-b82f-46bd-be41-9d9085781970","html_url":"https://github.com/binance/binance-public-data","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binance%2Fbinance-public-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binance%2Fbinance-public-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binance%2Fbinance-public-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binance%2Fbinance-public-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/binance","download_url":"https://codeload.github.com/binance/binance-public-data/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254076850,"owners_count":22010611,"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","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","futures","historical-data","market-data","options","public","spot"],"created_at":"2024-09-24T20:27:32.042Z","updated_at":"2025-05-14T05:10:42.974Z","avatar_url":"https://github.com/binance.png","language":"Python","funding_links":[],"categories":["Curated List","Python"],"sub_categories":["Data Libraries"],"readme":"# Binance Public Data\n\nThe website [Binance Data Collection](https://data.binance.vision/) offers easy access for anyone to download Binance's public market data, which is aggregated into `daily` or `monthly` files.\n\nAll symbols are supported, with new `daily` data becoming available the next day and new `monthly` data at the first monday of the month.\n\n## Data Information\n\n### SPOT\n\n**Note**: The timestamp for SPOT Data from January 1st 2025 onwards will be in microseconds.\n\n#### AggTrades\nThe `aggTrades` files' data is obtained from `/api/v3/aggTrades` API endpoint:\n\n|Aggregate tradeId|Price|Quantity|First tradeId|Last tradeId|Timestamp|Was the buyer the maker|Was the trade the best price match|\n| -- | -- | -- | -- | -- | -- | -- | -- |\n|0|0.20000000|50.00000000|0|0|1735689600010866|False|True|\n\n#### Klines\nThe `klines` files' data is obtained from `/api/v3/klines` API endpoint:\n\n|Open time|Open|High|Low|Close|Volume|Close time|Quote asset volume|Number of trades|Taker buy base asset volume|Taker buy quote asset volume|Ignore|\n| -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- |\n|1735689600000000|4.15070000|4.15870000|4.15060000|4.15540000|539.23000000|1735693199999999|2240.39860900|13|401.82000000|1669.98121300|0|\n\nAll kline intervals are supported: \n- `1s`, `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `6h`, `8h`, `12h`, `1d`, `3d`, `1w`, `1mo`.\n- `1mo` is used instead of `1M` to supprt non-case sensitive file systems.\n\n#### Trades\nThe `trades` files' data is obtained from `/api/v3/historicalTrades` API endpoint:\n\n|trade Id| price| qty|quoteQty|time|isBuyerMaker|isBestMatch|\n| -- | -- | -- | -- | -- | -- | -- |\n|51175358|17.80180000|5.69000000|101.29224200|1735689600010866|True|True|\n\n\n### FUTURES\n* USD-M Futures\n* COIN-M Futures\n\n#### AggTrades\nThe `aggTrades` files' data is the same as that from `/fapi/v1/aggTrades` or `/dapi/v1/aggTrades` API endpoints:\n\n|Aggregate tradeId|Price|Quantity|First tradeId|Last tradeId|Timestamp|Was the buyer the maker|\n| -- | -- | -- | -- | -- | -- | -- |\n|26129|0.01633102|4.70443515|27781|27781|1498793709153|true|\n\n#### Klines\nUSD-M Futures `klines` files' data is from `/fapi/v1/klines` API endpoint:\n\n|Open time|Open|High|Low|Close|Volume|Close time|Quote asset volume|Number of trades|Taker buy base asset volume|Taker buy quote asset volume|Ignore|\n| -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- |\n|1499040000000|0.01634790|0.80000000|0.01575800|0.01577100|148976.11427815|1499644799999|2434.19055334|308|1756.87402397|28.46694368|17928899.62484339|\n\nCOIN-M Futures `klines` files' data is from `/dapi/v1/klines` API endpoint:\n\n|Open time|Open|High|Low|Close|Volume|Close time|Base asset volume|Number of trades|Taker buy volume|Taker buy base asset volume|Ignore|\n| -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- |\n|1591258320000|9640.7|9642.4|9640.6|9642.0|206|1591258379999|2.13660389|48|119|1.23424865|0|\n\n#### Trades\nUSD-M Futures `trades` files' data is from `/fapi/v1/trades` API endpoint and save into a file with these columns:\n\n|trade Id| price| qty|quoteQty|time|isBuyerMaker|\n| -- | -- | -- | -- | -- | -- |\n|28457|4.00000100|12.00000000|48.00|1499865549590|true|\n\nCOIN-M Futures `trades` files' data is from `/dapi/v1/trades` API endpoint and save into a file with these columns:\n\n|trade Id| price| qty|baseQty|time|isBuyerMaker|\n| -- | -- | -- | -- | -- | -- |\n|28457|9635.0|1|0.01037883|1591250192508|true|\n\n\n## How to download programatically\n\n```shell\n# Examples for downloading monthly Spot 1h lines for \"ADABKRW\" symbol.\ncurl -s \"https://data.binance.vision/data/spot/monthly/klines/ADABKRW/1h/ADABKRW-1h-2020-08.zip\" -o ADABKRW-1h-2020-08.zip\nwget \"https://data.binance.vision/data/spot/monthly/klines/ADABKRW/1h/ADABKRW-1h-2020-08.zip\"\n```\n\nMore examples are available in the form of helper scripts in both the `python` and `shell` folders of this repository for downloading from the website.\nIn case you want to obtain all current running symbols from Spot and Futures, you can take use of  `shell/fetch-all-trading-pairs.sh` script.\n\n## CHECKSUM\nEach zip file has a `.CHECKSUM` file together in the same folder to verify data integrity. The verification can be done through:\n\n```shell\n# Linux\nsha256sum -c BNBUSDT-1m-2021-01.zip.CHECKSUM\n\n# MacOS\nshasum -a 256 -c BNBUSDT-1m-2021-01.zip.CHECKSUM\n```\n\n### Updates\n\nArchived files may be updated at a later date as a result of recently discovered issues. Below is an exhaustive list of updates performed to the archive, containing the file path for reference, and CHECKSUMs of the replaced file and the replacement file:\n\n| Date | Changelog File | Note |\n| --|--|--|\n| 2022-08-08 | [updates/2022-08-08_kline_updates.zip](updates/2022-08-08_kline_updates.zip) | Fixed inconsistent data|\n| 2022-04-21 | [updates/2022-04-21_aggregate_trade_updates.zip](updates/2022-04-21_aggregate_trade_updates.zip) | Align to the [Spot aggregate trade data change](https://github.com/binance/binance-spot-api-docs/blob/master/CHANGELOG.md#2022-04-12) |\n\n\n## Issue/Question\n\nPlease open an issue [here](https://github.com/binance/binance-public-data/issues). \n\n## Licence\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinance%2Fbinance-public-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbinance%2Fbinance-public-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinance%2Fbinance-public-data/lists"}