websocket URL :

wss://wsapi.bitz.top/

數據壓縮

為了提高數據傳輸效率,Bit-Z Websocket將於2019年10月08日17:00 (UTC+8) 停止對非壓縮數據的支持,僅輸出GZIP壓縮數據,請Bit-Z API用戶們盡快升級: 訂閱時增加dataType=1參數,收到數據後用戶本地解壓。解壓縮請參考文檔及demo

心跳及長連接策略

  1. 客戶端5秒發送ping字符串到服務器,服務器將返回pong字符串,以此心跳維持長連接
  2. 服務器10秒檢測: 如果60秒內沒有收到客戶端的ping消息,將主動斷開連接
  3. 服務器5秒檢測與客戶端之間的網絡連接狀態,如此時網絡中斷,服務器會刪除此次訂閱,客戶端不會再收到新消息,客戶端此時需要重新發起訂閱請求,以前的訂閱請求都將失效
  4. 服務器在向客戶端發送新消息時,也會檢測此時的網絡連接狀態,如網絡中斷,同上處理

發送請求命令格式:

發送json

{"action":"Topic.sub","data":{"symbol":"bz_usdt","type":"market,depth,order,kline","resolution":"60min","_CDID":"100002","dataType": "1"},"msg_id":1562156656532}

解析後展示:

{
    "action": "Topic.sub",
    "data": {
        "symbol": "bz_usdt",
        "type": "market,depth,order,kline",
        "resolution": "60min",
        "_CDID": "100002",
        "dataType": "1"
    },
    "msg_id": 1562156656532
}

命令詳解:

action:
  • 訂閱請求: Topic.sub 添加訂閱、Topic.unsub 取消訂閱;單選
data :
1. symbol
  • 幣幣交易對名稱,如: btc_usdteth_btc;單選
    2. type
  • 訂閱類型 可選值:行情 market、深度depth、成交單order、k線kline; 可多選,以逗號分隔
    3. resolution (非必傳)
  • 訂閱類型有 kline 時必傳 可選值:1min5min15min30min60min4hour1day5day1week1mon; 單選
    4. _CDID
  • 站點信息 bitz網站值: 100002

    5. dataType (非必傳 默認0)
  • 0: (默認)字符串格式數據

  • 1: gzip壓縮後二進制格式數據,需用戶客戶端解壓

    msg_id:

    當前毫秒時間戳

客戶端接收消息:

1. market 行情消息:

{
    "msgId": 0,  # 消息id
    "params": [],  # 參數
    "data": {  # data數據
        "btc_usdt": {  #交易對名稱
            "s": "btc_usdt", #交易對名稱
            "q": "748289393.19", #24小時交易額
            "v": "68457.02", #24小時交易量
            "tp": "6.58",  #今日漲跌幅
            "p24": "11.74", #24小時漲跌幅
            "o": "10138.95", #開盤價
            "h": "11500.00",  #24小時最高價
            "l": "9728.61",  #24小時最低價
            "n": "11330.00", #當前價格
            "nP": 4,  #數量展示小數點位
            "pP": 2, #價格展示小數點位
            "cny": "77978.74", #人民幣估值
            "usd": "11330.00", #美元估值
            "krw": "13235981.30", #韓元估值
            "jpy": "1220905.17" #日元估值
        },
        ...... #其他所有交易對行情
    },
    "action": "Pushdata.market", #訂閱類型
    "time": 1562159048028, #消息時間
    "source": "sub-api" #發送來源
}

2. order 成交單信息:

{
    "msgId": 0, #消息id
    "params": { #參數
        "symbol": "bz_usdt" #交易對名稱
    },
    "action": "Pushdata.order", #訂閱類型
    "data": [ #data
        {
            "id": 1216814315, #id
            "t": "21:04:10", #時間
            "T": 1562159050, #時間戳
            "p": "0.1599", #價格
            "n": "2185.0000", #數量
            "s": "sell" #方向 sell: 賣 buy:買
        }
    ],
    "time": 1562159051901, #消息時間
    "source": "sub-api" #發送來源
}

3. depth 深度信息:

{
    "msgId": 0, #消息id
    "params": { #參數
        "symbol": "bz_usdt" #交易對名稱
    },
    "action": "Pushdata.depth", #訂閱類型
    "data": { #data
        "asks": [ # 委託方向: asks: 賣、bids:買
            [
                "0.1586", #價格
                "616.4175", #數量
                "97.7638" #總額
            ]
        ]
    },
    "time": 1562159910917, #消息時間
    "source": "sub-api" #發送來源
}

4. kline k線信息:

{
    "msgId": 0, #消息id
    "params": { #參數
        "symbol": "bz_usdt", #交易對名稱
        "resolution": "60min" #k線類型
    },
    "action": "Pushdata.kline", #訂閱類型
    "data": { #data
        "bars": [ # 包含k線軸列表
            {
                "time": "1562155200000", #毫秒時間戳
                "open": "0.1609", #開盤價
                "high": "0.1635", #最高價
                "low": "0.1575", #最低價
                "close": "0.1603", #收盤價
                "volume": "1288739.3374", #交易量
                "datetime": "2019-07-03 20:00:00" #k線軸時間
            }
        ],
        "resolution": "60min", #k線類型
        "symbol": "bz_usdt", # k線交易對名稱
        "from": "1562155200000", #開始時間
        "to": "1562151600000", #結束時間
        "size": 1 #k線總數
    },
    "time": 1562156715923, #消息時間
    "source": "sub-api" #發送來源
}

錯誤提示:

  • -101001 訂閱類型type參數錯誤
  • -101002 訂閱交易對symbol獲取失敗
  • -101003 k線刻度resolution錯誤

results matching ""

    No results matching ""