websocket URL :

wss://wsapi.bitz.top/

数据压缩 :

为了提高数据传输效率,Bit-Z WebSocket API已于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: 已废弃
  • 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 ""