# 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.

<div className="api-aligning">

```json title="Request Example"
{
    "op": "subscribe",
    "args": [
        {
            "instType": "usdt-futures",
            "topic": "position-tier",
            "symbol": "BTCUSDT"
        }
    ]
}
```

### Request Parameters

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

</div>

<div className="api-br-10"></div>

<div className="api-aligning">

```json title="Response Example"
{
  "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                                                                                                  |
| &gt; instType | String | Product type<br/>`usdt-futures` USDT futures <br/> `coin-futures` Coin-M futures <br/> `usdc-futures` USDC futures |
| &gt; topic    | String | Topic <br/> `position-tier` Position tier channel                                                                  |
| &gt; symbol   | String | Trading pair <br/> e.g. `BTCUSDT`                                                                                  |
| code          | String | Error code                                                                                                           |
| msg           | String | Error message                                                                                                       |
| connId        | String | Connection ID                                                                                                        |

</div>

<div className="api-br-10"></div>

<div className="api-aligning">

```json title="Push Data"
{
  "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                                                                                       |
| &gt; instType | String             | Product type<br/>`usdt-futures` USDT futures <br/> `coin-futures` Coin-M futures <br/> `usdc-futures` USDC futures |
| &gt; topic    | String             | Topic <br/> `position-tier` Position tier channel                                                                  |
| &gt; symbol   | String             | Trading pair <br/> e.g. `BTCUSDT`                                                                                  |
| action        | String             | Data push action <br/> `snapshot` Full data <br/> `update` Incremental data                                        |
| data          | List&lt;Object&gt; | Subscribed data                                                                                                     |
| &gt; symbol   | String             | Trading pair name                                                                                                   |
| &gt; list     | List&lt;Object&gt; | Position tier list                                                                                                   |
| &gt;&gt; tier         | String     | Tier                                                                                                                 |
| &gt;&gt; leverage     | String     | Effective leverage                                                                                                   |
| &gt;&gt; minTierValue | String     | Minimum value of the current tier                                                                                   |
| &gt;&gt; maxTierValue | String     | Maximum value of the current tier                                                                                   |
| &gt;&gt; mmr          | String     | Maintenance margin rate <br/> Value corresponding to the position tier. A forced reduction or liquidation is triggered when the position's margin rate falls below this value |

</div>