Public

Position Tier Channel

Description

Push position tier changes for a trading pair. When the minimum or maximum value of a position tier changes, this channel pushes a message containing the new tier data. A full snapshot of the current position tiers is pushed immediately after a successful subscription.


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

Request Parameters

Parameters	Type	Required	Description
op	String	Yes	Operation `subscribe` Subscribe `unsubscribe` Unsubscribe
args	List<Object>	Yes	Subscribed channel
> instType	String	Yes	Product type `usdt-futures` USDT futures `coin-futures` Coin-M futures `usdc-futures` USDC futures
> topic	String	Yes	Topic `position-tier` Position tier channel
> symbol	String	Yes	Trading pair e.g. `BTCUSDT`


Code
{
  "event": "subscribe",
  "arg": {
    "instType": "usdt-futures",
    "topic": "position-tier",
    "symbol": "BTCUSDT"
  },
  "connId": "xxxxxxxxxx"
}

Response Parameters

Parameters	Type	Description
event	String	Event
arg	Object	Subscribed channel
> instType	String	Product type `usdt-futures` USDT futures `coin-futures` Coin-M futures `usdc-futures` USDC futures
> topic	String	Topic `position-tier` Position tier channel
> symbol	String	Trading pair e.g. `BTCUSDT`
code	String	Error code
msg	String	Error message
connId	String	Connection 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
}

Push Parameters

Parameters	Parameter Type	Description
arg	Object	Subscribed successful channel
> instType	String	Product type `usdt-futures` USDT futures `coin-futures` Coin-M futures `usdc-futures` USDC futures
> topic	String	Topic `position-tier` Position tier channel
> symbol	String	Trading pair e.g. `BTCUSDT`
action	String	Data push action `snapshot` Full data `update` Incremental data
data	List<Object>	Subscribed data
> symbol	String	Trading pair name
> list	List<Object>	Position tier list
>> tier	String	Tier
>> leverage	String	Effective leverage
>> minTierValue	String	Minimum value of the current tier
>> maxTierValue	String	Maximum value of the current tier
>> mmr	String	Maintenance margin rate Value corresponding to the position tier. A forced reduction or liquidation is triggered when the position's margin rate falls below this value

Open Interest Limit Channel Funding Rate Channel

Parameters

Type

Required

Description

String

Yes

Operation
subscribe Subscribe
unsubscribe Unsubscribe

args

List<Object>

Yes

Subscribed channel

> instType

String

Yes

Product type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures

> topic

String

Yes

Topic
position-tier Position tier channel

> symbol

String

Yes

Trading pair
e.g. BTCUSDT

Parameters

Type

Description

event

String

Event

arg

Object

Subscribed channel

> instType

String

Product type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures

> topic

String

Topic
position-tier Position tier channel

> symbol

String

Trading pair
e.g. BTCUSDT

code

String

Error code

msg

String

Error message

connId

String

Connection ID

{
  "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
}

Parameters

Parameter Type

Description

arg

Object

Subscribed successful channel

> instType

String

Product type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures

> topic

String

Topic
position-tier Position tier channel

> symbol

String

Trading pair
e.g. BTCUSDT

action

String

Data push action
snapshot Full data
update Incremental data

data

List<Object>

Subscribed data

> symbol

String

Trading pair name

> list

List<Object>

Position tier list

>> tier

String

Tier

>> leverage

String

Effective leverage

>> minTierValue

String

Minimum value of the current tier

>> maxTierValue

String

Maximum value of the current tier

>> mmr

String

Maintenance margin rate
Value corresponding to the position tier. A forced reduction or liquidation is triggered when the position's margin rate falls below this value