主题

主题列表:

主题(这些主题列表是开放主题,不需要做ws认证) 描述
Trade 最新成交
PNL 自动减仓排名
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 周指数行情数据

备注

  • 除Ticker之外目前所有主题都跟合约ID相关

  • 请求订阅命令,主题列表主题的构成方式为<主题:合约ID>,例如需要订阅合约(2)的实时深度和5分钟行情

{
    "action":"subscribe",
    "args":["Depth:2","QuoteBin5m:2"]
}

认证

订阅私有数据

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

具体消息如下

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

unicast主题,返回的数据格式

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

            },
            "position":{ // 仓位信息

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

            },
            "s_assets":{  // 现货资产

            }
        }
    ]
}

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

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

action(操作类型),

order(订单信息),

position(仓位信息),

c_assets(合约资产信息),

s_assets(现货资产信息).

对于订单信息,仓位信息,合约资产信息,现货资产信息,只有当操作这些信息产生了更新,每组数据的元素才会包含该信息.

action:操作类型有

操作类型 可能产生的影响
1 撮合 订单更新,仓位更新,合约资产更新
2 提交订单 订单更新,合约资产更新
3 取消订单 订单更新,仓位更新,合约资产更新
4 强平取消订单 订单更新,仓位更新,合约资产更新
5 被动ADL取消订单 订单更新,仓位更新,合约资产更新
6 部分强平 订单更新,仓位更新,合约资产更新
7 破产委托 新增订单,仓位更新,合约资产更新
8 动ADL撮合成交 订单更新,仓位更新,合约资产更新
9 主动ADL撮合成交 订单更新,仓位更新,合约资产更新
10 从现货资产化入到合约资产 合约资产更新,现货资产更新
11 从合约资产化出到现货资产 合约资产更新,现货资产更新
12 追加保证金 仓位更新,合约资产更新
13 减少保证金 仓位更新,合约资产更新

心跳

服务端会每隔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 "ws://api.bbx.com/v1/ifcontract/realTime"

results matching ""

    No results matching ""