FAQ
Home
Support Center
FAQ
Crypto Derivatives
Futures Contracts
Introduction to Binance Futures
How to Download Historical Market Data on Binance

How to Download Historical Market Data on Binance

2022-03-23 05:49
Binance provides historical market data that can be downloaded via the Binance website or API.

What data is available?

Binance supports different data types for different products.
Spot
Data Type
Start Date
Granularity
Generate Frequency
Candlestick
  • Daily generated files: 2021-02-28
  • Monthly generated files: 2017-08-15
1s/1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M
Daily and monthly
Trades
  • Daily generated files: 2021-02-28
  • Monthly generated files: 2017-08-15
-
Daily and monthly
Aggregated Trades
  • Daily generated files: 2021-02-28
  • Monthly generated files: 2017-08-15
-
Daily and monthly
Futures
Data Type
Start Date
Granularity
Generate Frequency
Candlestick
  • USDⓈ-M: 2020-01-01
  • COIN-M: 2020-08-01
1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M
Daily and monthly
Trades
  • USDⓈ-M: 2020-01-01
  • COIN-M: 2020-08-01
-
Daily and monthly
Aggregated Trades
  • USDⓈ-M: 2020-01-01
  • COIN-M: 2020-08-01
-
Daily and monthly
Book Ticker
2023-06-25
-
Daily and monthly
Trading Metrics
5m
Daily
Index Price K-Line
2020-01-01
1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M
Daily and monthly
Mark Price Candlestick
2020-01-01
1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M
Daily and monthly
Funding Rate
2020-01
-
Monthly
Premium Index Candlestick
2020-01-01
1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M
Daily and monthly
Liquidation Snapshot
2023-06-25
-
Daily
Tick-Level Orderbook
Please refer to Binance Futures Order Book Historical Data
-
Daily
Orderbook Snapshot
1m
Daily
Options
Data Type
Start Date
Granularity
Generate Frequency
Option EOH Summary
2023-05-18
1h
Daily
BVOL Index
2023-06-20
1s
Daily

How frequently is the data updated?

Daily-generated data will be updated on the next day at around 10:00 (UTC). Monthly-generated data will be updated on the first day of the following month.

How to download the data from the Binance website?

Binance offers historical market data for all users to download directly via the Historical Market Data page. You can view all candlestick charts, trading, and aggregated trading data for Spot and Futures pairs.
1. Log in to your Binance account and go to [Institutional] - [Historical Market Data].
2. You can use the filters on the side to view each category.
3. Select the data you want to download.
4. You may view the Field Information of the data before downloading. Please note that the Field Information section is collapsible.
5. Fill in the download details and click [Confirm] to proceed.
  • You may select multiple symbols.
  • Interval includes Daily and Monthly.
  • You may select multiple granularity levels.
6. After reviewing the files, click [Download].
Please note that downloading multiple files at once could result in a longer download time.

How to download the data programmatically?

You can use your browser to view the raw data from this page. This repository hosts a collection of auxiliary scripts, available in both Python and Shell, located in their respective directories. Binance will support more downloading methods in the future, please stay tuned.
Example request:
# 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"
Please note:
  • Each compressed zip file is accompanied by a corresponding CHECKSUM file stored in the same folder, which can be used to verify data integrity.
  • You can check via the followings:
    • Linux:
      • sha256sum -c <zip_file_name.CHECKSUM>
      • sha256sum -c BNBUSDT-1m-2021-01.zip.CHECKSUM
    • MacOS:
      • shasum -a 256 -c BNBUSDT-1m-2021-01.zip.CHECKSUM
Please refer to this page for more details.

Futures order book data

Currently, Binance only provides Futures historical order book data. You need to have a Futures account to download it, and this data can only be accessed via API for Binance VIP 1 or above users.
Binance provides the following Futures historical order book data:
  • Orderbook Snapshot (S_Depth)
Since January 2020, only the BTC/USDT symbol.
  • Tick-Level Orderbook (T_Depth)
Since July 2020, all symbols and pairs.
Please refer to Binance Futures Order Book Historical Data for more details.

Why can’t I download multiple files at the same time from the website?

If you select “download multiple files”, but your browser only allows you to download them one at a time, here are some possible reasons and their solutions:
1. Check your browser’s settings
You need to enable multiple downloads in your browser. For example, choose to allow automatic downloads of multiple files on the download confirmation pop-up.
You can check the download settings of your browser:
  • If you’ve blocked downloading of multiple files, please adjust the browser settings. For example, on Chrome you can visit “chrome://settings/content/automaticDownloads”. Turn off the option “Ask where to save each file before downloading” from “chrome://settings/downloads”
Try using a different browser to see if the issue persists.
2. Check your internet connectivity
Your internet connection may be slow or unstable. Try verifying your internet connection's stability and speed. If possible, use a wired connection or switch to a more reliable network.
3. Interference from browser extensions/add-ons
Certain browser extensions or add-ons may interfere with the download process. You can temporarily disable browser extensions and try downloading the files again. If this solved the issue, try to re-enable the extensions one by one to identify the culprit.
4. Technical issues from the website
The website you are downloading from may be experiencing technical difficulties or server overload. You can check if other users report similar issues or if the website has put up notice regarding this issue. You could also try downloading the files at a different time.
If you have tried the above solutions and are still unable to download multiple files simultaneously, please reach out to the website's support team for assistance. Providing them with specific details about your issue will help them identify and resolve the problem more effectively.

Data disclaimer

Please note that all our data services strictly follow the Binance Terms of Use.
Without written consent from Binance, the following commercial uses of Binance data are prohibited:
  1. Trading services that make use of Binance quotes or market bulletin board information.
  2. Data feeding or streaming services that make use of any market data of Binance.
  3. Any other websites/apps/services that charge for or otherwise profit from (including through advertising or referral fees) market data obtained from Binance.
You hereby understand and agree that Binance will not be liable for any losses or damages arising out of or relating to: (a) any inaccuracy, defect, or omission of digital assets price data, (b) any error or delay in the transmission of such data, (c) interruption in any such data, (d) regular or unscheduled maintenance carried out by Binance and service interruption and change resulting from such maintenance, (e) any damages incurred by other users’ actions, omissions or violation of these terms, (f) any damage caused by illegal actions of other third parties or actions without authorized by Binance; and (g) other exemptions mentioned in disclaimers and platform rules issued by Binance.