幣安提供 U 本位和幣本位合約的歷史訂單簿資料，協助您進行回測與策略、研究和分析的最佳化，以及融入幣安生態系。敬請期待未來更廣泛的歷史資料。
存取
您可以在這裡獲得幣安合約歷史資料。如果您要尋找合約的歷史訂單簿資料，您需要擁有有效的合約帳戶，且訂單簿資料僅能由幣安 VIP 1 以上的用戶透過 API 存取。請注意，您只能使用 API 下載訂單簿資料。
如需進一步協助，請聯繫 data@binance.com。
產品規格
幣安合約於 2023 年 5 月 27 日強化了產品功能，並變更產品規格。
2020 年6 月 1 日至 2023 年 5 月 27 日
提供的三種資料類型如下：
- T_DEPTH (Tick-Level 訂單簿)：逐筆訂單簿 (第 2 級)，直接從 API 和 WSS 不同深度流中提取資料，有資料空缺。
- S_DEPTH (訂單簿快照)：從 2020 年 1 月開始的訂單簿快照資料 (第 2 級)。臨時資料解決方案目前僅適用於 BTCUSDT，僅為 BTCUSDT 幣種提供 2 種級別的訂單簿快照。
- T_DEPTH_BACKFILL (Tick-Level 訂單簿回溯)：逐筆訂單簿 (第 2 級) ，自 2021 年 7 月中旬起，已停止產出附內部回溯紀錄的 T_DEPTH 。
T_DEPTH
資料綱要
| 欄位 | 說明 |
| 幣種 | 支援幣本位和 U 本位合約幣種 (可透過不同幣種查詢，例如：「BTCUSDT」、「BTCUSD_200925」) |
| time | 交易時間列於時間戳中。自 2020 年 7 月 1 日至今。新發行的幣種則自發行日開始。 |
| first_update_id | - |
| last_update_id | - |
| pu | 上一行的 last_update_id 可幫助檢查完整性。僅適用於幣本位合約深度更新 (不適用於訂單簿快照)。 |
| 方向 | a = 賣方 (賣單) b = 買方 (買單) |
| update_type | snap = 僅適用於訂單簿快照 set = 將價格級別設定為目前數量 (而非增量) delta = 價格級別的數量變化 (增量) |
| 價格 | - |
| qty | - |
範例資料
| 幣種 | timestamp | first_update_id | last_update_id | pu | 方向 | update_type | 價格 | qty |
| BTCUSDT | 1593647999921 | 39538108420 | 39538108420 | 39538108419 | a | set | 9235.09 | 0 |
| BTCUSDT | 1593647999933 | 39538108444 | 39538108444 | 39538108420 | a | set | 9236.04 | 0.852 |
| BTCUSDT | 1593647999954 | 39538108472 | 39538108472 | 39538108444 | b | set | 9219.67 | 0 |
| BTCUSDT | 1593647999983 | 39538108497 | 39538108497 | 39538108472 | a | set | 9236.04 | 0.912 |
| BTCUSDT | 1593647999983 | 39538108498 | 39538108498 | 39538108497 | a | set | 9235.11 | 0 |
S_DEPTH
資料綱要
| 欄位 | 說明 |
| 幣種 | 支援幣本位和 U 本位合約幣種 (可透過不同幣種查詢，例如：「BTCUSDT」、「BTCUSD_200925」) |
| time | 交易時間列於時間戳中。自 2020 年 7 月 1 日至今。新發行的幣種則自發行日開始。 |
| first_update_id | - |
| last_update_id | - |
| pu | 上一行的 last_update_id 可幫助檢查完整性。僅適用於幣本位合約深度更新 (不適用於訂單簿快照)。 |
| 方向 | a = 賣方 (賣單) b = 買方 (買單) |
| update_type | snap = 僅適用於訂單簿快照 set = 將價格級別設定為目前數量 (而非增量) delta = 價格級別的數量變化 (增量) |
| 價格 | - |
| qty | - |
範例資料
| 幣種 | timestamp | first_update_id | last_update_id | 方向 | update_type | 價格 | qty |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | a | snap | 20.487 | 551 |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | a | snap | 20.488 | 404 |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | a | snap | 20.489 | 229 |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | b | snap | 20.485 | 866 |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | b | snap | 20.485 | 298 |
2023 年 5 月 27 日至今
提供兩種資料類型如下：
- T_DEPTH (Tick-Level 訂單簿)：逐筆訂單簿 (第 2 級)，由媒合引擎內部資料產生，無資料差距。
- S_DEPTH (訂單簿快照)：訂單簿快照 (第 2 級)；每分鐘更新每個幣種所有深度的快照。
T_DEPTH
T_DEPTH 下載檔應該由兩個單獨的檔案組成，第一個以 " _depth_snap 結尾"，代表指定日期開始時的訂單簿深度快照，第二個以 " _depth_update" 結尾的檔案包含在初期深度快照之後對訂單簿的更新。深度更新資料根據 trans_id 級別進行分組，使用戶能夠在每個 trans_id 級別觀察訂單簿價格/數量的相關變化。請注意，trans_id 在幣種級別會自動遞增。
資料綱要
| 欄位 | 說明 |
| 幣種 | 支援幣本位和 U 本位合約幣種 (可透過不同幣種查詢，例如：「BTCUSDT」、「BTCUSD_200925」) |
| time | 交易時間列於時間戳中。自 2020 年 7 月 1 日至今。新發行的幣種則自發行日開始。 |
| first_update_id | - |
| last_update_id | - |
| trans_id | 媒合引擎中的交易 ID，每個 trans_id 可能會有多個訂單簿價格級別上的更新 |
| 方向 | a = 賣方 (賣單) b = 買方 (買單) |
| update_type | snap = 僅適用於訂單簿快照 set = 將價格級別設定為目前數量 (而非增量) |
| 價格 | - |
| qty | - |
深度快照範例資料
| 幣種 | timestamp | first_update_id | last_update_id | 方向 | update_type | 價格 | qty | trans_id |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | a | snap | 20.487 | 551 | 232143412 |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | a | snap | 20.488 | 404 | 232143423 |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | a | snap | 20.489 | 229 | 232143415 |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | b | snap | 20.485 | 866 | 232143419 |
| SOLUSDT | 1685663989004 | 2903022136846 | 2903022136846 | b | snap | 20.485 | 298 | 243215125 |
深度更新範例資料
| 幣種 | timestamp | first_update_id | last_update_id | 方向 | update_type | 價格 | qty | trans_id |
| SOLUSDT | 1685577589191 | 2899807690957 | 2899807690957 | b | set | 20.611 | 201 | 232143412 |
| SOLUSDT | 1685577589191 | 2899807690963 | 2899807690963 | b | set | 20.542 | 124 | 232143423 |
| SOLUSDT | 1685577589193 | 2899807690982 | 2899807690982 | a | set | 20.952 | 116 | 232143415 |
| SOLUSDT | 1685577589193 | 2899807690990 | 2899807690990 | a | set | 21.021 | 35 | 232143419 |
| SOLUSDT | 2899807690990 | 2899807690994 | 2899807690994 | b | set | 20.678 | 1476 | 243215125 |
S_DEPTH
資料綱要
| 欄位 | 說明 |
| 幣種 | 支援幣本位和 U 本位合約幣種 (可透過不同幣種查詢，例如：「BTCUSDT」、「BTCUSD_200925」) |
| timestamp | 交易時間列於時間戳中。自 2020 年 7 月 1 日至今。新發行的幣種則自發行日開始。 |
| update_id | 最近更新 |
| 方向 | a = 賣方 (賣單) b = 買方 (買單) |
| 價格 | - |
| qty | - |
範例資料
timestamp | update_id | 幣種 | 方向 | 價格 | qty |
1693785660000 | 3230886649408 | BTCUSDT | a | 27414.3 | 0.003 |
1693785660000 | 3230886649408 | BTCUSDT | a | 26318.5 | 0.001 |
1693785660000 | 3230889577102 | BTCUSDT | a | 26067.7 | 1.394 |
1693785660000 | 3230886649408 | BTCUSDT | a | 28825 | 0.007 |
1693785660000 | 3230886649408 | BTCUSDT | a | 37232.1 | 0.001 |
1693785660000 | 3230886649408 | BTCUSDT | a | 26949.2 | 0.004 |
1693785660000 | 3230886649408 | BTCUSDT | b | 22357.5 | 0.005 |
1693785660000 | 3230886649408 | BTCUSDT | b | 10390.5 | 0.002 |
資料何時會更新？
T+1 天，資料通常會在 08:00 (UTC) 前準備就緒。
如何透過 API 下載歷史合約訂單簿第 2 級資料？
為了取得合約的歷史訂單簿資料，API 帳戶還應該具備有效的合約帳戶，並維持 VIP 用戶狀態。
如何透過 API 取得合約訂單簿資料？
指定下列變數以要求下載連結：
交易對 | 帳戶類別 | 必填 | 備註 |
幣種 | STRING | 是 | 支援 U 本位和幣本位合約幣種 |
startTime | 多頭 | 是 | 如果沒有設定開始時間，則預設為結束時間 - 7 天 |
endTime | 多頭 | 是 | 如果沒有設定結束時間，則預設為目前時間 |
dataType | 列舉 | 是 | S_DEPTH / T_DEPTH |
rectWindow | 多頭 | 否 | - |
timestamp | 多頭 | 是 | - |
* startTime 與 endTime 之間的間隔不得超過 7 天。