.. role:: strike :class: strike .. role:: red-strengthen :class: red-strengthen 行情协议 ========== 这里对FutuOpenD开放的行情协议接口作出归档说明。 .. note:: * 为避免增删导致的版本兼容问题，所有enum枚举类型只用于值的定义，在protobuf结构体中声明类型时使用int32类型 * 所有类型定义使用protobuf格式声明，不同语言对接时请自行通过相关工具转换成对应的头文件 * XXX.proto表示协议文件名, 点击超链接可打开github上的协议文件，每条协议内容以github上的为准，此文档更新可能存在滞后 -------------- `Qot_Sub.proto `_ - 3001订阅或者反订阅 --------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_Sub; import "Common.proto"; import "Qot_Common.proto"; message C2S { repeated Qot_Common.Security securityList = 1; //股票 repeated int32 subTypeList = 2; //Qot_Common.SubType,订阅数据类型 required bool isSubOrUnSub = 3; //ture表示订阅,false表示反订阅 optional bool isRegOrUnRegPush = 4; //是否注册或反注册该连接上面行情的推送,该参数不指定不做注册反注册操作 repeated int32 regPushRehabTypeList = 5; //Qot_Common.RehabType,复权类型,注册推送并且是K线类型才生效,其他订阅类型忽略该参数,注册K线推送时该参数不指定默认前复权 optional bool isFirstPush = 6; //注册后如果本地已有数据是否首推一次已存在数据,该参数不指定则默认true optional bool isUnsubAll = 7; //一键取消当前连接的所有订阅,当被设置为True时忽略其他参数。 } message S2C { } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 订阅数据类型参考 `SubType `_ * 复权类型参考 `RehabType `_ * 为控制定阅产生推送数据流量，股票定阅总量有额度控制，订阅规则参考 `高频数据接口 <../api/Quote_API.html#id32>`_ * 高频数据接口需要订阅之后才能使用，注册推送之后才可以收到数据更新推送 ------------------------------------- `Qot_RegQotPush.proto `_ - 3002注册行情推送 ------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_RegQotPush; import "Common.proto"; import "Qot_Common.proto"; message C2S { repeated Qot_Common.Security securityList = 1; //股票 repeated int32 subTypeList = 2; //Qot_Common.SubType,要注册到该连接的订阅类型 repeated int32 rehabTypeList = 3; //Qot_Common.RehabType,复权类型,注册K线类型才生效,其他订阅类型忽略该参数,注册K线时该参数不指定默认前复权 required bool isRegOrUnReg = 4; //注册或取消 optional bool isFirstPush = 5; //注册后如果本地已有数据是否首推一次已存在数据,该参数不指定则默认true } message S2C { } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 订阅数据类型参考 `SubType `_ * 复权类型参考 `RehabType `_ * 行情需要订阅成功才能注册推送 ------------------------------------- `Qot_GetSubInfo.proto `_ - 3003获取订阅信息 --------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetSubInfo; import "Common.proto"; import "Qot_Common.proto"; message C2S { optional bool isReqAllConn = 1; //是否返回所有连接的订阅状态,不传或者传false只返回当前连接数据 } message S2C { repeated Qot_Common.ConnSubInfo connSubInfoList = 1; //订阅订阅信息 required int32 totalUsedQuota = 2; //FutuOpenD已使用的订阅额度 required int32 remainQuota = 3; //FutuOpenD剩余订阅额度 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 订阅信息结构参考 `ConnSubInfo `_ ------------------------------------- `Qot_GetBasicQot.proto `_ - 3004获取股票基本行情 --------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetBasicQot; import "Common.proto"; import "Qot_Common.proto"; message C2S { repeated Qot_Common.Security securityList = 1; //股票 } message S2C { repeated Qot_Common.BasicQot basicQotList = 1; //股票基本报价 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 基本报价结构参考 `BasicQot `_ ------------------------------------- `Qot_UpdateBasicQot.proto `_ - 3005推送股票基本报价 ------------------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_UpdateBasicQot; import "Common.proto"; import "Qot_Common.proto"; message S2C { repeated Qot_Common.BasicQot basicQotList = 1; //股票基本行情 } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 基本报价结构参考 `BasicQot `_ ------------------------------------- `Qot_GetKL.proto `_ - 3006获取K线 ------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetKL; import "Common.proto"; import "Qot_Common.proto"; message C2S { required int32 rehabType = 1; //Qot_Common.RehabType,复权类型 required int32 klType = 2; //Qot_Common.KLType,K线类型 required Qot_Common.Security security = 3; //股票 required int32 reqNum = 4; //请求K线根数 } message S2C { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.KLine klList = 2; //k线点 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 复权类型参考 `RehabType `_ * K线类型参考 `KLType `_ * 股票结构参考 `Security `_ * K线结构参考 `KLine `_ * 请求K线目前最多最近1000根 ------------------------------------- `Qot_UpdateKL.proto `_ - 3007推送K线 ------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_UpdateKL; import "Common.proto"; import "Qot_Common.proto"; message S2C { required int32 rehabType = 1; //Qot_Common.RehabType,复权类型 required int32 klType = 2; //Qot_Common.KLType,K线类型 required Qot_Common.Security security = 3; //股票 repeated Qot_Common.KLine klList = 4; //推送的k线点 } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 复权类型参考 `RehabType `_ * K线类型参考 `KLType `_ * 股票结构参考 `Security `_ * K线结构参考 `KLine `_ ------------------------------------- `Qot_GetRT.proto `_ - 3008获取分时 ------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetRT; import "Common.proto"; import "Qot_Common.proto"; message C2S { required Qot_Common.Security security = 1; //股票 } message S2C { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.TimeShare rtList = 2; //分时点 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 分时结构参考 `TimeShare `_ ------------------------------------- `Qot_UpdateRT.proto `_ - 3009推送分时 ------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_UpdateRT; import "Common.proto"; import "Qot_Common.proto"; message S2C { required Qot_Common.Security security = 1; repeated Qot_Common.TimeShare rtList = 2; //推送的分时点 } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 分时结构参考 `TimeShare `_ ------------------------------------- `Qot_GetTicker.proto `_ - 3010获取逐笔 --------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetTicker; import "Common.proto"; import "Qot_Common.proto"; message C2S { required Qot_Common.Security security = 1; //股票 required int32 maxRetNum = 2; //最多返回的逐笔个数,实际返回数量不一定会返回这么多,最多返回1000个 } message S2C { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.Ticker tickerList = 2; //逐笔 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 逐笔结构参考 `Ticker `_ * 请求逐笔目前最多最近1000个 ------------------------------------- `Qot_UpdateTicker.proto `_ - 3011推送逐笔 --------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_UpdateTicker; import "Common.proto"; import "Qot_Common.proto"; message S2C { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.Ticker tickerList = 2; //逐笔 } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 逐笔结构参考 `Ticker `_ ------------------------------------- `Qot_GetOrderBook.proto `_ - 3012获取买卖盘 --------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetOrderBook; import "Common.proto"; import "Qot_Common.proto"; message C2S { required Qot_Common.Security security = 1; //股票 required int32 num = 2; //请求的摆盘个数(1~10) } message S2C { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.OrderBook orderBookAskList = 2; //卖盘 repeated Qot_Common.OrderBook orderBookBidList = 3; //买盘 optional string svrRecvTimeBid = 4; // 富途服务器从交易所收到数据的时间(for bid)部分数据的接收时间为零，例如服务器重启或第一次推送的缓存数据。该字段暂时只支持港股。 optional double svrRecvTimeBidTimestamp = 5; // 富途服务器从交易所收到数据的时间戳(for bid) optional string svrRecvTimeAsk = 6; // 富途服务器从交易所收到数据的时间(for ask) optional double svrRecvTimeAskTimestamp = 7; // 富途服务器从交易所收到数据的时间戳(for ask) } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 买卖盘结构参考 `OrderBook `_ * 富途服务器从交易所收到数据的时间字段，仅支持港股正股和涡轮，且仅开盘时间才有此数据。 * 富途服务器从交易所收到数据的时间字段，部分数据的接收时间为零，例如服务器重启或第一次推送的缓存数据。 ------------------------------------- `Qot_UpdateOrderBook.proto `_ - 3013推送买卖盘 --------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_UpdateOrderBook; import "Common.proto"; import "Qot_Common.proto"; message S2C { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.OrderBook orderBookAskList = 2; //卖盘 repeated Qot_Common.OrderBook orderBookBidList = 3; //买盘 optional string svrRecvTimeBid = 4; // 富途服务器从交易所收到数据的时间(for bid)部分数据的接收时间为零，例如服务器重启或第一次推送的缓存数据。该字段暂时只支持港股。 optional double svrRecvTimeBidTimestamp = 5; // 富途服务器从交易所收到数据的时间戳(for bid) optional string svrRecvTimeAsk = 6; // 富途服务器从交易所收到数据的时间(for ask) optional double svrRecvTimeAskTimestamp = 7; // 富途服务器从交易所收到数据的时间戳(for ask) } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 买卖盘结构参考 `OrderBook `_ ------------------------------------- `Qot_GetBroker.proto `_ - 3014获取经纪队列 --------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetBroker; import "Common.proto"; import "Qot_Common.proto"; message C2S { required Qot_Common.Security security = 1; //股票 } message S2C { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.Broker brokerAskList = 2; //经纪Ask(卖)盘 repeated Qot_Common.Broker brokerBidList = 3; //经纪Bid(买)盘 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 经纪队列结构参考 `Broker `_ ------------------------------------- `Qot_UpdateBroker.proto `_ - 3015推送经纪队列 --------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_UpdateBroker; import "Common.proto"; import "Qot_Common.proto"; message S2C { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.Broker brokerAskList = 2; //经纪Ask(卖)盘 repeated Qot_Common.Broker brokerBidList = 3; //经纪Bid(买)盘 } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 经纪队列结构参考 `Broker `_ ------------------------------------- `Qot_GetHistoryKL.proto `_ - :strike:`3100从本地下载历史数据获取单只股票一段历史K线` ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetHistoryKL; import "Common.proto"; import "Qot_Common.proto"; message C2S { required int32 rehabType = 1; //Qot_Common.RehabType,复权类型 required int32 klType = 2; //Qot_Common.KLType,K线类型 required Qot_Common.Security security = 3; //股票市场以及股票代码 required string beginTime = 4; //开始时间字符串 required string endTime = 5; //结束时间字符串 optional int32 maxAckKLNum = 6; //最多返回多少根K线，如果未指定表示不限制 optional int64 needKLFieldsFlag = 7; //指定返回K线结构体特定某几项数据，KLFields枚举值或组合，如果未指定返回全部字段 } message S2C { required Qot_Common.Security security = 1; repeated Qot_Common.KLine klList = 2; //K线数据 optional string nextKLTime = 3; //如请求不指定maxAckKLNum值，则不会返回该字段，该字段表示超过指定限制的下一K线时间字符串 optional double nextKLTimestamp = 4; //时间戳，如请求不指定maxAckKLNum值，则不会返回该字段，该字段表示超过指定限制的下一K线时间戳 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * :red-strengthen:`历史K线数据下载到本地需单独申请` * 复权类型参考 `RehabType `_ * K线类型参考 `KLType `_ * 股票结构参考 `Security `_ * K线结构参考 `KLine `_ * K线字段类型参考 `KLFields `_ ------------------------------------- `Qot_GetHistoryKLPoints.proto `_ - :strike:`3101从本地下载历史数据获取多只股票多点历史K线` -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetHistoryKLPoints; import "Common.proto"; import "Qot_Common.proto"; //当请求时间点数据为空时，如何返回数据 enum NoDataMode { NoDataMode_Null = 0; //直接返回空数据 NoDataMode_Forward = 1; //往前取值，返回前一个时间点数据 NoDataMode_Backward = 2; //向后取值，返回后一个时间点数据 } //这个时间点返回数据的状态以及来源 enum DataStatus { DataStatus_Null = 0; //空数据 DataStatus_Current = 1; //当前时间点数据 DataStatus_Previous = 2; //前一个时间点数据 DataStatus_Back = 3; //后一个时间点数据 } message C2S { required int32 rehabType = 1; //Qot_Common.RehabType,复权类型 required int32 klType = 2; //Qot_Common.KLType,K线类型 required int32 noDataMode = 3; //NoDataMode,当请求时间点数据为空时，如何返回数据 repeated Qot_Common.Security securityList = 4; //股票市场以及股票代码 repeated string timeList = 5; //时间字符串 optional int32 maxReqSecurityNum = 6; //最多返回多少只股票的数据，如果未指定表示不限制 optional int64 needKLFieldsFlag = 7; //指定返回K线结构体特定某几项数据，KLFields枚举值或组合，如果未指定返回全部字段 } message HistoryPointsKL { required int32 status = 1; //DataStatus,数据状态 required string reqTime = 2; //请求的时间 required Qot_Common.KLine kl = 3; //K线数据 } message SecurityHistoryKLPoints { required Qot_Common.Security security = 1; //股票 repeated HistoryPointsKL klList = 2; //K线数据 } message S2C { repeated SecurityHistoryKLPoints klPointList = 1; //多只股票的多点历史K线点 optional bool hasNext = 2; //如请求不指定maxReqSecurityNum值，则不会返回该字段，该字段表示请求是否还有超过指定限制的数据 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 历史K线数据下载到本地需单独申请 * 复权类型参考 `RehabType `_ * K线类型参考 `KLType `_ * 股票结构参考 `Security `_ * K线结构参考 `KLine `_ * K线字段类型参考 `KLFields `_ * 目前限制最多5个时间点，股票个数不做限制，但不建议传入过多股票，查询耗时过多会导致协议返回超时。 ------------------------------------- `Qot_GetRehab.proto `_ - :strike:`3102从本地下载历史数据获取复权信息` -------------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetRehab; import "Common.proto"; import "Qot_Common.proto"; message C2S { repeated Qot_Common.Security securityList = 1; //股票 } message SecurityRehab { required Qot_Common.Security security = 1; //股票 repeated Rehab rehabList = 2; //复权信息 } message S2C { repeated SecurityRehab securityRehabList = 1; //多支股票的复权信息 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 历史K线数据下载到本地需单独申请 * 股票结构参考 `Security `_ * 复权结构参考 `Rehab `_ ------------------------------------- `Qot_RequestRehab.proto `_ - 3105在线获取单只股票复权信息 -------------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_RequestRehab; import "Common.proto"; import "Qot_Common.proto"; message C2S { required Qot_Common.Security security = 1; //股票 } message S2C { repeated Qot_Common.Rehab rehabList = 1; //复权信息 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 复权结构参考 `Rehab `_ * 限频接口：30秒内最多10次 ------------------------------------- `Qot_RequestHistoryKL.proto `_ - 3103在线获取单只股票一段历史K线 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_RequestHistoryKL; import "Common.proto"; import "Qot_Common.proto"; message C2S { required int32 rehabType = 1; //Qot_Common.RehabType,复权类型 required int32 klType = 2; //Qot_Common.KLType,K线类型 required Qot_Common.Security security = 3; //股票市场以及股票代码 required string beginTime = 4; //开始时间字符串 required string endTime = 5; //结束时间字符串 optional int32 maxAckKLNum = 6; //最多返回多少根K线，如果未指定表示不限制 optional int64 needKLFieldsFlag = 7; //指定返回K线结构体特定某几项数据，KLFields枚举值或组合，如果未指定返回全部字段 optional bytes nextReqKey = 8; //分页请求key } message S2C { required Qot_Common.Security security = 1; repeated Qot_Common.KLine klList = 2; //K线数据 optional bytes nextReqKey = 3; //分页请求key。一次请求没有返回所有数据时，下次请求带上这个key，会接着请求 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 复权类型参考 `RehabType `_ * K线类型参考 `KLType `_ * 股票结构参考 `Security `_ * K线结构参考 `KLine `_ * K线字段类型参考 `KLFields `_ * 请求最大个数参考OpenAPI用户等级权限 * 分页请求的key。如果start和end之间的数据点多于max_count，那么后续请求时，要传入上次调用返回的page_req_key。初始请求时应该传None。 ------------------------------------- `Qot_GetTradeDate.proto `_ - 3200获取市场交易日 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetTradeDate; import "Common.proto"; import "Qot_Common.proto"; message C2S { required int32 market = 1; //Qot_Common.QotMarket,股票市场 required string beginTime = 2; //开始时间字符串 required string endTime = 3; //结束时间字符串 } message TradeDate { required string time = 1; //时间字符串 optional double timestamp = 2; //时间戳 optional int32 tradeDateType = 3; //Qot_Common.TradeDateType,交易时间类型 } message S2C { repeated TradeDate tradeDateList = 1; //交易日 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 市场类型参考 `QotMarket `_ * 交易时间类型参考 `TradeDateType `_ ------------------------------------- `Qot_GetStaticInfo.proto `_ - 3202获取股票静态信息 ------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetStaticInfo; import "Common.proto"; import "Qot_Common.proto"; message C2S { optional int32 market = 1; //Qot_Common.QotMarket,股票市场 optional int32 secType = 2; //Qot_Common.SecurityType,股票类型 repeated Qot_Common.Security securityList = 3; //股票，若该字段存在，忽略其他字段，只返回该字段股票的静态信息 //当传入程序无法识别的股票时（包括很久之前退市的股票和不存在的股票），仍然返回股票信息，用静态信息标志来该股票不存在。 } message S2C { repeated Qot_Common.SecurityStaticInfo staticInfoList = 1; //静态信息 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 市场类型参考 `QotMarket `_ * 股票静态信息结构参考 `SecurityStaticInfo `_ ------------------------------------- `Qot_GetSecuritySnapshot.proto `_ - 3203获取股票快照 -------------------------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetSecuritySnapshot; import "Common.proto"; import "Qot_Common.proto"; message C2S { repeated Qot_Common.Security securityList = 1; //股票 } // 正股类型额外数据 message EquitySnapshotExData { required int64 issuedShares = 1; // 发行股本,即总股本 required double issuedMarketVal = 2; // 总市值 =总股本*当前价格 required double netAsset = 3; // 资产净值 required double netProfit = 4; // 盈利（亏损） required double earningsPershare = 5; // 每股盈利 required int64 outstandingShares = 6; // 流通股本 required double outstandingMarketVal = 7; // 流通市值 =流通股本*当前价格 required double netAssetPershare = 8; // 每股净资产 required double eyRate = 9; // 收益率（该字段为百分比字段，默认不展示%） required double peRate = 10; // 市盈率 required double pbRate = 11; // 市净率 required double peTTMRate = 12; // 市盈率TTM optional double dividendTTM = 13; // 股息TTM，派息 optional double dividendRatioTTM = 14; // 股息率TTM（该字段为百分比字段，默认不展示%） optional double dividendLFY = 15; // 股息LFY，上一年度派息 optional double dividendLFYRatio = 16; // 股息率LFY（该字段为百分比字段，默认不展示%） } // 涡轮类型额外数据 message WarrantSnapshotExData { required double conversionRate = 1; //换股比率 required int32 warrantType = 2; //Qot_Common.WarrantType,涡轮类型 required double strikePrice = 3; //行使价 required string maturityTime = 4; //到期日时间字符串 required string endTradeTime = 5; //最后交易日时间字符串 required Qot_Common.Security owner = 6; //所属正股 required double recoveryPrice = 7; //收回价,仅牛熊证支持该字段 required int64 streetVolumn = 8; //街货量 required int64 issueVolumn = 9; //发行量 required double streetRate = 10; //街货占比（该字段为百分比字段，默认不展示%） required double delta = 11; //对冲值,仅认购认沽支持该字段 required double impliedVolatility = 12; //引申波幅,仅认购认沽支持该字段 required double premium = 13; //溢价（该字段为百分比字段，默认不展示%） optional double maturityTimestamp = 14; //到期日时间戳 optional double endTradeTimestamp = 15; //最后交易日时间戳 optional double leverage = 16; // 杠杆比率（倍） optional double ipop = 17; // 价内/价外（该字段为百分比字段，默认不展示%） optional double breakEvenPoint = 18; // 打和点 optional double conversionPrice = 19; // 换股价 optional double priceRecoveryRatio = 20; // 正股距收回价（该字段为百分比字段，默认不展示%） optional double score = 21; // 综合评分 optional double upperStrikePrice = 22; //上限价，仅界内证支持该字段 optional double lowerStrikePrice = 23; //下限价，仅界内证支持该字段 optional int32 inLinePriceStatus = 24; //Qot_Common.PriceType, 界内界外，仅界内证支持该字段 } // 期权类型额外数据 message OptionSnapshotExData { required int32 type = 1; //Qot_Common.OptionType,期权 required Qot_Common.Security owner = 2; //标的股 required string strikeTime = 3; //行权日 required double strikePrice = 4; //行权价 required int32 contractSize = 5; //每份合约数 required int32 openInterest = 6; //未平仓合约数 required double impliedVolatility = 7; //隐含波动率（该字段为百分比字段，默认不展示%） required double premium = 8; //溢价（该字段为百分比字段，默认不展示%） required double delta = 9; //希腊值 Delta required double gamma = 10; //希腊值 Gamma required double vega = 11; //希腊值 Vega required double theta = 12; //希腊值 Theta required double rho = 13; //希腊值 Rho optional double strikeTimestamp = 14; //行权日时间戳 } // 指数类型额外数据 message IndexSnapshotExData { required int32 raiseCount = 1; // 上涨支数 required int32 fallCount = 2; // 下跌支数 required int32 equalCount = 3; // 平盘支数 } // 板块类型额外数据 message PlateSnapshotExData { required int32 raiseCount = 1; // 上涨支数 required int32 fallCount = 2; // 下跌支数 required int32 equalCount = 3; // 平盘支数 } //盘前盘后数据，仅支持美股以及科创板 //科创板只有盘后成交量，成交额 message PreAfterMarketData { optional double price = 1; // 盘前或盘后 - 价格 optional double highPrice = 2; // 盘前或盘后 - 最高价 optional double lowPrice = 3; // 盘前或盘后 - 最低价 optional int64 volume = 4; // 盘前或盘后 - 成交量 optional double turnover = 5; // 盘前或盘后 - 成交额 optional double changeVal = 6; // 盘前或盘后 - 涨跌额 optional double changeRate = 7; // 盘前或盘后 - 涨跌幅（该字段为百分比字段，默认不展示%） optional double amplitude = 8; // 盘前或盘后 - 振幅（该字段为百分比字段，默认不展示%） } //基本快照数据 message SnapshotBasicData { required Qot_Common.Security security = 1; //股票 required int32 type = 2; //Qot_Common.SecurityType,股票类型 required bool isSuspend = 3; //是否停牌 required string listTime = 4; //上市时间字符串 required int32 lotSize = 5; //每手数量 required double priceSpread = 6; //价差 required string updateTime = 7; //更新时间字符串 required double highPrice = 8; //最高价 required double openPrice = 9; //开盘价 required double lowPrice = 10; //最低价 required double lastClosePrice = 11; //昨收价 required double curPrice = 12; //最新价 required int64 volume = 13; //成交量 required double turnover = 14; //成交额 required double turnoverRate = 15; //换手率（该字段为百分比字段，默认不展示%） optional double listTimestamp = 16; //上市时间戳 optional double updateTimestamp = 17; //更新时间戳 optional double askPrice = 18;//卖价 optional double bidPrice = 19;//买价 optional int64 askVol = 20;//卖量 optional int64 bidVol = 21;//买量 optional bool enableMargin = 22; // 是否可融资，如果为true，后两个字段才有意义 optional double mortgageRatio = 23; // 股票抵押率（该字段为百分比字段，默认不展示%） optional double longMarginInitialRatio = 24; // 融资初始保证金率（该字段为百分比字段，默认不展示%） optional bool enableShortSell = 25; // 是否可卖空，如果为true，后三个字段才有意义 optional double shortSellRate = 26; // 卖空参考利率（该字段为百分比字段，默认不展示%） optional int64 shortAvailableVolume = 27; // 剩余可卖空数量（股） optional double shortMarginInitialRatio = 28; // 卖空（融券）初始保证金率（该字段为百分比字段，默认不展示%） optional double amplitude = 29; // 振幅（该字段为百分比字段，默认不展示%） optional double avgPrice = 30; // 平均价 optional double bidAskRatio = 31; // 委比（该字段为百分比字段，默认不展示%） optional double volumeRatio = 32; // 量比 optional double highest52WeeksPrice = 33; // 52周最高价 optional double lowest52WeeksPrice = 34; // 52周最低价 optional double highestHistoryPrice = 35; // 历史最高价 optional double lowestHistoryPrice = 36; // 历史最低价 optional PreAfterMarketData preMarket = 37; //盘前数据 optional PreAfterMarketData afterMarket = 38; //盘后数据 } message Snapshot { required SnapshotBasicData basic = 1; //快照基本数据 optional EquitySnapshotExData equityExData = 2; //正股快照额外数据 optional WarrantSnapshotExData warrantExData = 3; //窝轮快照额外数据 optional OptionSnapshotExData optionExData = 4; //期权快照额外数据 optional IndexSnapshotExData indexExData = 5; //指数快照额外数据 optional PlateSnapshotExData plateExData = 6; //板块快照额外数据 } message S2C { repeated Snapshot snapshotList = 1; //股票快照 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 接口限制请参见 `获取股票快照限制 `_ ------------------------------------- `Qot_GetPlateSet.proto `_ - 3204获取板块集合下的板块 ----------------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetPlateSet; import "Common.proto"; import "Qot_Common.proto"; message C2S { required int32 market = 1; //Qot_Common.QotMarket,股票市场 required int32 plateSetType = 2; //Qot_Common.PlateSetType,板块集合的类型 } message S2C { repeated Qot_Common.PlateInfo plateInfoList = 1; //板块集合下的板块信息 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 市场类型参考 `QotMarket `_ * 板块集合类型参考 `PlateSetType `_ * 股票结构参考 `Security `_ * 板块信息结构参考 `PlateInfo `_ * 限频接口：30秒内最多10次 ------------------------------------- `Qot_GetPlateSecurity.proto `_ - 3205获取板块下的股票 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetPlateSecurity; import "Common.proto"; import "Qot_Common.proto"; message C2S { required Qot_Common.Security plate = 1; //板块 optional int32 sortField = 2;//Qot_Common.SortField,根据哪个字段排序,不填默认Code排序 optional bool ascend = 3;//升序ture, 降序false, 不填默认升序 } message S2C { repeated Qot_Common.SecurityStaticInfo staticInfoList = 1; //板块下的股票静态信息 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 股票静态信息结构参考 `SecurityStaticInfo `_ * 限频接口：30秒内最多10次 ------------------------------------- `Qot_GetReference.proto `_ - 3206 获取正股相关股票 -------------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_GetReference; import "Common.proto"; import "Qot_Common.proto"; enum ReferenceType { ReferenceType_Unknow = 0; ReferenceType_Warrant = 1; //正股相关的窝轮 } message C2S { required Qot_Common.Security security = 1; //股票 required int32 referenceType = 2; // ReferenceType, 相关类型 } message S2C { repeated Qot_Common.SecurityStaticInfo staticInfoList = 2; //相关股票列表 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 股票静态信息结构参考 `SecurityStaticInfo `_ ------------------------------------- `Qot_GetOwnerPlate.proto `_ - 3207获取股票所属板块 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetOwnerPlate; import "Common.proto"; import "Qot_Common.proto"; message C2S { repeated Qot_Common.Security securityList = 1; //股票 } message SecurityOwnerPlate { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.PlateInfo plateInfoList = 2; //所属板块 } message S2C { repeated SecurityOwnerPlate ownerPlateList = 1; //所属板块信息 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 板块信息结构参考 `PlateInfo `_ * 限频接口：30秒内最多10次 * 最多可传入200只股票 * 仅支持正股和指数 ------------------------------------- `Qot_GetHoldingChangeList.proto `_ - 3208获取持股变化列表 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetHoldingChangeList; import "Common.proto"; import "Qot_Common.proto"; message C2S { required Qot_Common.Security security = 1; //股票 required int32 holderCategory = 2; //Qot_Common.HolderCategory 持有者类别 //以下是发布时间筛选，不传返回所有数据，传了返回发布时间属于开始时间到结束时间段内的数据 optional string beginTime = 3; //开始时间，严格按YYYY-MM-DD HH:MM:SS或YYYY-MM-DD HH:MM:SS.MS格式传 optional string endTime = 4; //结束时间，严格按YYYY-MM-DD HH:MM:SS或YYYY-MM-DD HH:MM:SS.MS格式传 } message S2C { required Qot_Common.Security security = 1; //股票 repeated Qot_Common.ShareHoldingChange holdingChangeList = 2; //对应类别的持股变化列表（最多返回前100大股东的变化） } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 持有者类别枚举参考 `HolderCategory `_ * 持股变化列表结构参考 `ShareHoldingChange `_ * 限频接口：30秒内最多10次 * 最多返回前100大股东的变化 * 目前仅支持美股 ------------------------------------- `Qot_GetOptionChain.proto `_ - 3209获取期权链 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetOptionChain; import "Common.proto"; import "Qot_Common.proto"; enum OptionCondType { OptionCondType_Unknow = 0; OptionCondType_WithIn = 1; //价内 OptionCondType_Outside = 2; //价外 } message C2S { required Qot_Common.Security owner = 1; //期权标的股 optional int32 type = 2; //Qot_Common.OptionType,期权类型,可选字段,不指定则表示都返回 optional int32 condition = 3; //OptionCondType,价内价外,可选字段,不指定则表示都返回 required string beginTime = 4; //期权到期日开始时间 required string endTime = 5; //期权到期日结束时间,时间跨度最多一个月 } message OptionItem { optional Qot_Common.SecurityStaticInfo call = 1; //看涨,不一定有该字段,由请求条件决定 optional Qot_Common.SecurityStaticInfo put = 2; //看跌,不一定有该字段,由请求条件决定 } message OptionChain { required string strikeTime = 1; //行权日 repeated OptionItem option = 2; //期权信息 } message S2C { repeated OptionChain optionChain = 1; //期权链 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 期权类型参考 `OptionType `_ * 股票静态信息结构参考 `SecurityStaticInfo `_ * 限频接口：30秒内最多10次 * 目前仅支持美股 ------------------------------------------ `Qot_GetWarrant.proto `_ - 3210获取涡轮 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetWarrant; import "Common.proto"; import "Qot_Common.proto"; message C2S { required int32 begin = 1; //数据起始点 required int32 num = 2; //请求数据个数，最大200 required int32 sortField = 3;//Qot_Common.SortField,根据哪个字段排序 required bool ascend = 4;//升序ture, 降序false //以下为筛选条件，可选字段，不填表示不过滤 optional Qot_Common.Security owner = 5; //所属正股 repeated int32 typeList = 6; //Qot_Common.WarrantType,窝轮类型过滤列表 repeated int32 issuerList = 7; //Qot_Common.Issuer,发行人过滤列表 optional string maturityTimeMin = 8; //到期日,到期日范围的开始时间戳 optional string maturityTimeMax = 9; //到期日范围的结束时间戳 optional int32 ipoPeriod = 10; //Qot_Common.IpoPeriod,上市日 optional int32 priceType = 11; //Qot_Common.PriceType, 价内/价外（该字段为百分比字段，默认不展示%） optional int32 status = 12; //Qot_Common.WarrantStatus, 窝轮状态 optional double curPriceMin = 13; //最新价过滤起点 optional double curPriceMax = 14; //最新价过滤终点 optional double strikePriceMin = 15; //行使价过滤起点 optional double strikePriceMax = 16; //行使价过滤终点 optional double streetMin = 17; //街货占比,过滤起点（该字段为百分比字段，默认不展示%） optional double streetMax = 18; //街货占比,过滤终点（该字段为百分比字段，默认不展示%） optional double conversionMin = 19; //换股比率过滤起点 optional double conversionMax = 20; //换股比率过滤终点 optional uint64 volMin = 21; //成交量过滤起点 optional uint64 volMax = 22; //成交量过滤终点 optional double premiumMin = 23; //溢价,过滤起点（该字段为百分比字段，默认不展示%） optional double premiumMax = 24; //溢价,过滤终点（该字段为百分比字段，默认不展示%） optional double leverageRatioMin = 25; //杠杆比率过滤起点 optional double leverageRatioMax = 26; //杠杆比率过滤终点 optional double deltaMin = 27;//对冲值过滤起点,仅认购认沽支持该字段过滤 optional double deltaMax = 28;//对冲值过滤终点,仅认购认沽支持该字段过滤 optional double impliedMin = 29; //引伸波幅过滤起点,仅认购认沽支持该字段过滤 optional double impliedMax = 30; //引伸波幅过滤终点,仅认购认沽支持该字段过滤 optional double recoveryPriceMin = 31; //收回价过滤起点,仅牛熊证支持该字段过滤 optional double recoveryPriceMax = 32; //收回价过滤终点,仅牛熊证支持该字段过滤 optional double priceRecoveryRatioMin = 33;//正股距收回价,过滤起点,仅牛熊证支持该字段过滤（该字段为百分比字段，默认不展示%） optional double priceRecoveryRatioMax = 34;//正股距收回价,过滤终点,仅牛熊证支持该字段过滤（该字段为百分比字段，默认不展示%） } message WarrantData { //静态数据项 required Qot_Common.Security stock = 1; //股票 required Qot_Common.Security owner = 2; //所属正股 required int32 type = 3; //Qot_Common.WarrantType,窝轮类型 required int32 issuer = 4; //Qot_Common.Issuer,发行人 required string maturityTime = 5; //到期日 optional double maturityTimestamp = 6; //到期日时间戳 required string listTime = 7; //上市时间 optional double listTimestamp = 8; //上市时间戳 required string lastTradeTime = 9; //最后交易日 optional double lastTradeTimestamp = 10; //最后交易日时间戳 optional double recoveryPrice = 11; //收回价,仅牛熊证支持该字段 required double conversionRatio = 12; //换股比率 required int32 lotSize = 13; //每手数量 required double strikePrice = 14; //行使价 required double lastClosePrice = 15; //昨收价 required string name = 16; //名称 //动态数据项 required double curPrice = 17; //当前价 required double priceChangeVal = 18; //涨跌额 required double changeRate = 19; //涨跌幅（该字段为百分比字段，默认不展示%） required int32 status = 20; //Qot_Common.WarrantStatus, 窝轮状态 required double bidPrice = 21; //买入价 required double askPrice = 22; //卖出价 required int64 bidVol = 23; //买量 required int64 askVol = 24; //卖量 required int64 volume = 25; //成交量 required double turnover = 26; //成交额 required double score = 27; //综合评分 required double premium = 28; //溢价（该字段为百分比字段，默认不展示%） required double breakEvenPoint = 29; //打和点 required double leverage = 30; //杠杆比率（倍） required double ipop = 31; //价内/价外（该字段为百分比字段，默认不展示%） optional double priceRecoveryRatio = 32; //正股距收回价，仅牛熊证支持该字段（该字段为百分比字段，默认不展示%） required double conversionPrice = 33; //换股价 required double streetRate = 34; //街货占比（该字段为百分比字段，默认不展示%） required int64 streetVol = 35; //街货量 required double amplitude = 36; //振幅（该字段为百分比字段，默认不展示%） required int64 issueSize = 37; //发行量 required double highPrice = 39; //最高价 required double lowPrice = 40; //最低价 optional double impliedVolatility = 41; //引伸波幅,仅认购认沽支持该字段 optional double delta = 42; //对冲值,仅认购认沽支持该字段 required double effectiveLeverage = 43; //有效杠杆 optional double upperStrikePrice = 44; //上限价，仅界内证支持该字段 optional double lowerStrikePrice = 45; //下限价，仅界内证支持该字段 optional int32 inLinePriceStatus = 46; //Qot_Common.PriceType, 界内界外，仅界内证支持该字段 } message S2C { required bool lastPage = 1; //是否最后一页了,false:非最后一页,还有窝轮记录未返回; true:已是最后一页 required int32 allCount = 2; //该条件请求所有数据的个数 repeated WarrantData warrantDataList = 3; //窝轮数据 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 排序类型参考 `SortField `_ * 窝轮类型过滤列表参考 `WarrantType `_ * 发行人过滤列表参考 `Issuer `_ * 上市日类型参考 `IpoPeriod `_ * 价内价外类型参考 `PriceType `_ * 窝轮状态类型参考 `WarrantStatus `_ * 接口限制请参见 `获取涡轮限制 `_ * 目前仅支持港股 * 使用类似最新价的排序字段获取数据的时候，多页获取的间隙，数据的排序有可能是变化的。 `Qot_RequestHistoryKLQuota.proto `_ - 3104拉取历史K线已经用掉的额度 -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- .. code-block:: protobuf syntax = "proto2"; package Qot_RequestHistoryKLQuota; import "Common.proto"; import "Qot_Common.proto"; message DetailItem { required Qot_Common.Security security = 1; //拉取的股票 required string requestTime = 2; //拉取的时间字符串 optional int64 requestTimeStamp = 3; //拉取的时间戳 } message C2S { optional bool bGetDetail = 2; //是否返回详细拉取过的历史纪录 } message S2C { required int32 usedQuota = 1; //已使用过的额度，即当前周期内已经下载过多少只股票。 required int32 remainQuota = 2; //剩余额度 repeated DetailItem detailList = 3; //每只拉取过的股票的下载时间 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } ------------------------------------- `Qot_GetCapitalFlow.proto `_ - 3211获取资金流向 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetCapitalFlow; import "Common.proto"; import "Qot_Common.proto"; message C2S { required Qot_Common.Security security = 1; //股票 } message CapitalFlowItem { required double inFlow = 1; //净流入的资金额度 optional string time = 2; //开始时间字符串,以分钟为单位 optional double timestamp = 3; //开始时间戳 } message S2C { repeated CapitalFlowItem flowItemList = 1; //资金流向 optional string lastValidTime = 2; //数据最后有效时间字符串 optional double lastValidTimestamp = 3; //数据最后有效时间戳 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 限频接口：30秒内最多10次 ------------------------------------- `Qot_GetCapitalDistribution.proto `_ - 3212获取资金分布 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetCapitalDistribution; import "Common.proto"; import "Qot_Common.proto"; message C2S { required Qot_Common.Security security = 1; //股票 } message S2C { required double capitalInBig = 1; //流入资金额度，大单 required double capitalInMid = 2; //流入资金额度，中单 required double capitalInSmall = 3; //流入资金额度，小单 required double capitalOutBig = 4; //流出资金额度，大单 required double capitalOutMid = 5; //流出资金额度，中单 required double capitalOutSmall = 6; //流出资金额度，小单 optional string updateTime = 7; //更新时间字符串 optional double updateTimestamp = 8; //更新时间戳 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 限频接口：30秒内最多10次 ------------------------------------- `Qot_GetUserSecurity.proto `_ - 3213获取自选股分组下的股票 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_GetUserSecurity; import "Common.proto"; import "Qot_Common.proto"; message C2S { required string groupName = 1; //分组名,有同名的返回最先创建的 } message S2C { repeated Qot_Common.SecurityStaticInfo staticInfoList = 1; //自选股分组下的股票列表 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票静态信息结构参考 `SecurityStaticInfo `_ * 限频接口：30秒内最多10次 * 仅支持自定义分组 ------------------------------------- `Qot_ModifyUserSecurity.proto `_ - 3214修改自选股分组下的股票 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_ModifyUserSecurity; import "Common.proto"; import "Qot_Common.proto"; enum ModifyUserSecurityOp { ModifyUserSecurityOp_Unknown = 0; ModifyUserSecurityOp_Add = 1; //新增 ModifyUserSecurityOp_Del = 2; //删除 } message C2S { required string groupName = 1; //分组名,有同名的返回最先创建的 required int32 op = 2; //ModifyUserSecurityOp,操作类型 repeated Qot_Common.Security securityList = 3; //新增或删除该分组下的股票 } message S2C { } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 限频接口：30秒内最多10次 * 仅支持自定义分组 ------------------------------------- `Qot_StockFilter.proto `_ - 3215获取条件选股 ------------------------------------------------------------------------------------------------------------------------------------------------------------------ .. code-block:: protobuf syntax = "proto2"; package Qot_StockFilter; import "Common.proto"; import "Qot_Common.proto"; // 简单属性 enum StockField { StockField_Unknown = 0; // 未知 StockField_StockCode = 1; // 股票代码，不能填区间上下限值。 StockField_StockName = 2; // 股票名称，不能填区间上下限值。 StockField_CurPrice = 3; // 最新价 例如填写[10,20]值区间 StockField_CurPriceToHighest52WeeksRatio = 4; // (现价 - 52周最高)/52周最高，对应PC端离52周高点百分比 例如填写[-0.8,0]值区间 StockField_CurPriceToLowest52WeeksRatio = 5; // (现价 - 52周最低)/52周最低，对应PC端离52周低点百分比 例如填写[0,0.52]值区间 StockField_HighPriceToHighest52WeeksRatio = 6; // (今日最高 - 52周最高)/52周最高 例如填写[-0.8,0]值区间 StockField_LowPriceToLowest52WeeksRatio = 7; // (今日最低 - 52周最低)/52周最低 例如填写[0,0.68]值区间 StockField_VolumeRatio = 8; // 量比 例如填写[0.5,30]值区间 StockField_BidAskRatio = 9; // 委比 例如填写[-20,85.01]值区间 StockField_LotPrice = 10; // 每手价格 例如填写[40,100]值区间 StockField_MarketVal = 11; // 市值，单位是元 例如填写[50000000,3000000000]值区间 StockField_PeAnnual = 12; // 市盈率 (静态) 例如填写[-8,65.3]值区间 StockField_PeTTM = 13; // 市盈率TTM 例如填写[-10,20.5]值区间 StockField_PbRate = 14; // 市净率 例如填写[0,0.8]值区间 }; // 排序方向 enum SortDir { SortDir_No = 0; // 不排序 SortDir_Ascend = 1; // 升序 SortDir_Descend = 2; // 降序 }; // 简单属性筛选 message BaseFilter { required int32 field = 1; // StockField 简单属性 optional double filterMin = 2; // 区间下限，闭区间 optional double filterMax = 3; // 区间上限，闭区间 optional bool isNoFilter = 4; // 该字段是否需要筛选。当该字段为true时，表示不需要筛选，以上filterMin，filterMax区间两个字段无效。默认True，不需要筛选。 optional int32 sortDir = 5; // SortDir 排序方向，默认不排序。 }; // 简单属性数据 message BaseData { required int32 field = 1; // StockField 简单属性 required double value = 2; }; // 返回的股票数据 message StockData { required Qot_Common.Security security = 1; // 股票 required string name = 2; // 股票名称 repeated BaseData baseDataList = 3; // 筛选后的简单属性数据 }; message C2S { required int32 begin = 1; // 数据起始点 required int32 num = 2; // 请求数据个数，最大200 required int32 market= 3; // Qot_Common::QotMarket股票市场，支持沪股和深股，且沪股和深股不做区分都代表A股市场。 // 以下为筛选条件，可选字段，不填表示不过滤 optional Qot_Common.Security plate = 4; // 板块 repeated BaseFilter baseFilterList = 5; // 简单行情过滤器 } message S2C { required bool lastPage = 1; // 是否最后一页了,false:非最后一页,还有窝轮记录未返回; true:已是最后一页 required int32 allCount = 2; // 该条件请求所有数据的个数 repeated StockData dataList = 3; // 返回的股票数据列表 } message Request { required C2S c2s = 1; } message Response { required int32 retType = 1 [default = -400]; //RetType,返回结果 optional string retMsg = 2; optional int32 errCode = 3; optional S2C s2c = 4; } .. note:: * 股票结构参考 `Security `_ * 市场类型参考 `QotMarket `_ * 简单属性筛选条件参考 `StockField `_ * 排序方向参考 `SortDir `_ * 限频接口：30秒内最多10次 * 使用类似最新价的排序字段获取数据的时候，多页获取的间隙，数据的排序有可能是变化的。 -------------------------------------