行情协议¶

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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;
}