# Websocket 行情推送
# 1. 訂閱逐筆交易
逐筆交易推送每一筆成交的信息。成交,或者說交易的定義是僅有一個吃單者與一個掛單者相互交易
訂閱類型
dataType 為 <symbol>@trade,比如BTC-USDT@trade ETH-USDT@trade
訂閱例子
{"id":"24dd0e35-56a4-4f7a-af8a-394c7060909c","dataType":"BTC-USDT@trade"}
訂閱參數
參數名 | 參數類型 | 必填 | 描述 |
---|---|---|---|
symbol | String | 是 | 合約名稱中需有"-",如BTC-USDT |
推送數據
返回欄位 | 欄位說明 |
---|---|
dataType | 訂閱的數據類型,例如 BTC-USDT@trade |
data | 推送內容 |
e | 事件類型 |
E | 事件時間 |
s | 交易對 |
t | 交易ID |
p | 成交價格 |
q | 成交數量 |
T | 成交時間 |
m | 買方是否是做市方。如true,則此次成交是一個主動賣出單,否則是一個主動買入單。 |
# Response
{
"data": {
"E": 1649832413551,
"T": 1649832413512,
"e": "trade",
"p": "40125.48",
"q": "0.007146",
"s": "BTC-USDT",
"t": "33685717"
"m": true
},
"dataType": "BTC-USDT@trade"
}
# 2. K線 Streams
K線stream逐秒推送所請求的K線種類(最新一根K線)的更新。
訂閱類型
dataType 為 <symbol>@kline_<interval>,比如BTC-USDT@kline_1min
訂閱例子
{"id":"e745cd6d-d0f6-4a70-8d5a-043e4c741b40","dataType":"BTC-USDT@kline_1min"}
訂閱參數
參數名 | 參數類型 | 必填 | 欄位描述 | 描述 |
---|---|---|---|---|
symbol | String | 是 | 合約名稱 | 合約名稱中需有"-",如BTC-USDT |
interval | String | 是 | k線類型 | 參考欄位說明,K線類型,1min, 5min, 15min, 30min, 60min, 1day |
備註
目前僅提供一分鐘的k線數據
klineType | 欄位說明 |
---|---|
1min | 1min一分鐘K線 |
推送數據
返回欄位 | 欄位說明 |
---|---|
dataType | 訂閱的數據類型,例如 BTC-USDT@kline_1min |
data | 推送內容 |
e | 事件類型 |
E | 事件時間 |
s | 交易對 |
K | 數據 |
t | 這根K線的起始時間 |
T | 這根K線的結束時間 |
s | 交易對 |
i | K線間隔 |
o | 這根K線期間第一筆成交價 |
c | 這根K線期間末一筆成交價 |
h | 這根K線期間最高成交價 |
l | 這根K線期間最低成交價 |
v | 這根K線期間成交量 |
n | 這根K線期間成交筆數 |
q | 這根K線期間成交額 |
# Response
{
"data": {
"E": 1649832726550,
"K": {
"T": 1649832779999,
"c": "40017.48",
"h": "40027.83",
"i": "1min",
"l": "40017.48",
"n": 13,
"o": "40025.42",
"q": "2693.492344",
"s": "BTC-USDT",
"t": 1649832720000,
"v": "0.067295"
},
"e": "kline",
"s": "BTC-USDT"
},
"dataType": "BTC-USDT@kline_1min"
}
# 3. 有限檔深度信息
每秒推送有限檔深度信息。默認20檔,某些小幣種可能不足20檔,可以選擇100檔
訂閱類型
dataType 為 <symbol>@depth<level>,比如BTC-USDT@depth, BTC-USDT@depth20, BTC-USDT@depth100
訂閱例子
{"id":"975f7385-7f28-4ef1-93af-df01cb9ebb53","dataType":"BTC-USDT@depth"}
訂閱參數
參數名 | 參數類型 | 必填 | 欄位描述 | 描述 |
---|---|---|---|---|
symbol | String | 是 | 合約名稱 | 合約名稱中需有"-",如BTC-USDT |
推送數據
返回欄位 | 欄位說明 |
---|---|
dataType | 訂閱的數據類型,例如 BTC-USDT@depth |
data | 推送內容 |
bids | 變動的買單深度 |
asks | 變動的賣單深度 |
# Response
{
"dataType": "BTC-USDT@depth",
"data": {
"bids": [
[
"43302.00", // 變動的價格檔位
"0.000021" // 數量
]
],
"asks": [
[
"43499.00", // 變動的價格檔位
"0.000021" // 數量
]
]
}
}