Binance provides historical market data that can be downloaded via the Binance website or API.
What data is available?
Binance provides candlestick charts, trading, and aggregated trading data for all Spot and Futures pairs (including USDⓈ-M and COIN-M Futures).
Currently, Binance supports all Spot trading pairs’ candlestick chart, trading, and aggregated trading data:
- Daily-generated data: From 2021-02-28 to the day of request;
- Monthly-generated data: From Aug 2017 to the day of request.
Futures data has unified affordance:
- USDⓈ-M Futures pairs: From 2020-01-01;
- COIN-M Futures pairs: From 2020-08-01 to the day of request.
Binance Futures also provides liquidity data, such as book ticker, book depth, funding rate, and multiple derivative metrics data for all data products. For more details, please check the Historical Market Data page.
Please note that the Futures order book data is currently only available via Futures API. You would need a Futures account to download the data.
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 from the Binance API?
To download historical market data files via API, please refer to this GitHub link, the data types, and their corresponding endpoints below.
Please note:
- You can find the full description and the guide on using the Futures order book data on Github.
- You can refer to the CHECKSUM file to check data integrity.
- Please note that Futures order book data can only be accessed via API. To access Binance Futures order book data, you need to have a Binance Futures account and apply for it via this form. We will send you a confirmation email once access has been granted.
- You can also query some of the historical data by sending API requests.
| Data Type | Spot endpoint | UM endpoint | CM endpoint |
| Klines | /api/v3/klines | /fapi/v1/klines | /dapi/v1/klines |
| Agg Trades | /api/v3/aggTrades | /fapi/v1/aggTrades | /dapi/v1/aggTrades |
| Trades | /api/v3/historicalTrades | /fapi/v1/trades | /dapi/v1/trades |
| Index Price K-line | N/A | /fapi/v1/indexPriceKlines | /dapi/v1/indexPriceKlines |
| Mark Price K-line | N/A | /fapi/v1/markPriceKlines | /dapi/v1/markPriceKlines |
| Premium Index K-line | N/A | /fapi/v1/premiumIndex | /dapi/v1/premiumIndex |
| Trading Metrics | N/A | /futures/data/openInterestHist /futures/data/topLongShortAccountRatio /futures/data/topLongShortPositionRatio /futures/data/globalLongShortAccountRatio /futures/data/takerlongshortRatio | /futures/data/openInterestHist /futures/data/topLongShortAccountRatio /futures/data/topLongShortPositionRatio /futures/data/globalLongShortAccountRatio /futures/data/takerlongshortRatio /futures/data/basis |
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.
Please refer to the download guide for more details.
Please refer to the download guide for more details.
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.
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:
- Trading services that make use of Binance quotes or market bulletin board information.
- Data feeding or streaming services that make use of any market data of Binance.
- 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.