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

SPOT

• AggTrades
• Klines
• Trades

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

• 1mo is used instead of 1M to 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

I have an issue/question

Please open an issue here.

Licence

MIT