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
Request Parameters
| Parameters | Type | Required | Description |
|---|---|---|---|
| op | String | Yes | Operation subscribe Subscribe unsubscribe Unsubscribe |
| args | List<Object> | Yes | Subscribed channel |
| > instType | String | Yes | Product typeusdt-futures USDT futures coin-futures Coin-M futures usdc-futures USDC futures |
| > topic | String | Yes | Topic open-interest-limit Open interest limit channel |
| > symbol | String | Yes | Trading pair e.g. BTCUSDT |
Code
Response Parameters
| Parameters | Type | Description |
|---|---|---|
| event | String | Event |
| arg | Object | Subscribed channel |
| > instType | String | Product typeusdt-futures USDT futures coin-futures Coin-M futures usdc-futures USDC futures |
| > topic | String | Topic open-interest-limit Open interest limit channel |
| > symbol | String | Trading pair e.g. BTCUSDT |
| code | String | Error code |
| msg | String | Error message |
| connId | String | Connection ID |
Code
Push Parameters
| Parameters | Parameter Type | Description |
|---|---|---|
| arg | Object | Subscribed successful channel |
| > instType | String | Product typeusdt-futures USDT futures coin-futures Coin-M futures usdc-futures USDC futures |
| > topic | String | Topic open-interest-limit Open interest limit 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, pushed on change |
| > notionalValue | String | Individual user position notional value, pushed on change |
| > singlePositionRatio | String | Single UID contract position ratio, pushed on change Returned as a decimal, e.g. 0.1 represents 10% |
| > totalNotionalValue | String | Master/sub-account position notional value, pushed on change |
| > totalPositionRatio | String | Master/sub-account contract position ratio, pushed on change Returned as a decimal, e.g. 0.1 represents 10% |
