多资产

回测平台支持多资产回测，目前支持的资产包括股票、期权、期货、通用资产。

引擎配置说明

接口 createBacktester 的参数 config 和接口 createBacktestEngine 的参数 userConfig 的配置可参考下表：


key	说明	备注
"startDate"	开始日期	必须配置，DATE 类型例如 “2020.01.01”
"endDate"	结束日期	必须配置，DATE 类型例如 “2020.01.01”
"strategyGroup"	策略类型	必须配置，"multiAsset"
"cash"	初始资金	必须配置，字典，支持使用同一个账户或多个账户分别管理不同资产的资金。若某些资产共享同一个账户，应使用英文逗号`,`分隔品种名称，表示它们共用该账户。具体说明如下：多资产共享资金： `cashDict["futures, options"]=100000000. cashDict["futures, options, stock"]=100000000.` 各资产独立使用资金： `cashDict["futures"]=100000000. cashDict["options"]=100000000. cashDict["stock"]=100000000.`
“commission”	股票等现货的手续费	DOUBLE 类型，默认为 0.0
“tax”	股票等现货的印花税	DOUBLE 类型，默认为 0.0
“frequency”	将快照行情合成 frequency 频率的行情触发 onBar	INT 类型，默认为0
”callbackForSnapshot“	快照行情触发回调模式	INT 类型，默认为 0 ，可选值为： 0：表示只回调onSnapshot， 1 ：表示既回调onSnpshot 又回调 onbar， 2 ：表示只回调 onbar
"dataType"	行情类型： 1：快照 3: 分钟频率 4：日频	frequency>0 and dataType=1或者 2 时，行情为快照，引擎内部合成 frequency 频率的快照行情触发 onBar
“matchingMode“	订单撮合模式	日频：模式一，以收盘价撮合订单；模式二，以开盘价撮合订单。分钟频率：模式一，行情时间大于订单时间时撮合订单；模式二，行情时间等于订单时间时以当前行情的收盘价撮合订单，后续未完成订单撮合订单同模式一
“benchmark”	基准标的	STRING 或 SYMBOL 类型
"latency"	订单延时	INT 类型，单位为毫秒，用来模拟用户订单从发出到开始进行撮合的时延
“orderBookMatchingRatio”	与行情订单薄的成交百分比	DOUBLE 类型，默认 1.0，取值 0~1.0 之间
“matchingRatio”	区间撮合比例	DOUBLE 类型，默认 1.0，取值 0~1.0 之间。默认和成交百分比 orderBookMatchingRatio 相等
“maintenanceMargin”	维保比例	DOUBLE 类型，资产为融资融券时是数组，三个元素分别为警戒线、追保线、最低线；为期货时是标量。
“outputQueuePosition”	是否需要获取订单在行情中的位置如果输出该信息，则在成交明细和未成交订单接口中会增加以下 5 个指标：优于委托价格的行情未成交委托单总量次于委托价格的行情未成交委托单总量等于委托价格的行情未成交委托单总量等于委托价格且早于用户订单时间的行情未成交委托单总量优于委托价格的行情档位数	dataType = 0 、5、6 且enableSubscriptionToTickQuotes = true 时仅有。 INT 类型，可选值为： 0：默认值，表示不输出 1：表示订单撮合成交计算上述指标的时候，把最新的一条行情纳入订单薄 2：表示订单撮合成交计算上述指标的时候，把最新的一条行情不纳入订单薄，即统计的是撮合计算前的位置信息
stockDividend	分红除权基本信息表	TABLE 类型，字段说明见下文
multiAssetQuoteUnifiedInput	多资产回测时，输入的行情是多个资产合成的表，还是不同资产单独输入。	BOOL 类型，默认值为 true，此时输入行情 multiAsset 为不同资产合成的表
"msgAsPiecesOnSnapshot"	多资产回测时，是每条数据依次触发 `onSnapshot` 回调函数，还是同一时间戳的所有数据同时触发。	BOOL 类型，默认值为 false，此时每条数据依次触发`onSnapshot`

股票分红除权基本信息表“stockDividend”字段说明如下


字段	名称
symbol	股票代码
endDate	分红年度
annDate	预案公告日
recordDate	股权登记日
exDate	除权除息日
payDate	派息日
divListDate	红股上市日
bonusRatio	每股送股比例
capitalConversion	每股转增比例
afterTaxCashDiv	每股分红（税后）
allotPrice	配股价格
allotRatio	每股配股比例

基本信息表

接口 createBacktester 和 createBacktestEngine 的参数 securityReference 的基本信息表字段可参考下表：


列名	类型	说明
symbol	SYMBOL 或 STRING	品种代码
assetType	INT	品种类型 0：股票 1：期货 2：商品期权 3：股指期权 4：ETF 期权 5：通用资产 6：债券
underlyingCode	STRING	仅支持期权资产，标的代码
optType	INT	仅支持期权资产，期权类型 1：看涨（call） 2：看跌（put）
strikePrice	DOUBLE	仅支持期权资产，期权行权价
multiplier	DOUBLE	合约乘数
marginRatio	DOUBLE	保证金比例
tradeUnit	DOUBLE	合约单位
priceUnit	DOUBLE	报价单位
priceTick	DOUBLE	价格最小变动单位
commission	DOUBLE	手续费
deliveryCommissionMode	INT	1：commission/手 2：成交额*commission
lastTradingDay	DATE	仅支持期权资产，合约最后交易日
exerciseDate	DATE	仅支持期权资产，期权行权日
exerciseSettlementDate	DATE	仅支持期权资产，行权交收日

行情

通过接口 appendQuotationMsg 向引擎中插入数据时，msg 必须为字典：

当配置项 multiAssetQuoteUnifiedInput 为 true 时，msg 的 key 可选值为：
- “indicator”：历史指标表。
- “multiAsset”：多种资产行情组成的表，不同资产类别通过 assetType 字段区分。
当配置项 multiAssetQuoteUnifiedInput 为 false 时，msg 的 key 可选值为：
- “indicator”：历史指标表。
- “stock”：股票行情表。
- “futures”：期货行情表。
- “options”：期权行情表。

快照行情

字段说明如下：


字段	类型	备注
symbol	SYMBOL	标的代码上交所以 ".XSHG" 结尾深交所以 ".XSHE" 结尾
symbolSource	STRING	"XSHG"（上交所）或者 "XSHE"（深交所）
timestamp	TIMESTAMP	时间戳
tradingDay	DATE	交易日/结算日期
lastPrice	DOUBLE	最新成交价
upLimitPrice	DOUBLE	涨停价
downLimitPrice	DOUBLE	跌停价
totalBidQty	LONG	区间买量
totalOfferQty	LONG	区间卖量
bidPrice	DOUBLE[]	委买价格列表
bidQty	LONG[]	委买量列表
offerPrice	DOUBLE[]	委卖价格列表
offerQty	LONG[]	委卖量列表
highPrice	DOUBLE	最高价
lowPrice	DOUBLE	最低价
underlyingPrice	DOUBLE	标的价格（仅对期权品种必需）
assetType	INT	品种类型： 0：股票 1：期货 2：商品期权 3：股指期权 4：ETF 期权 5：通用资产 6：债券

以下是不同 key 对应表的建表语句，字段说明见上表：

建表语句如下：

stock

colName=["symbol","symbolSource","timestamp","lastPrice","upLimitPrice",
        "downLimitPrice","totalBidQty","totalOfferQty","bidPrice","bidQty",
        "offerPrice","offerQty","highPrice","lowPrice"]
colType= ["STRING","STRING","TIMESTAMP","DOUBLE","DOUBLE","DOUBLE","DOUBLE",
          "DOUBLE","DOUBLE[]","LONG[]","DOUBLE[]","LONG[]","DOUBLE","DOUBLE"]

futures

colName=["symbol","symbolSource","timestamp","tradingDay","lastPrice",
         "upLimitPrice","downLimitPrice","totalBidQty","totalOfferQty",
         "bidPrice","bidQty","offerPrice","offerQty","highPrice","lowPrice"]
colType= ["STRING","STRING","TIMESTAMP","DATE","DOUBLE","DOUBLE","DOUBLE",
          "DOUBLE","DOUBLE","DOUBLE[]","LONG[]","DOUBLE[]","LONG[]","DOUBLE",
          "DOUBLE"]

options

colName=["symbol","symbolSource","timestamp","tradingDay","lastPrice",
         "upLimitPrice","downLimitPrice","totalBidQty","totalOfferQty",
         "bidPrice","bidQty","offerPrice","offerQty","highPrice",
         "lowPrice","underlyingPrice"]
colType= ["STRING","STRING","TIMESTAMP","DATE","DOUBLE","DOUBLE","DOUBLE",
          "DOUBLE","DOUBLE","DOUBLE[]","LONG[]","DOUBLE[]","LONG[]","DOUBLE",
          "DOUBLE", "DOUBLE"]

multiAsset

colName=["symbol","symbolSource","timestamp","tradingDay","lastPrice","upLimitPrice",
        "downLimitPrice","totalBidQty","totalOfferQty","bidPrice","bidQty","offerPrice",
        "offerQty","highPrice","lowPrice"，"assetType"]
colType= ["STRING","STRING","TIMESTAMP","DATE","DOUBLE","DOUBLE","DOUBLE","DOUBLE","DOUBLE",
        "DOUBLE[]","LONG[]","DOUBLE[]","LONG[]","DOUBLE","DOUBLE", "INT"]
messageTable=table(10000000:0, colName, colType)

注：

存在期权资产时，必须增加 DOUBLE 类型字段 underlyingPrice。
字段名须严格与表中一致，字段顺序除首列必须为 symbol 列外，无其它要求，此外还支持 INT，DOUBLE，STRING 类型的列，或名为 signal 的 DOUBLE ARRAY VECTOR 类型的列作为扩展字段。

分钟频率或日频行情