Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
Websocket
介绍
合约
现货
    公共频道
      行情频道K线频道深度频道集合竞价信息频道交易频道
    私有频道
杠杆
公共频道

深度频道

描述

获取深度数据频道
books,books5,books15默认推送频率:200ms
books1默认推送频率: 10ms

  • books 对应全量深度数据,首次推送全量数据:snapshot,后续推送增量变化数据:update。
  • books1 对应1档位深度数据,每次推送:snapshot。
  • books5 对应5档位深度数据,每次推送:snapshot。
  • books15 对应15档位深度数据,每次推送:snapshot。

seq说明

  • update增量消息的seq在除币对维护的情况是递增的
Code
{ "op": "subscribe", "args": [ { "instType": "SPOT", "channel": "books5", "instId": "BTCUSDT" } ] }

请求参数

参数名参数类型是否必须描述
opString是操作,subscribe unsubscribe
argsList<Object>是请求订阅的频道列表
> instTypeString是产品线类型
> channelString是频道名: books/books1/books5/books15
> instIdString是产品id 例如:ETHUSDT
Code
{ "event": "subscribe", "arg": { "instType": "SPOT", "channel": "books5", "instId": "BTCUSDT" } }

返回参数

返回字段参数类型字段说明
eventString事件,subscribe unsubscribe error
argObject订阅的频道
> instTypeString产品类型
> channelString频道名: books/books1/books5/books15
> instIdString是
产品id 例如:ETHUSDT
codeString错误码,错误时才会返回
msgString错误消息
Code
{ "action": "snapshot", "arg": { "instType": "SPOT", "channel": "books5", "instId": "BTCUSDT" }, "data": [ { "asks": [ [ "26274.9", "0.0009" ], [ "26275.0", "0.0500" ] ], "bids": [ [ "26274.8", "0.0009" ], [ "26274.7", "0.0027" ] ], "seq": 123, "ts": "1695710946294" } ], "ts": 1695710946294 }

推送数据参数

返回字段参数类型字段说明
argObject订阅成功的频道
> instTypeString产品类型
> channelString频道名: books/books1/books5/books15
> instIdString产品id 例如:ETHUSDT
actionString推送数据动作
snapshot: 全量数据推送
update: 增量数据推送
dataList<Object>订阅的数据
> instIdString产品id 例如:ETHUSDT
> asksList<String>卖方深度
> bidsList<String>买方深度
> tsString撮合引擎时间戳,Unix时间戳的毫秒数格式,如 1597026383085
> seqLong序列号
订单簿更新时递增,可以用来判断是否乱序
K线频道集合竞价信息频道
JSON
JSON
JSON