公共频道
OI限仓
描述
推送交易对单用户持仓限额(OI 限仓)的变更。限仓额度发生变更时,本频道会推送含新值的消息。订阅成功后会立即推送一次当前限额的全量快照。
股票合约的 OI 限仓与 crypto 合约不同:单 UID 最高支持到 20%,单用户(主账户+子账户)最高支持到 40%。
Code
请求参数
| 参数名 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| op | String | 是 | 操作 subscribe 订阅 unsubscribe 取消订阅 |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > instType | String | 是 | 产品线类型usdt-futures USDT合约 coin-futures 币本位合约 usdc-futures USDC合约 |
| > topic | String | 是 | 频道名 open-interest-limit 合约OI限仓频道 |
| > symbol | String | 是 | 交易对名称 如 BTCUSDT |
Code
返回参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| event | String | 事件 |
| arg | Object | 请求订阅的频道列表 |
| > instType | String | 产品线类型usdt-futures USDT合约 coin-futures 币本位合约 usdc-futures USDC合约 |
| > topic | String | 频道名 open-interest-limit 合约OI限仓频道 |
| > symbol | String | 交易对名称 如 BTCUSDT |
| code | String | 错误码 |
| msg | String | 错误信息 |
| connId | String | 连接ID |
Code
推送参数
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| arg | Object | 请求订阅成功的频道列表 |
| > instType | String | 产品线类型usdt-futures USDT合约 coin-futures 币本位合约 usdc-futures USDC合约 |
| > topic | String | 频道名 open-interest-limit 合约OI限仓频道 |
| > symbol | String | 交易对名称 如 BTCUSDT |
| action | String | 推送数据的方式 snapshot 全量 update 增量 |
| data | List<Object> | 订阅的数据 |
| > symbol | String | 交易对名称,变化后推送 |
| > notionalValue | String | 单用户持仓名义价值,变化后推送 |
| > singlePositionRatio | String | 单 UID 合约持仓占比,变化后推送 小数形式返回,如 0.1 代表 10% |
| > totalNotionalValue | String | 子母账户持仓名义价值,变化后推送 |
| > totalPositionRatio | String | 子母账户合约持仓占比,变化后推送 小数形式返回,如 0.1 代表 10% |
