# 产品信息
### 描述
推送交易对的交易参数与状态变更。当交易参数发生变化（如限价比例、价差保护、下单价格/数量精度等）或交易对状态发生变化（如上线、下线、维护等）时，本频道会推送含新值的消息。
订阅后，交易参数变化后推送，建议用户先通过REST获取全量信息后订阅该频道接收变化信息；
```json title="请求示例"
{
"op": "subscribe",
"args": [
{
"instType": "usdt-futures",
"topic": "instruments"
}
]
}
```
### 请求参数
| 参数名 | 类型 | 是否必传 | 描述 |
|---------------|--------------------|------|----------------------------------------------------------------------------------------------------------------------|
| op | String | 是 | 操作
`subscribe` 订阅
`unsubscribe` 取消订阅 |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > instType | String | 是 | 产品线类型
`spot` 现货交易
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 是 | 频道名
`instruments` 产品信息频道 |
```json title="返回示例"
{
"event": "subscribe",
"arg": {
"instType": "usdt-futures",
"topic": "instruments"
},
"connId": "xxxxxxxxxx"
}
```
### 返回参数
| 参数名 | 类型 | 描述 |
|---------------|--------|------------------------------------------------------------------------------------------------------------------------|
| event | String | 事件 |
| arg | Object | 请求订阅的频道列表 |
| > instType | String | 产品线类型
`spot` 现货交易
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 频道名
`instruments` 产品信息频道 |
| code | String | 错误码 |
| msg | String | 错误信息 |
| connId | String | 连接ID |
```json title="推送数据"
{
"data": [
{
"baseCoin": "BTC",
"quoteCoin": "USDT",
"buyLimitPriceRatio": "0.05",
"sellLimitPriceRatio": "0.05",
"marketPriceRatio": "0.05",
"priceProtectThreshold": "0.1",
"feeRateUpRatio": "0.01",
"openCostUpRatio": "0.01",
"minOrderQty": "0.001",
"maxOrderQty": "1000",
"minOrderAmount": "5",
"maxMarketOrderQty": "500",
"pricePrecision": "2",
"quantityPrecision": "3",
"quotePrecision": "4",
"priceMultiplier": "0.01",
"quantityMultiplier": "0.001",
"type": "perpetual",
"status": "online",
"openTime": "1700000000000",
"offTime": "",
"limitOpenTime": ""
}
],
"arg": {
"instType": "usdt-futures",
"topic": "instruments"
},
"action": "snapshot",
"ts": 1736371332162
}
```
### 推送参数
| 参数名 | 参数类型 | 描述 |
|---------------|--------------------|------------------------------------------------------------------------------------------------------------------------|
| arg | Object | 请求订阅成功的频道列表 |
| > instType | String | 产品线类型
`spot` 现货交易
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 频道名
`instruments` 产品信息频道 |
| action | String | 推送数据的方式
`snapshot` 全量
`update` 增量 |
| data | List<Object> | 订阅的数据 |
| > baseCoin | String | 交易币种
如 `BTCUSDT` 中的 `BTC` |
| > quoteCoin | String | 计价币种
如 `BTCUSDT` 中的 `USDT` |
| > buyLimitPriceRatio | String | 买价限价比例
买入限价与市场价格的比率，决定买单下单时的最高价格 |
| > sellLimitPriceRatio | String | 卖价限价比例
卖出限价与市场价格的比率，决定卖单下单时的最低价格 |
| > marketPriceRatio | String | 市价比例
买卖市价与市场价格的比率，决定下单时的价格范围 |
| > priceProtectThreshold | String | 止盈止损价差保护阈值
止盈止损触发价与最新/标记价格的最大允许偏差比例
小数形式，如 `0.1` 代表 10% |
| > feeRateUpRatio | String | 手续费上浮比例
实际费用相对于基础费用增加的百分比 |
| > openCostUpRatio | String | 开仓成本上浮比例
开仓的成本相对于基础或标准成本增加的百分比 |
| > minOrderQty | String | 限价最小下单数量
以基础币种下单时允许的最小数量 |
| > maxOrderQty | String | 限价最大下单数量
以基础币种下单时允许的最大数量
为 `0` 表示不限制 |
| > minOrderAmount | String | 限价最小下单金额
以计价币种下单时允许的最小数量 |
| > maxMarketOrderQty | String | 市价最大下单数量
以基础币种下单时允许的最大数量 |
| > pricePrecision | String | 价格精度
价格允许的小数位数
下单时，填写的价格必须是价格精度的整数倍 |
| > quantityPrecision | String | 数量精度
数量允许的小数位数
下单时，填写的数量必须是数量精度的整数倍 |
| > quotePrecision | String | 市价下单精度
计价币价格允许的小数位数 |
| > priceMultiplier | String | 价格乘数
配合 `pricePrecision`。如 `pricePrecision=2`、`priceMultiplier=0.01`，则委托价格要满足 `priceMultiplier` 的倍数，并且小数位是 2 |
| > quantityMultiplier | String | 数量乘数
合约下单使用，配合 `quantityPrecision`。如 `quantityPrecision=2`、`quantityMultiplier=0.01`，则委托数量要满足 `quantityMultiplier` 的倍数，并且小数位是 2 |
| > type | String | 合约类型
`perpetual` 永续
`delivery` 交割 |
| > status | String | 交易对状态
`listed` 上架(未开盘)
`online` 正常交易/开盘
`limit_open` 合约禁止开仓
`limit_close` 合约禁止平仓，现货停盘
`offline` 下架/维护 |
| > openTime | String | 开盘时间
Unix毫秒时间戳 |
| > offTime | String | 停盘时间
未配置则返回 `""`
只支持合约 |
| > limitOpenTime | String | 限制开仓时间
其它值表示 symbol 正在/计划维护，指定时间后禁止交易
未配置则返回 `""` |