幣安提供歷史市場資料,您可透過幣安網站或 API 下載。
有哪些資料?
幣安提供所有現貨及合約交易對之 K 線圖、交易與匯總交易資料 (包含 U 本位及幣本位合約交易對)。
目前幣安支援所有現貨交易對的 K 線圖、交易與匯總交易資料:
- 每日生成資料:自 2021 年 2 月 28 日至請求資料日;
- 每月生成資料:自 2017 年 8 月至請求資料日。
合約資料具有統一的功能特性:
- U 本位合約交易對:自 2020 年 1 月 1 日起;
- 幣本位合約交易對:自 2020 年 8 月 1 日至請求資料日。
考量幣安合約交易定價機制,除了合約價格 K 線圖資料,幣安也提供歷史指數價格 K 線圖、標記價格 K 線圖與溢價指數 K 線圖作為參考。
請注意,合約訂單簿資料目前僅能透過合約 API 取得。您需要擁有合約帳戶方能下載資料。
資料更新頻率為何?
每日生成資料將於隔日約 10:00 (UTC) 更新。每月生成資料將於隔月第一天更新。
如何從幣安網站下載資料?
幣安為所有用戶提供透過歷史市場資料網站直接下載歷史市場資料的服務。您可以查看現貨與合約交易對的全部 K 線圖、交易與匯總交易資料。
1. 登入您的幣安帳戶並前往 [機構] - [歷史市場資料]。

2. 選取您要下載的資料。

3. 您將被重新導向幣安市場資料網站,您可以選擇每日生成資料進行下載。
若要下載每月生成資料,例如您要下載現貨每月資料,便可點擊 [現貨] 接著選取 [每月]。

如何從幣安 API 下載資料?
若要透過 API 下載歷史市場資料,請參考以下資料類型與其對應之端點。
請注意:
- 您可以在 Github 上找到完整說明與如何使用合約訂單簿資料的指南。
- 您可以參考 CHECKSUM 檔案以檢查資料完整性。
- 請注意,合約訂單簿資料僅能透過 API 取得。為取得幣安合約訂單簿資料,您需要擁有幣安合約帳戶。請經由此表格申請。授予權限後,我們會發送給您一份確認函。
資料類型 | 現貨端點 | U 本位合約端點 | 幣本位合約端點 |
K 線 | /api/v3/klines | /fapi/v1/klines | /dapi/v1/klines |
匯總交易 | /api/v3/aggTrades | /fapi/v1/aggTrades | /dapi/v1/aggTrades |
交易 | /api/v3/historicalTrades | /fapi/v1/trades | /dapi/v1/trades |
指數價格 K 線 | 不適用 | /fapi/v1/indexPriceKlines | /dapi/v1/indexPriceKlines |
標記價格 K 線 | 不適用 | /fapi/v1/markPriceKlines | /dapi/v1/markPriceKlines |
溢價指標 K 線 | 不適用 | /fapi/v1/premiumIndex | /dapi/v1/premiumIndex |
交易指標 | 不適用 | /futures/data/openInterestHist /futures/data/topLongShortAccountRatio /futures/data/topLongShortPositionRatio /futures/data/globalLongShortAccountRatio /futures/data/takerlongshortRatio | 不適用 |
每個資料類型分別代表什麼?
K 線
K 線圖又被稱為「蠟燭圖資料」,係以開盤時間作為唯一辨別。現貨和合約都支援多個不同的時間間隔。
現貨帳戶
開盤時間 | K 線開盤時間,時間格式為 Unix |
Open | 開盤價 |
High | 最高價 |
Low | 最低價 |
Close | 收盤價 |
Volume | 成交量 |
Close time | K 線收盤時間,時間格式為 Unix |
Quote asset volume | 報價資產成交量 |
Number of trades | 交易筆數 |
Taker buy base asset volume | 期間內吃單方購買基礎資產成交量 |
Taker buy quote asset volume | 期間內吃單方購買報價資產成交量 |
Ignore | 忽略 |
U 本位合約
open_time | K 線開盤時間,時間格式為 Unix |
open | 開盤價 |
high | 最高價 |
low | 最低價 |
close | 收盤價 |
成交量 | 成交量 |
close_time | K 線收盤時間,時間格式為 Unix |
quote_volume | 報價資產成交量 |
count | 交易筆數 |
taker_buy_volume | 期間內吃單方購買基礎資產成交量 |
taker_buy_quote_volume | 期間內吃單方購買報價資產成交量 |
忽略 | 忽略 |
幣本位合約
open_time | K 線開盤時間,時間格式為 Unix |
open | 開盤價 |
high | 最高價 |
low | 最低價 |
close | 收盤價 |
成交量 | 成交量 |
close_time | K 線收盤時間,時間格式為 Unix |
base_volume | 基礎資產成交量 |
count | 交易筆數 |
taker_buy_volume | 期間內吃單方購買成交量 |
taker_buy_base_volume | 期間內吃單方購買基礎資產成交量 |
忽略 | 忽略 |
匯總交易
結合以指定價格成交的訂單在每日和每月的時間間隔中的彙整總交易量。
現貨帳戶
Aggregate tradeId | 匯總交易 ID |
價格 | 價格 |
Quantity | 數量 |
First tradeId | 第一筆交易 ID |
Last tradeId | 最後一筆交易 ID |
Timestamp | Unix 時間格式 |
Was the buyer the maker | 是否為吃單方或掛單方 |
Was the trade the best price match | 是否為最佳價格配對 |
U 本位與幣本位合約
agg_trade_id | 匯總交易 ID |
價格 | 價格 |
數量 | 數量 |
first_trade_id | 第一筆交易 ID |
last_trade_id | 最後一筆交易 ID |
transact_time | Unix 時間格式 |
is_buyer_maker | 是否為吃單方或掛單方 |
交易
已執行的交易在每日和每月時間間隔內已按 tick 級別更新。
現貨帳戶
trade Id | 交易 ID |
價格 | 價格 |
qty | 數量 |
quoteQty | 報價數量 |
time | Unix 時間格式 |
isBuyerMaker | 是否為吃單方或掛單方 |
isBestMatch | 是否為最佳價格配對 |
U 本位合約
id | 交易 ID |
價格 | 價格 |
qty | 數量 |
quote_qty | 報價數量 |
time | Unix 時間格式 |
is_buyer_maker | 是否為吃單方或掛單方 |
幣本位合約
id | 交易 ID |
價格 | 價格 |
qty | 數量 |
base_qty | 基礎資產數量 |
time | Unix 時間格式 |
is_buyer_maker | 是否為吃單方或掛單方 |
指數價格 K 線
U 本位與幣本位合約
open_time | K 線開盤時間,時間格式為 Unix |
open | 指數價格之開盤價 |
high | 指數價格之最高價 |
low | 指數價格之最低價 |
close | 指數價格之收盤價 |
成交量 | 忽略 |
close_time | K 線收盤時間,時間格式為 Unix |
quote_volume | 忽略 |
count | 忽略 |
taker_buy_volume | 忽略 |
taker_buy_quote_volume | 忽略 |
忽略 | 忽略 |
標記價格 K 線
U 本位與幣本位合約
open_time | K 線開盤時間,時間格式為 Unix |
open | 標記價格之開盤價 |
high | 標記價格之最高價 |
low | 標記價格之最低價 |
close | 標記價格之收盤價 |
成交量 | 忽略 |
close_time | K 線收盤時間,時間格式為 Unix |
quote_volume | 忽略 |
count | 忽略 |
taker_buy_volume | 忽略 |
taker_buy_quote_volume | 忽略 |
忽略 | 忽略 |
溢價指標 K 線
U 本位與幣本位合約
open_time | K 線開盤時間,時間格式為 Unix |
open | 溢價指數之開盤價 |
high | 溢價指數之最高價 |
low | 溢價指數之最低價 |
close | 溢價指數之收盤價 |
成交量 | 忽略 |
close_time | K 線收盤時間,時間格式為 Unix |
quote_volume | 忽略 |
count | 忽略 |
taker_buy_volume | 忽略 |
taker_buy_quote_volume | 忽略 |
忽略 | 忽略 |
交易指標
U 本位合約
create_time | 創建時間 |
幣種 | 幣種 |
sum_open_interest | 總未平倉量 (基礎資產) |
sum_open_interest_value | 總未平倉價值 |
count_toptrader_long_short_ratio | 頂級交易者之多空帳戶數量比率 |
sum_toptrader_long_short_ratio | 頂級交易者之多空部位數量比率 |
count_long_short_ratio | 所有交易者之多空帳戶數量比率 |
sum_taker_long_short_vol_ratio | 合約吃單方總購買成交量 / 吃單方總出售成交量 |
合約訂單簿資料
目前幣安僅提供合約歷史訂單簿資料。您需要擁有合約帳戶方能下載,且此資料僅能經由 API 取得。
更多詳情請參考下載指南。
更多詳情請參考下載指南。
幣安提供以下合約歷史訂單簿資料:
- 訂單簿快照 (S_Depth)
自 2020 年 1 月起,僅限 BTC/USDT 幣種。
- Tick 級別訂單簿 (T_Depth)
從 2020 年 7 月起,適用所有幣種和交易對。
更多詳情,請參考幣安合約訂單簿歷史資料。
資料免責聲明
請注意,我們的所有資料服務皆嚴格遵守幣安使用條款。
若無幣安書面同意,禁止將幣安提供之資料用於下列商業用途:
- 使用幣安報價或市場公告資訊提供交易服務。
- 使用幣安提供的任何市場資料提供資料饋送或串流服務。
- 透過從幣安獲得的市場資料收取費用或獲利(包含透過廣告或推薦手續費)的任何其他網站/App/服務。
您在此理解並同意,對於因以下原因引起或與之相關的任何損失或損害,幣安一概不承擔責任:(a) 數位資產價格資料的任何不準確、缺陷或遺漏,(b) 傳遞此類資料的任何錯誤或延遲,(c) 任何此類資料的中斷,(d) 幣安執行的定期或計劃外維護,以及此類維護導致的服務中斷和變更,(e) 因其他用戶的行為、疏忽或違反條款而造成的任何損害,(f) 其他第三方的非法行為或未經幣安授權的行為所造成的任何損害;以及 (g) 幣安發布的免責聲明和平台規則中提到的其他豁免情形。