binance-public-data
binance-public-data copied to clipboard
binance
Details on how to get Binance public data
Binance Public Data
To help users download our public data easily, we've put all Kline, Trade, and AggTrade data for all pairs, month by month, online.
What data is available
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.
SPOT
AggTradesKlinesTrades
AggTrades
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 |
Klines
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 |
Trades
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 |
FUTURES
- USD-M Futures
- COIN-M Futures
AggTrades
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 |
Klines
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 |
Trades
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 |
Where do I access it
The base url is https://data.binance.vision and you can use your browser to view and download the data.
Klines
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
Intervals
All intervals are supported:
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.
Trades
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
AggTrades
This section will be updated when the data is uploaded.
How to download programatically
# 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.
CHECKSUM
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.CHECKSUM
Updates
Archived 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 |
I have an issue/question
Please open an issue here.
Licence
MIT
binance