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

行情频道

描述

获取产品的最新成交价、买一价、卖一价和24小时交易量等信息,有变化(成交、买一卖一发)时:300ms 至 400ms

Code
{ "op": "subscribe", "args": [ { "instType": "USDT-FUTURES", "channel": "ticker", "instId": "BTCUSDT" } ] }

请求参数

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

返回参数

返回字段参数类型字段说明
eventString事件
argObject订阅的频道
> instTypeString产品类型
> channelString频道名
> instIdString产品ID
如:ETHUSDT
codeString错误码
msgString错误消息
Code
{ "data": [ { "lastPr": "87673.6", "symbol": "BTCUSDT", "indexPrice": "87714.0732915359034044", "open24h": "87027.0", "nextFundingTime": "1766678400000", "bidPr": "87673.6", "change24h": "0.00743", "quoteVolume": "1521198076.61216", "deliveryPrice": "0", "askSz": "14.333", "low24h": "86542.5", "symbolType": "1", "openUtc": "87628.9", "instId": "BTCUSDT", "bidSz": "6.9129", "markPrice": "87673.7", "high24h": "88022.1", "askPr": "87673.7", "holdingAmount": "28135.5456", "baseVolume": "17398.1612", "fundingRate": "0.000055", "ts": "1766674540816" } ], "arg": { "instType": "USDT-FUTURES", "instId": "BTCUSDT", "channel": "ticker" }, "action": "snapshot", "ts": 1766674540817 }

推送数据参数

返回字段参数类型字段说明
argObject订阅成功的频道
> instTypeString产品类型
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
> channelString频道名
> instIdString产品ID
actionString推送数据动作,snapshot 全量推送数据
dataList订阅的数据
>instIdString产品ID
>lastPrString最新成交价
>askPrString卖一价
>bidPrString买一价
>high24hString24小时最高价
>low24hString24小时最低价
>change24hString24小时涨跌幅
>fundingRateString资金费率
>nextFundingTimeString下次资金费率结算时间, Unix时间戳的毫秒数格式,如 1597026383085
>tsString系统时间, 当前数据时间戳 Unix时间戳的毫秒数格式,如 1597026383085
>markPriceString标记价格
>indexPriceString指数价格
>holdingAmountString持仓量
>baseVolumeString交易币交易量
>quoteVolumeString计价币交易额
>openUtcStringUTC 00:00时刻价格
>symbolTypeStringSymbolType:1->永续 2->交割
>symbolString交易对
>deliveryPriceString交割合约交割价,symbolType=1(永续)时为0
交割合约前一小时推送该字段
交割价不存在则返回空
>bidSzString买一量
>askSzString卖一量
>open24hString开盘价 24小时。 开盘时间为24小时相对比,即:现在为2号19点,那么开盘时间对应为1号19点。
tsString数据推送时间
介绍K线频道
JSON
JSON
JSON