WebSocket Data formats - caoyezhouh/huobi GitHub Wiki

##3.数据格式 ###3.1请求地址 行情服务器地址：hq.huobi.com:80

###3.2行情接口介绍 ####1) 获取交易代码列表

reqSymbolList该接口主要获取交易代码列表以及基本信息。每一条信息只包含一条或者多条交易代码的基本信息。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取交易代码列表 version 必选 1 终端版本
msgType 必选 reqSymbolList 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolIdList 可选 [btccny,ltccny,btcusd] 交易代码列表，零到多个交易编码。如果为空，则返回所有的交易编码

实时行情服务器向终端回应消息格式如下：

接口名称 字段名称 是否可选 字段值 字段说明
获取交易代码列表 version 必选 1 终端版本
msgType 必选 reqSymbolList 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
retMsg 必选 成功 返回消息
payload 必选 有效数据

####2) 获取交易代码详细信息

reqSymbolDetail该接口主要在已知交易代码下，获取交易代码的详细信息。每一条信息只包含一条或者多条交易代码的详细信息。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取交易代码详细信息 version 必选 1 终端版本
msgType 必选 reqSymbolDetail 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolIdList 必选 [btccny,ltccny,btcusd] 交易代码列表，1个到多个交易编码
实时行情服务器向终端回应消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取交易代码详细信息 version 必选 1 终端版本
msgType 必选 reqSymbolDetail 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
retMsg 必选 成功 返回消息
payload 必选 有效数据

####3) 推送消息注册

reqMsgSubscribe该接口提供推送消息注册。消息以交易代码加上消息类型为基本单元。消息可以注册多次，以最后一次注册为准。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
推送消息注册 version 必选 1 终端版本
msgType 必选 reqMsgSubscribe 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolIdList 必选 {消息名称:[{"symbolId":数组,"pushType":数组,"period":k线周期数组,"percent":深度百分比数组}]} 需要推送的交易代码列表。一个或者多个交易编码。每一个推送请求包括“交易代码，消息类型，推送策略”
实时行情服务器向终端回应消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
推送消息注册 version 必选 1 终端版本
msgType 必选 reqMsgSubscribe 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
retMsg 必选 成功 返回消息

####4) 推送消息注销

reqMsgUnsubscribe该接口提供推送消息注销。消息以交易代码加上消息类型为基本单元。消息可以注册多次，只需要注销一次，对于短效消息，可以不显示取消，后注册的短效消息会覆盖之前的。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
推送消息注销 version 必选 1 终端版本
msgType 必选 reqMsgUnsubscribe 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolIdList 必选 {消息名称:[{"symbolId":数组,"period":k线周期数组,"percent":深度百分比数组}]} 需要注销推送的交易代码列表。一个或者多个交易编码。每一个推送请求包括“交易代码，消息类型，推送策略”
实时行情服务器向终端回应消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
推送消息注销 version 必选 1 终端版本
msgType 必选 reqMsgUnsubscribe 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
retMsg 必选 成功 返回消息

####5) 获取历史分时数据

reqTimeLine获取历史分时的数据，默认最近300条的时间区间。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取历史分时数据 version 必选 1 终端版本
msgType 必选 reqTimeLine 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolId 必选 btccny 交易代码列表，零到多个交易编码。
from 可选 开始时间，默认最近300条的时间区间。
to 可选 结束时间，默认到最新。
实时行情服务器向终端回应消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取历史分时数据 version 必选 1 终端版本
msgType 必选 reqTimeLine 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
retMsg 必选 成功 返回消息
payload 必选 有效数据

####6) 获取历史k线信息

reqKLine获取历史k线信息，默认最近300条的时间区间。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取历史k线信息 version 必选 1 终端版本
msgType 必选 reqKLine 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolId 必选 btccny 交易代码列表，1个到多个交易编码。
period 必选 K线类型
from 可选 开始时间，默认最近300条的时间区间。
to 可选 结束时间，默认到最新。当取值为-1时返回最近300条
实时行情服务器向终端回应消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取历史分时数据 version 必选 1 终端版本
msgType 必选 reqTimeLine 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
retMsg 必选 成功 返回消息
period 必选 k线类型
payload 必选 有效数据

####7) 获取Top行情深度

reqMarketDepthTop该消息用于获取完整的Top行情深度。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取Top行情深度 version 必选 1 终端版本
msgType 必选 reqMarketDepthTop 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolId 必选 btccny 交易代码列表，1个到多个交易编码。
实时行情服务器向终端回应消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取Top行情深度 version 必选 1 终端版本
msgType 必选 reqMarketDepthTop 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
retMsg 必选 成功 返回消息
version 可选 快照版本
payload 必选 有效数据

####8) 获取行情深度

reqMarketDepth该消息用于获取完整的行情深度。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取Top行情深度 version 必选 1 终端版本
msgType 必选 reqMarketDepthTop 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolId 必选 btccny 交易代码列表，1个到多个交易编码。
percent 必选 行情深度的百分比，缺省10%
实时行情服务器向终端回应消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取Top行情深度 version 必选 1 终端版本
msgType 必选 reqMarketDepthTop 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
version 可选 快照版本
payload 必选 有效数据

####9) 获取Top交易明细

reqTradeDetailTop该消息用于获取完整的行情深度。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取Top交易明细 version 必选 1 终端版本
msgType 必选 reqTradeDetailTop 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolId 必选 btccny 交易代码列表，1个到多个交易编码。
Count 可选 获取明细条数，缺省50条
实时行情服务器向终端回应消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取Top行情深度 version 必选 1 终端版本
msgType 必选 reqTradeDetailTop 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
retMsg 必选 返回消息
payload 必选 有效数据

####10) 获取盘口信息

reqMarketDetail该消息用于获取完整的行情深度。<br>
终端向实时行情服务器请求消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取盘口信息 version 必选 1 终端版本
msgType 必选 reqMarketDetail 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
symbolId 必选 btccny 交易代码列表，1个到多个交易编码。
实时行情服务器向终端回应消息格式如下：
接口名称 字段名称 是否可选 字段值 字段说明
获取盘口信息 version 必选 1 终端版本
msgType 必选 reqTradeDetailTop 消息类型
requestIndex 可选 100 请求序列号，方便判断多个请求的先后顺序，终端发送的数据，服务端会返回相同的数据
retCode 必选 200 返回错误码，200为成功，其他的参照http返回码
retMsg 必选 返回消息
payload 必选 有效数据

返回首页

English Documents click here

⚠️ **GitHub.com Fallback** ⚠️