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

深度频道

描述

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

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

seq说明

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

请求参数

参数名参数类型是否必须描述
opString是操作, subscribe unsubscribe
argsList<Object>是请求订阅的频道列表
> instTypeString是产品类型
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
> channelString是频道名: books/books1/books5/books15
> instIdString是产品ID
Code
{ "event": "subscribe", "arg": { "instType": "USDT-FUTURES", "channel": "books5", "instId": "BTCUSDT" } }

返回参数

返回字段参数类型字段说明
eventString事件
argObject订阅的频道
> instTypeString产品类型
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
> channelString频道名: books/books1/books5/books15
> instIdString产品ID
msgString错误消息
codeString错误码
Code
{ "action": "snapshot", "arg": { "instType": "USDT-FUTURES", "channel": "books5", "instId": "BTCUSDT" }, "data": [ { "asks": [ [ "27002.0", "5.070" ], [ "27002.5", "1.470" ] ], "bids": [ [ "26998.5", "6.620" ], [ "26998.0", "7.510" ] ], "seq": 123, "pseq": 122, "ts": 1695716059516 } ], "ts": "1695716059516" }

推送数据参数

返回字段参数类型字段说明
argObject订阅成功的频道
> instTypeString产品类型
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
> channelString频道名: books/books1/books5/books15
> instIdString产品ID
actionString推送数据动作, 增量推送数据还是全量推送数据
dataList<Object>订阅的数据
> asksList<String>卖方深度
> bidsList<String>买方深度
> tsString撮合引擎时间戳,Unix时间戳的毫秒数格式,如 1597026383085
> seqLong序列号
订单簿更新时递增,可以用来判断是否乱序
> pseqString上次推送序列号
books 频道:推送增量变化数据时有值且非0;books1、books5、books15 频道:固定返回 0。可用来判断是否丢包
tsString数据推送时间
K线频道平台成交详情频道
JSON
JSON
JSON