Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Websocket
Public
    Tickers ChannelCandlestick ChannelDepth ChannelPublic Trades ChannelRPI Depth ChannelLiquidation ChannelInstruments ChannelOpen Interest Limit ChannelPosition Tier ChannelFunding Rate ChannelMargin Loan ChannelMargin Coins Channel
Private
Reality
SBE
Public

Open Interest Limit Channel

Description

Push changes to the single-user open interest (OI) limit for a trading pair. When the OI limit quota changes, this channel pushes a message containing the new values. A full snapshot of the current limit is pushed immediately after a successful subscription.

For stock contracts, the OI limit differs from crypto contracts: the single-UID limit can be up to 20%, and the single-user (master + sub-accounts) limit can be up to 40%.

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

Request Parameters

ParametersTypeRequiredDescription
opStringYesOperation
subscribe Subscribe
unsubscribe Unsubscribe
argsList<Object>YesSubscribed channel
> instTypeStringYesProduct type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures
> topicStringYesTopic
open-interest-limit Open interest limit channel
> symbolStringYesTrading pair
e.g. BTCUSDT
Code
{ "event": "subscribe", "arg": { "instType": "usdt-futures", "topic": "open-interest-limit", "symbol": "BTCUSDT" }, "connId": "xxxxxxxxxx" }

Response Parameters

ParametersTypeDescription
eventStringEvent
argObjectSubscribed channel
> instTypeStringProduct type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures
> topicStringTopic
open-interest-limit Open interest limit channel
> symbolStringTrading pair
e.g. BTCUSDT
codeStringError code
msgStringError message
connIdStringConnection 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 }

Push Parameters

ParametersParameter TypeDescription
argObjectSubscribed successful channel
> instTypeStringProduct type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures
> topicStringTopic
open-interest-limit Open interest limit channel
> symbolStringTrading pair
e.g. BTCUSDT
actionStringData push action
snapshot Full data
update Incremental data
dataList<Object>Subscribed data
> symbolStringTrading pair name, pushed on change
> notionalValueStringIndividual user position notional value, pushed on change
> singlePositionRatioStringSingle UID contract position ratio, pushed on change
Returned as a decimal, e.g. 0.1 represents 10%
> totalNotionalValueStringMaster/sub-account position notional value, pushed on change
> totalPositionRatioStringMaster/sub-account contract position ratio, pushed on change
Returned as a decimal, e.g. 0.1 represents 10%
Instruments ChannelPosition Tier Channel
JSON
JSON
JSON