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

Date

Granularity

Generate Frequency

Candlestick

  • Daily generated files: From 2021-02-28
  • Monthly generated files: From 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: From 2021-02-28
  • Monthly generated files: From 2017-08-15

-

Daily and monthly

Aggregated Trades

  • Daily generated files: From 2021-02-28
  • Monthly generated files: From 2017-08-15

-

Daily and monthly

Futures

Data Type

Date

Granularity

Generate Frequency

Candlestick

  • USDⓈ-M: From 2020-01-01
  • COIN-M: From 2020-08-01

1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M

Daily and monthly

Trades

  • USDⓈ-M: From 2020-01-01
  • COIN-M: From 2020-08-01

-

Daily and monthly

Aggregated Trades

  • USDⓈ-M: From 2020-01-01
  • COIN-M: From 2020-08-01

-

Daily and monthly

Book Ticker

2023-06-25 to 2024-03-31

-

Daily and monthly

Trading Metrics

-

5m

Daily

Index Price K-Line

From 2020-01-01

1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M

Daily and monthly

Mark Price Candlestick

From 2020-01-01

1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M

Daily and monthly

Funding Rate

From 2020-01

-

Monthly

Premium Index Candlestick

From 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 to 2024-03-31

-

Daily

Tick-Level Orderbook

Please refer to Binance Futures Order Book Historical Data

-

Daily

Orderbook Snapshot

Please refer to Binance Futures Order Book Historical Data

1m

Daily

Options

Data TypeDateGranularity Generate Frequency
Option EOH Summary2023-05-18 to 2023-10-231hDaily
BVOL IndexFrom 2023-06-201sDaily

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 scroll down to the footer. Click [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.

5. Fill in the download details and click [Confirm] to proceed.

  • You may select a maximum of 5 symbols.
  • Interval includes daily and monthly.
  • You may select 1 granularity level only.
  • Data range can be customized. Please note that the data is updated every day at 00:00 (UTC+0).

6. After reviewing the files, click [Download].

Please note that in some cases, the data will be incomplete due to a number of factors including, data being updated, or no data being available for specified tokens for the selected period.

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></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.