产品信息

Code
{
    "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 产品信息频道

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

Code
{
  "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 正在/计划维护，指定时间后禁止交易 未配置则返回 ""