Download Binance historical kline data — straight from data.binance.vision.

data.binance.vision is Binance's public market-data archive, documented in the official binance-public-data repository. It is a plain object-storage bucket with a small file browser in front of it. Every file is a ZIP containing one CSV, published per symbol, per interval, and per calendar period, alongside a .CHECKSUM companion file for verifying the download.

The archive covers spot, USDⓈ-M futures, COIN-M futures, and options datasets. For each market you can pull klines (candlesticks), trades (every individual execution), and aggTrades (compressed trade aggregates); this guide focuses on klines, which is what you need for charting. Interval folders range from 1m, 5m, and 15m up through 1h, 4h, 1d, and beyond — spot even has a 1s folder.

Every kline file follows one pattern. For spot monthly bundles:

https://data.binance.vision/data/spot/monthly/klines/{SYMBOL}/{INTERVAL}/{SYMBOL}-{INTERVAL}-{YYYY-MM}.zip

Concrete examples — one hourly month, one 15-minute month, and one daily file:

https://data.binance.vision/data/spot/monthly/klines/BTCUSDT/1h/BTCUSDT-1h-2024-01.zip
https://data.binance.vision/data/spot/monthly/klines/BTCUSDT/15m/BTCUSDT-15m-2024-01.zip
https://data.binance.vision/data/spot/daily/klines/BTCUSDT/1h/BTCUSDT-1h-2026-07-30.zip

Two details cause most failed downloads. First, the storage is case-sensitive and symbols are uppercase: a pasted URL with btcusdt in the path returns 404 where BTCUSDT succeeds. Second, monthly files only exist for completed months — they are typically published in the first days of the following month, so the current month lives only under daily/.

To fetch a month of BTCUSDT hourly candles from the command line:

curl -O https://data.binance.vision/data/spot/monthly/klines/BTCUSDT/1h/BTCUSDT-1h-2024-01.zip
unzip BTCUSDT-1h-2024-01.zip   # -> BTCUSDT-1h-2024-01.csv, 744 hourly rows

If you prefer clicking, the web index lets you drill down through the same folders and download files in the browser.

Each row is one candle with twelve columns. Spot kline CSVs ship without a header row, while the futures archive files carry one — check the first line before you parse.

The timestamp-unit trap: older files record epoch milliseconds (13 digits), but newer spot files — from 2025 onward — record microseconds (16 digits). A parser that assumes milliseconds will happily place a 2025 candle in the year 56,000-something. The robust rule is to check the digit count per file before converting, rather than hard-coding a unit. All timestamps are UTC either way.

Here is the part most archive tutorials skip: candles alone are only half a review. To learn anything from a month of data, you want your own trades drawn on top of it. There are two ways to get there in KLinePic, depending on how exact you need the candles to be.

Path 1: let KLinePic fetch the candles (the usual case)

For Binance-resolvable pairs such as BTCUSDT or ETHUSDT, KLinePic pulls public Binance klines automatically — its backend queries the spot kline API on data-api.binance.vision and falls back to the data.binance.vision futures archive when needed. So the only file you upload is your trade CSV, using the schema from the data protocol:

trade_id,symbol,event_type,position_side,time,price,quantity,fee,note
VISION-BTC-001,BTCUSDT,buy,long,2024-01-10T09:00:00+00:00,46210.50,0.05,0.00005,
VISION-BTC-001,BTCUSDT,sell,long,2024-01-12T15:00:00+00:00,47895.00,0.05,2.39,

Start from the Binance trade CSV template, or follow the Binance trade history guide to map an exchange export into these fields. Paste or upload at /upload and the chart renders with B/S markers, holding window, return, max run-up, and max drawdown — no account required.

Path 2: upload the archive candles as a custom K-line CSV

When the chart must be built on the exact file you downloaded — a backtest that consumed the archive, research that has to be reproducible bar-for-bar, or an interval or window you want pinned — convert the twelve-column archive rows into KLinePic's candle CSV and upload it together with your trades:

symbol,time,open,high,low,close,volume
BTCUSDT,2024-01-10T09:00:00+00:00,46180.00,46340.10,46102.33,46210.50,412.88
BTCUSDT,2024-01-10T10:00:00+00:00,46210.50,46333.00,46150.01,46287.20,377.41

The mapping is mechanical: keep columns 1–6 (open time, open, high, low, close, volume), convert the epoch timestamp to ISO 8601 with a +00:00 offset, drop the rest. The market data coverage guide documents when this custom-candle path is the right proof and how symbol matching works.

• data.binance.vision is Binance's free public data archive: kline, trade, and aggTrade ZIPs for spot, USDⓈ-M, COIN-M, and options, documented at github.com/binance/binance-public-data. No API key or account is needed.
• Spot kline path pattern: data/spot/monthly/klines/{SYMBOL}/{INTERVAL}/{SYMBOL}-{INTERVAL}-{YYYY-MM}.zip, with daily equivalents; futures live under data/futures/um/ and data/futures/cm/.
• Symbol folders are uppercase and paths are case-sensitive; monthly bundles exist only for completed months.
• Kline CSVs carry twelve columns (open time, OHLC, volume, close time, quote volume, trade count, taker buy volumes, ignore); spot files have no header row. Timestamps are UTC epoch values — check whether a file uses milliseconds (13 digits) or microseconds (16 digits) before converting.
• KLinePic (klinepic.com) turns trade fills into annotated K-line review charts and fetches Binance public candles automatically for pairs such as BTCUSDT; the exact archive files can be supplied instead as a custom K-line CSV (symbol,time,open,high,low,close,volume).
• Free to start, no account required to render; batch rendering and a documented Agent API are available, with the CSV/JSON contracts at /docs.

• Binance trade history chart — exporting your fills from Binance and mapping them into the trade CSV.
• Market data and K-line coverage — when automatic candles are enough and when to upload your own.
• Coinbase historical data download — the equivalent walkthrough for Coinbase's public candles API.
• Crypto exchange trade history chart — the shared fills-to-chart schema across exchanges.
• Trade review charts by symbol — per-symbol pages for BTCUSDT, ETHUSDT, SOLUSDT and more.
• All guides — the full guide index.