# Websocket 行情推送
# 1. 訂閱合約交易深度
訂閱合約對盤口深度的數據的推送,此主題發送最新市場深度快照。快照頻率為每秒1次。
訂閱類型
dataType 為 market.depth.$Symbol.$Step.$Level,比如market.depth.BTC-USDT.step0.level5
訂閱參數
參數名 | 參數類型 | 必填 | 描述 |
---|---|---|---|
symbol | String | 是 | 合約名稱中需有"-",如BTC-USDT |
step | String | 是 | 合併深度類型,step0,step1,step2,step3,step4,step5 |
level | String | 是 | 檔數, 如 level5,level10,level20,level50,level100 |
備註
"step" 合併深度類型
參數名 | 描述 |
---|---|
step0 | 不合併深度 |
step1 | 按價格最小精度乘以10合併深度數據 |
step2 | 按價格最小精度乘以100合併深度數據 |
step3 | 按價格最小精度乘以1000合併深度數據 |
step4 | 按價格最小精度乘以10000合併深度數據 |
step5 | 按價格最小精度乘以100000合併深度數據 |
"level" 深度檔數定義
參數名 | 描述 |
---|---|
level5 | 5檔 |
level10 | 10檔 |
level20 | 20檔 |
level50 | 50檔 |
level100 | 100檔 |
推送數據
返回欄位 | 欄位說明 |
---|---|
code | 是否有錯誤信息,0為正常,1為有錯誤 |
dataType | 訂閱的數據類型,例如 market.depth.BTC-USDT.step0.level5 |
data | 推送內容 |
asks | 賣方深度 |
bids | 買方深度 |
p | price價格 |
v | volume數量 |
# Response
{
"code": 0,
"dataType": "market.depth.BTC-USDT.step0.level5",
"data": {
"asks": [
{
"p": 5319.94,
"v": 0.05483456
},{
"p": 5320.19,
"v": 1.05734545
},{
"p": 5320.39,
"v": 1.16307999
},{
"p": 5319.94,
"v": 0.05483456
},{
"p": 5320.19,
"v": 1.05734545
},{
"p": 5320.39,
"v": 1.16307999
},
],
"bids": [
{
"p": 5319.94,
"v": 0.05483456
},{
"p": 5320.19,
"v": 1.05734545
},{
"p": 5320.39,
"v": 1.16307999
},{
"p": 5319.94,
"v": 0.05483456
},{
"p": 5320.19,
"v": 1.05734545
},{
"p": 5320.39,
"v": 1.16307999
},
],
}
}
# 2. 訂單最新成交記錄
訂閱單個合約的逐筆成交明細
訂閱類型
dataType 為 market.trade.detail.$Symbol,比如market.trade.detail.BTC-USDT
訂閱參數
參數名 | 參數類型 | 必填 | 欄位描述 | 描述 |
---|---|---|---|---|
symbol | String | 是 | 合約名稱 | 合約名稱中需有"-",如BTC-USDT |
推送數據
返回欄位 | 欄位說明 |
---|---|
code | 是否有錯誤信息,0為正常,1為有錯誤 |
dataType | 訂閱的數據類型,例如 market.tradeDetail.BTC-USDT |
data | 推送內容 |
trades | 逐筆成交 |
time | 成交時間 |
makerSide | 吃單方向(Bid / Ask 買/賣) |
price | 成交價格 |
volume | 成交數量 |
# Response
{
"code": 0,
"dataType": "market.tradeDetail.BTC-USDT",
"data": {
"trades": [
{
"time": "2018-04-25T15:00:51.999Z",
"makerSide": "Bid",
"price": 0.279563,
"volume": 100,
},
{
"time": "2018-04-25T15:00:51.000Z",
"makerSide": "Ask",
"price": 0.279563,
"volume": 300,
}
]
}
}
# 3. 訂閱合約k線數據
訂閱單個合約的行情k線數據
訂閱類型
dataType 為 market.kline.$Symbol.$KlineType,比如market.kline.BTC-USDT.1min
訂閱參數
參數名 | 參數類型 | 必填 | 欄位描述 | 描述 |
---|---|---|---|---|
symbol | String | 是 | 合約名稱 | 合約名稱中需有"-",如BTC-USDT |
klineType | String | 是 | k線類型 | 參考欄位說明,如分鐘,小時,周等 |
備註
klineType 欄位說明 | |
---|---|
1min | 一分鐘K線 |
3min | 三分鐘K線 |
5min | 五分鐘K線 |
15min | 十五分鐘K線 |
30min | 三十分鐘K線 |
1hour | 一小時K線 |
2hour | 兩小時K線 |
4hour | 四小時K線 |
6hour | 六小時K線 |
12hour | 十二小時K線 |
1day | 日K線 |
1week | 周K線 |
1month | 月K線 |
推送數據
返回欄位 | 欄位說明 |
---|---|
code | 是否有錯誤信息,0為正常,1為有錯誤 |
data | 推送內容 |
dataType | 數據類型 |
klineInfosVo | K線數據 |
close | 收盤價 |
high | 最高價 |
low | 最低價 |
open | 收盤價 |
statDate | k線時間 |
time | k線時間戳,單位是毫秒 |
volume | 成交量 |
# Response
{
"code": 0,
"data": {
"klineInfosVo": [
{
"close": 54564.31,
"high": 54711.73,
"low": 54418.27,
"open": 54577.41,
"statDate": "2021-04-29T11:00:00.000+0800",
"time": 1619665200000,
"volume": 1607.0727000000002
}
]
},
"dataType": "market.kline.BTC-USDT.30min" // 數據類型
}
備註
更多返回錯誤代碼請看首頁的錯誤代碼描述