買幣
支付方式為
交易
衍生品
理財
金融業務
NFT
機構
廣場
USD

常見問題

賬戶功能
用戶教程
幣安粉絲代幣
幣安理財
數字貨幣充值&提現
買幣
現貨&杠桿交易
數字貨幣衍生品
金融業務
API
安全專欄
服務協議
NFT
VIP
首頁
幫助中心
常見問題
用戶教程
如何在幣安下載歷史市場資料

如何在幣安下載歷史市場資料

2022-12-13 06:29
幣安提供歷史市場資料,您可透過幣安網站或 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 月起,適用所有幣種和交易對。
更多詳情,請參考幣安合約訂單簿歷史資料

資料免責聲明 

請注意,我們的所有資料服務皆嚴格遵守幣安使用條款
若無幣安書面同意,禁止將幣安提供之資料用於下列商業用途:
  1. 使用幣安報價或市場公告資訊提供交易服務。
  2. 使用幣安提供的任何市場資料提供資料饋送或串流服務。
  3. 透過從幣安獲得的市場資料收取費用或獲利(包含透過廣告或推薦手續費)的任何其他網站/App/服務。
您在此理解並同意,對於因以下原因引起或與之相關的任何損失或損害,幣安一概不承擔責任:(a) 數位資產價格資料的任何不準確、缺陷或遺漏,(b) 傳遞此類資料的任何錯誤或延遲,(c) 任何此類資料的中斷,(d) 幣安執行的定期或計劃外維護,以及此類維護導致的服務中斷和變更,(e) 因其他用戶的行為、疏忽或違反條款而造成的任何損害,(f) 其他第三方的非法行為或未經幣安授權的行為所造成的任何損害;以及 (g) 幣安發布的免責聲明和平台規則中提到的其他豁免情形。