WebSocket服务连接地址:wss://real.okcoin.cn:10440/websocket/okcoinapi
发送请求

请求数据格式为:{'event':'addChannel','channel':'channelValue','parameters':{'api_key':'value1','sign':'value2'}}
其中event: addChannel(注册请求数据)/removeChannel(注销请求数据)
channel:OKCoin 提供请求数据类型
parameters 参数为选填参数,
binary 参数为选填参数,压缩数据: 1 压缩数据 ,0 原始数据 默认 0
其中api_key 为用户申请apiKey,sign 为签名字符串,签名规则参照请求说明
例如:websocket.send("{'event':'addChannel','channel':'ok_sub_spot_cny_btc_ticker','binary','1'}")
websocket.send("[{'event':'addChannel','channel':'ok_sub_spot_cny_btc_ticker'},{'event':'addChannel','channel':'ok_sub_spot_cny_btc_depth'},{'event':'addChannel','channel':'ok_sub_spot_cny_btc_trades'}]");支持批量注册。

服务器响应

返回数据格式为: [{"channel":"channel","success":"","errorcode":"","data":{}}, {"channel":"channel","success":"","errorcode":1,"data":{}}]
channel:请求的数据类型
result:true成功,false失败(用于WebSocket 交易API)
data:返回结果数据
errorcode:错误码(用于WebSocket 交易API)

错误代码 详细描述
10000 必填参数为空
10001 参数错误
10002 验证失败
10003 该连接已经请求了其他用户的实时交易数据
10004 该连接没有请求此用户的实时交易数据
10005 系统错误
10008 非法参数
10009 订单不存在
10010 余额不足
10011 卖的数量小于BTC/LTC最小买卖额度
10012 当前网站暂时只支持btc_usd ltc_usd
10014 下单价格不得≤0或≥1000000
10015 暂不支持此channel订阅
10016 币数量不足
10017 WebSocket鉴权失败
10100 用户被冻结
10049 小额委托(<0.15BTC)的未成交委托数量不得大于50个
10216 非开放API
20001 用户不存在
20002 用户被冻结
20003 用户被爆仓冻结
20004 合约账户被冻结
20005 用户合约账户不存在
20006 必填参数为空
20007 参数错误
20008 合约账户余额为空
20009 虚拟合约状态错误
20010 合约风险率信息不存在
20011 开仓前保证金率超过90%
20012 开仓后保证金率超过90%
20013 暂无对手价
20014 系统错误
20015 订单信息不存在
20016 平仓数量是否大于同方向可用持仓数量
20017 非本人操作
20018 下单价格高于前一分钟的105%或低于95%
20019 该IP限制不能请求该资源
20020 密钥不存在
20021 指数信息不存在
20022 接口调用错误
20023 逐仓用户
20024 sign签名不匹配
20025 杠杆比率错误
20100 请求超时
20101 数据格式无效
20102 登录无效
20103 数据事件类型无效
20104 数据订阅类型无效
20107 JSON格式错误
推送过程说明

为保证推送的及时性及减少流量,行情数据(ticker)和委托深度(depth)这两种数据类型只会在数据发生变化的情况下才会推送数据,交易记录(trades)是推送从上次推送到本次推送产生的增量数据。

如何判断连接是否断开?

OKCoin通过心跳机制解决这个问题。客户端每30秒发送一次心跳数据:{'event':'ping'},服务器会响应客户端:{"event":"pong"}以此来表明客户端和服务端保持正常连接。如果客户端未接到服务端响应的心跳数据则需要客户端重新建立连接。

提示

请先登录

客服400-888-6636
在线咨询 在线咨询
在线留言 发起提问
聊天室
OKCoin聊天室
请遵守聊天室规则!详情>>
客服400-888-6636
聊天室规则 X