To help users download our public data easily, we've put all Kline, Trade, and AggTrade data for all pairs, month by month, online.
We provide both daily and monthly intervals for each data. daily data will be uploaded in the next day, and we start to upload monthly data from the beginning of next month.
AggTradesKlinesTrades
The aggTrades is downloaded from /api/v3/aggTrades and the title for each column:
| Aggregate tradeId | Price | Quantity | First tradeId | Last tradeId | Timestamp | Was the buyer the maker | Was the trade the best price match |
|---|---|---|---|---|---|---|---|
| 0 | 0.20000000 | 50.00000000 | 0 | 0 | 1608872400000 | False | True |
The klines data is downloaded from /api/v3/klines and the title for each column in the kline data:
| 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1601510340000 | 4.15070000 | 4.15870000 | 4.15060000 | 4.15540000 | 539.23000000 | 1601510399999 | 2240.39860900 | 13 | 401.82000000 | 1669.98121300 | 0 |
The trades data is downloaded from /api/v3/historicalTrades, the title for each column in the trades data:
| trade Id | price | qty | quoteQty | time | isBuyerMaker | isBestMatch |
|---|---|---|---|---|---|---|
| 51175358 | 17.80180000 | 5.69000000 | 101.29224200 | 1583709433583 | True | True |
- USD-M Futures
- COIN-M Futures
The aggTrades is same as /fapi/v1/aggTrades, /dapi/v1/aggTrades and the title for each column:
| Aggregate tradeId | Price | Quantity | First tradeId | Last tradeId | Timestamp | Was the buyer the maker |
|---|---|---|---|---|---|---|
| 26129 | 0.01633102 | 4.70443515 | 27781 | 27781 | 1498793709153 | true |
The klines data is same as /fapi/v1/klines, /dapi/v1/klines and the title for each column:
USD-M Futures
| 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1499040000000 | 0.01634790 | 0.80000000 | 0.01575800 | 0.01577100 | 148976.11427815 | 1499644799999 | 2434.19055334 | 308 | 1756.87402397 | 28.46694368 | 17928899.62484339 |
COIN-M Futures
| Open time | Open | High | Low | Close | Volume | Close time | Base asset volume | Number of trades | Taker buy volume | Taker buy base asset volume | Ignore |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1591258320000 | 9640.7 | 9642.4 | 9640.6 | 9642.0 | 206 | 1591258379999 | 2.13660389 | 48 | 119 | 1.23424865 | 0 |
The trades data is same as /fapi/v1/trades, /dapi/v1/trades, the title for each column:
USD-M Futures
| trade Id | price | qty | quoteQty | time | isBuyerMaker |
|---|---|---|---|---|---|
| 28457 | 4.00000100 | 12.00000000 | 48.00 | 1499865549590 | true |
COIN-M Futures
| trade Id | price | qty | baseQty | time | isBuyerMaker |
|---|---|---|---|---|---|
| 28457 | 9635.0 | 1 | 0.01037883 | 1591250192508 | true |
The base url is https://data.binance.vision and you can use your browser to view and download the data.
All symbols are supported, the file format is:
<base_url>/data/spot/monthly/klines/<symbol_in_uppercase>/<interval>/<symbol_in_uppercase>-<interval>-<year>-<month>.zip
e.g. the url for BNBUSDT 1m klines for 2019-01 is:
https://data.binance.vision/data/spot/monthly/klines/BNBUSDT/1m/BNBUSDT-1m-2019-01.zip
All intervals are supported:
1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo
1mois used instead of1Mto supprt non-case sensitive file systems.
All symbols are supported, the file format is:
<base_url>/data/spot/monthly/trades/<symbol_in_uppercase>/<symbol_in_uppercase>-trades-<year>-<month>.zip
e.g. the url BNBUSDT trades in 2019-01 is:
https://data.binance.vision/data/spot/monthly/trades/BNBUSDT/BNBUSDT-trades-2019-01.zip
This section will be updated when the data is uploaded.
# download a single file
curl -s "https://data.binance.vision/data/spot/monthly/klines/ADABKRW/1h/ADABKRW-1h-2020-08.zip" -o ADABKRW-1h-2020-08.zip
wget "https://data.binance.vision/data/spot/monthly/klines/ADABKRW/1h/ADABKRW-1h-2020-08.zip"We will expand this section with more methods in the future.
There are additional helper scripts both in python and shell in their respective folders of this repository.
Each zip file has a .CHECKSUM file together in the same folder to verify data integrity.
To Check:
# From Linux, sha256sum -c <zip_file_name.CHECKSUM>
sha256sum -c BNBUSDT-1m-2021-01.zip.CHECKSUM
# From MacOS
shasum -a 256 -c BNBUSDT-1m-2021-01.zip.CHECKSUMArchived 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:
| Date | Changelog File | Note |
|---|---|---|
| 2022-08-08 | updates/2022-08-08_kline_updates.zip | Fixed inconsistent data |
| 2022-04-21 | updates/2022-04-21_aggregate_trade_updates.zip | Align to the Spot aggregate trade data change |
| 2022-10-04 | updates/2022-10-04_aggregate_trade_updates.csv |
Please open an issue here.
MIT