主题

主题列表:

主题(这些主题列表是开放主题,不需要做ws认证) 描述
Trade 最新成交
Ticker 实时价格
Depth 深度
QuoteBin1m 1分钟行情数据
QuoteBin5m 5分钟行情数据
QuoteBin30m 30分钟行情数据
QuoteBin1h 1小时行情数据
QuoteBin2h 2小时行情数据
QuoteBin4h 4小时行情数据
QuoteBin6h 6小时行情数据
QuoteBin12h 12小时行情数据
QuoteBin1d 日行情数据
QuoteBin1w 周行情数据
IndexBin1m 1分钟指数行情数据
IndexBin5m 5分钟指数行情数据
IndexBin30m 30分钟指数行情数据
IndexBin1h 1小时指数行情数据
IndexBin2h 2小时指数行情数据
IndexBin4h 4小时指数行情数据
IndexBin6h 6小时指数行情数据
IndexBin12h 12小时指数行情数据
IndexBin1d 日指数行情数据
IndexBin1w 周指数行情数据

备注

请求订阅命令,主题列表主题的构成方式为<主题:现货对的Code(区分大小写)>,例如需要订阅现货EOS/ETH的实时深度和5分钟行情的命令为

订阅数据格式,基本格式如下

{
"action":"subscribe",
"args":["Depth:EOS/ETH","QuoteBin5m:EOS/ETH"]
}

订阅数据格式,基本格式如下

{
  "group":"",
  "data":{
  }
}

订阅主题不同,data字段格式不同。data的具体以接口返回为准,请求输入对应主题的订阅命令获取

认证

订阅私有数据

订阅完成后(认证通过)就可以收到unicast主题的私有数据了,暂时只有一个unicast主题,所有私有数据都在这个主题返回

返回格式

{
    "action":"subscribe",
    "args":["unicast"]
}

unicast主题,返回的数据格式

{
    "group":"SUD",
    "data":[
        {
            "action":1, //操作类型
            "order":{   //订单信息

            },
            "s_assets":[  //现货资产列表

            ],
            "c_assets":{  //合约资产

            }
        }
    ]
}

"group":"SUD",表示该用户的的现货数据.以后台业务操作为驱动,推送用户数据的更新.一次推送可能包括多次业务操作,

所以data是以数组形式,从数组的头开始,按操作先后顺序存放的用户的一组操作.每组数据的元素包括:action(操作类型),

order(订单信息),s_assets(现货资产信息,注意是现货资产数组),c_assets(合约资产信息).对于订单信息,现货资产信息,

合约资产信息,只有当操作这些信息产生了更新,每组数据的元素才会包含该信息.

action:操作类型有

操作类型 可能产生的影响
1 撮合 订单更新,仓位更新,合约资产更新
2 提交订单 订单更新,合约资产更新
3 取消订单 订单更新,仓位更新,合约资产更新
11 从合约资产化出到现货资产 合约资产更新,现货资产更新
12 从现货资产化出到合约账户

心跳

服务端会每隔10秒发送一个PingFrame到客户端,正常情况下客户端均会回复一个PongFrame。如果服务端连续5个

PingFrame均没有收到应答。并且在此期间没有收到客户端的其他数据,服务端会主动断开链接。大部分浏览器收

到PingFrame后均会自动给以PongFrame应答,不需要业务层实现。服务端在业务层实现了一个PingMessage Handle

,收到PingMessage后会自动回复一个PongMessage,客户端底层如果没有办法处理websocket协议层的ping/pong

frame可以通过业务层的ping/pong message判断链接是否健康

具体消息如下

ping
{"action":"ping"}

pong
{
"group":"System",
"data":"pong"
}

测试

任何标准的Websocket客户端都可以用来测试,Chrome websocket测试插件 https://chrome.google.com/webstore/search/WebSocket%20Test%20Client?utm_source=chrome-ntp-icon

实时数据(WebSocket) curl --location --request GET "wss://api.bbx.com/v1/ifspot/realTime"

results matching ""

    No results matching ""