Historical Market Data
We've made Candlestick, Trade, and AggTrade data for all pairs available for download.
What Data Is Available
We provide data at daily and monthly intervals. Data for a day is uploaded the following day, and we begin to upload data for a month at the beginning of the following month.
Data Products
Open API
Frequently Asked Questions
Candlestick
Also known as k-line, is distinguished by its open time and supports multiple intervals for analysis and interpretation.
Field Name
Description
open_time
Candlestick open time in Unix time format
open
Open price
high
High price
low
Low price
close
Close price
volume
Volume
close_time
Candlestick close time in Unix time format
quote_volume
Quote asset volume
count
Number of trades
taker_buy_base_volume
Taker buy base asset volume during this period
taker_buy_quote_volume
Taker buy quote asset volume during this period
Trades
Executed transactions updated at tick level throughout daily or monthly intervals.
Field Name
Description
id
Trade ID
price
Price
qty
Base quantity
quote_qty
Quote quantity
time
Time in Unix time format
is_buyer_maker
Whether trade was buyer or maker
Aggregated Trades
Combines the aggregate total volume of orders filled at a given price at daily or monthly intervals.
Field Name
Description
agg_trade_id
Aggregated trade ID
price
Price
quantity
Quantity
first_trade_id
First trade ID
last_trade_id
Last trade ID
transact_time
Transaction time in Unix time format
is_buyer_maker
Whether trade was buyer or maker
How To Download Programmatically
# download a single file
curl -s "https://data.binance.us/public_data/spot/daily/klines/BNBUSDT/12h/BNBUSDT-12h-2023-01-01.zip" -o BNBUSDT-12h-2023-01-01.zip
OR
wget "https://data.binance.us/public_data/spot/daily/klines/BNBUSDT/12h/BNBUSDT-12h-2023-01-01.zip"
OR
wget "https://data.binance.us/public_data/spot/daily/klines/BNBUSDT/12h/BNBUSDT-12h-2023-01-01.zip"
Put the URL https://www.binance.us/finder into your browser to check all your historical market data files.
We will expand this section with more methods in the future.
CHECKSUM
Each zip file has a checksum file together in the same folder to verify data integrity. To check:
# download a single file
curl -s "https://data.binance.us/public_data/spot/daily/klines/BNBUSDT/12h/BNBUSDT-12h-2023-01-01.zip.CHECKSUM" -o BNBUSDT-12h-2023-01-01.zip.CHECKSUM
OR
wget "https://data.binance.us/public_data/spot/daily/klines/BNBUSDT/12h/BNBUSDT-12h-2023-01-01.zip.CHECKSUM"
OR
wget "https://data.binance.us/public_data/spot/daily/klines/BNBUSDT/12h/BNBUSDT-12h-2023-01-01.zip.CHECKSUM"
#From Linux, sha256sum -c <zip_file_name.CHECKSUM>
#From MacOS
sha256sum -c BNBUSDT-12h-2023-01-01.zip
#From MacOS
shasum -a 256 -c BNBUSDT-12h-2023-01-01.zip.CHECKSUM
Data Disclaimer
Historical Market Data is provided for general informational purposes only and should NOT be: (1) considered an individualized recommendation, endorsement, or offer of any digital asset or services discussed herein; or (2) relied upon for any investment activities. All information is provided on an as-is basis and is subject to change without notice. While we strive to keep the information up to date and accurate, we make no representation or warranty of any kind, express or implied, regarding the accuracy, validity, reliability, availability, or completeness of any such information.
Without written consent from Binance.US, the following commercial uses of Binance.US data are prohibited:
- Trading services that make use of Binance.US quotes or market bulletin board information;
- Data feeding or streaming services that make use of any market data of Binance.US; or
- Any other websites/apps/services that charge for or otherwise profit from (including through advertising or referral fees) market data obtained from Binance.US.
All use of Historical Market Data is subject to Binance.US’ Terms of Use. You hereby understand and agree that Binance.US 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.US and service interruption and change resulting from such maintenance, (e) any damages incurred by other users’ actions, omissions or violations Binance.US’ Terms of Use, (f) any damage caused by illegal actions of other third parties or actions without authorization by Binance.US; and (g) other exemptions mentioned in disclaimers and platform rules issued by Binance.US.