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

OI限仓

描述

推送交易对单用户持仓限额(OI 限仓)的变更。限仓额度发生变更时,本频道会推送含新值的消息。订阅成功后会立即推送一次当前限额的全量快照。

股票合约的 OI 限仓与 crypto 合约不同:单 UID 最高支持到 20%,单用户(主账户+子账户)最高支持到 40%。

Code
{ "op": "subscribe", "args": [ { "instType": "usdt-futures", "topic": "open-interest-limit", "symbol": "BTCUSDT" } ] }

请求参数

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

返回参数

参数名类型描述
eventString事件
argObject请求订阅的频道列表
> instTypeString产品线类型
usdt-futures USDT合约
coin-futures 币本位合约
usdc-futures USDC合约
> topicString频道名
open-interest-limit 合约OI限仓频道
> symbolString交易对名称
如 BTCUSDT
codeString错误码
msgString错误信息
connIdString连接ID
Code
{ "data": [ { "symbol": "BTCUSDT", "notionalValue": "1000000", "singlePositionRatio": "0.1", "totalNotionalValue": "5000000", "totalPositionRatio": "0.2" } ], "arg": { "instType": "usdt-futures", "topic": "open-interest-limit", "symbol": "BTCUSDT" }, "action": "snapshot", "ts": 1736371332162 }

推送参数

参数名参数类型描述
argObject请求订阅成功的频道列表
> instTypeString产品线类型
usdt-futures USDT合约
coin-futures 币本位合约
usdc-futures USDC合约
> topicString频道名
open-interest-limit 合约OI限仓频道
> symbolString交易对名称
如 BTCUSDT
actionString推送数据的方式
snapshot 全量
update 增量
dataList<Object>订阅的数据
> symbolString交易对名称,变化后推送
> notionalValueString单用户持仓名义价值,变化后推送
> singlePositionRatioString单 UID 合约持仓占比,变化后推送
小数形式返回,如 0.1 代表 10%
> totalNotionalValueString子母账户持仓名义价值,变化后推送
> totalPositionRatioString子母账户合约持仓占比,变化后推送
小数形式返回,如 0.1 代表 10%
产品信息仓位档位
JSON
JSON
JSON