订阅 Trade Detail 数据

market.$contract_code.trade.detail

是否验签: 否

接口权限: 读取

限频: 行情类的公开接口，比如：获取K线数据、获取聚合行情、市场行情、获取行情深度数据、获取溢价指数K线、获取实时预测资金费率k线，获取基差数据、获取市场最近成交记录： websocket：req请求，同一时刻最多请求50次；sub请求，无限制，服务器主动推送数据

接口描述: 该接口支持全仓模式和逐仓模式 请求参数contract_code支持交割合约代码，格式为BTC-USDT-210625；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。

订阅地址

环境	地址
线上环境	wss://api.sunx.io/ws/v1/market
线上环境（aws客户首选）	wss://api.sunx.io/ws/v1/market

请求参数

字段名称	类型	说明
无数据

规则说明

订阅(sub)	取消订阅(unsub)	规则
无数据

订阅参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	string	true	合约代码 或 合约标识	永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）

数据更新

参数	数据类型	是否必填	描述	取值范围
ch	string	true	数据所属的 channel，格式： market.$contract_code.trade.detail
ts	long	true	发送时间
<tick>		false
id	long	true	订单唯一id（品种唯一）
ts	long	true	tick数据戳
<data>		false
amount	decimal	true	数量（张）。 值是买卖双边之和
ts	long	true	订单时间戳
id	long	true	成交唯一id（品种唯一）
price	decimal	true	价格
direction	string	true	买卖方向，即taker(主动成交)的方向
quantity	decimal	true	成交量（币）
trade_turnover	decimal	true	成交额（计价币种）
</data>		false
</tick>		false

订阅示例

{
  "sub": "market.BTC-USDT.trade.detail",
  "id": "id7"
}

订阅成功示例

{
  "id": "id7",
  "status": "ok",
  "subbed": "market.BTC-USDT.trade.detail",
  "ts": 1489474081631
}

数据更新示例

{
  "ch": "market.BTC-USDT.trade.detail",
  "ts": 1603708208346,
  "tick": {
    "id": 131602265,
    "ts": 1603708208335,
    "data": [
      {
        "amount": 2,
        "ts": 1603708208335,
        "id": 1316022650000,
        "price": 13073.3,
        "direction": "buy",
        "quantity": 0.002,
        "trade_turnover": 26.334
      }
    ]
  }
}

取消订阅示例

{
  "unsub": "market.BTC-USDT.trade.detail",
  "id": "id7"
}