# 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" // 數據類型
}
備註
更多返回錯誤代碼請看首頁的錯誤代碼描述