Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
Websocket
公共频道
    行情K线深度平台成交RPI深度公共强平产品信息OI限仓仓位档位资金费率杠杆借币保证金信息
私有频道
Reality
SBE
公共频道

仓位档位

描述

推送交易对仓位档位的变更。当仓位档位的最大或最小价值发生变化时,本频道会推送含新档位数据的消息。订阅成功后会立即推送一次当前仓位档位的全量快照。

Code
{ "op": "subscribe", "args": [ { "instType": "usdt-futures", "topic": "position-tier", "symbol": "BTCUSDT" } ] }

请求参数

参数名类型是否必传描述
opString是操作
subscribe 订阅
unsubscribe 取消订阅
argsList<Object>是请求订阅的频道列表
> instTypeString是产品线类型
usdt-futures USDT合约
coin-futures 币本位合约
usdc-futures USDC合约
> topicString是频道名
position-tier 仓位档位频道
> symbolString是交易对名称
如 BTCUSDT
Code
{ "event": "subscribe", "arg": { "instType": "usdt-futures", "topic": "position-tier", "symbol": "BTCUSDT" }, "connId": "xxxxxxxxxx" }

返回参数

参数名类型描述
eventString事件
argObject请求订阅的频道列表
> instTypeString产品线类型
usdt-futures USDT合约
coin-futures 币本位合约
usdc-futures USDC合约
> topicString频道名
position-tier 仓位档位频道
> symbolString交易对名称
如 BTCUSDT
codeString错误码
msgString错误信息
connIdString连接ID
Code
{ "data": [ { "symbol": "BTCUSDT", "list": [ { "tier": "1", "leverage": "125", "minTierValue": "0", "maxTierValue": "50000", "mmr": "0.004" }, { "tier": "2", "leverage": "100", "minTierValue": "50000", "maxTierValue": "250000", "mmr": "0.005" } ] } ], "arg": { "instType": "usdt-futures", "topic": "position-tier", "symbol": "BTCUSDT" }, "action": "snapshot", "ts": 1736371332162 }

推送参数

参数名参数类型描述
argObject请求订阅成功的频道列表
> instTypeString产品线类型
usdt-futures USDT合约
coin-futures 币本位合约
usdc-futures USDC合约
> topicString频道名
position-tier 仓位档位频道
> symbolString交易对名称
如 BTCUSDT
actionString推送数据的方式
snapshot 全量
update 增量
dataList<Object>订阅的数据
> symbolString交易对名称
> listList<Object>档位列表
>> tierString档位
>> leverageString有效杠杆倍数
>> minTierValueString当前档位最小价值
>> maxTierValueString当前档位最大价值
>> mmrString维持保证金率
持仓档位对应的数值。当仓位的保证金率小于维持保证金率时,将会触发强制减仓或爆仓
OI限仓资金费率
JSON
JSON
JSON