实时订阅/取消数据流

• 以下数据可以通过websocket发送以实现订阅或取消订阅数据流。示例如下。
• 响应内容中的id是无符号整数，作为往来信息的唯一标识。

订阅一个信息流

响应

{
  "result": null,
  "id": 1
}

• 请求

  {
  "method": "SUBSCRIBE",
  "params":
  [
  "btcusdt@aggTrade",
  "btcusdt@depth"
  ],
  "id": 1
  }

取消订阅一个信息流

响应

{
  "result": null,
  "id": 312
}

• 请求

  {
  "method": "UNSUBSCRIBE",
  "params":
  [
  "btcusdt@depth"
  ],
  "id": 312
  }

已订阅信息流

响应

{
  "result": [
    "btcusdt@aggTrade"
  ],
  "id": 3
}

• 请求

  {
  "method": "LIST_SUBSCRIPTIONS",
  "id": 3
  }

设定属性

当前，唯一可以设置的属性是设置是否启用combined("组合")信息流。
当使用/ws/("原始信息流")进行连接时，combined属性设置为false，而使用 /stream/进行连接时则将属性设置为true。

响应

{
  "result": null
  "id": 5
}

• 请求

  {
  "method": "SET_PROPERTY",
  "params":
  [
  "combined",
  true
  ],
  "id": 5
  }

检索属性

响应

{
  "result": true, // Indicates that combined is set to true.
  "id": 2
}

• 请求

  {
  "method": "GET_PROPERTY",
  "params":
  [
  "combined"
  ],
  "id": 2
  }

##错误信息

错误信息	描述
{"code": 0, "msg": "Unknown property"}	SET_PROPERTY 或 GET_PROPERTY中应用的参数无效
{"code": 1, "msg": "Invalid value type: expected Boolean"}	仅接受true或false
{"code": 2, "msg": "Invalid request: property name must be a string"}	提供的属性名无效
{"code": 2, "msg": "Invalid request: request ID must be an unsigned integer"}	参数id未提供或id值是无效类型
{"code": 2, "msg": "Invalid request: unknown variant %s, expected one of SUBSCRIBE, UNSUBSCRIBE, LIST_SUBSCRIPTIONS, SET_PROPERTY, GET_PROPERTY at line 1 column 28"}	错字提醒，或提供的值不是预期类型
{"code": 2, "msg": "Invalid request: too many parameters"}	数据中提供了不必要参数
{"code": 2, "msg": "Invalid request: property name must be a string"}	未提供属性名
{"code": 2, "msg": "Invalid request: missing field method at line 1 column 73"}	数据未提供method
{"code":3,"msg":"Invalid JSON: expected value at line %s column %s"}	JSON 语法有误.