数据查询函数

GMApi 静态方法

SetToken - 设置token

函数原型

static int SetToken(string token);

参数

示例

GMApi.SetToken("27cbdfd8cd9b86dea554a5612baa4a8eee");

SetAddr - 设置终端服务地址

设置终端服务地址, 默认本地地址, 可不填

函数原型：

void SetAddr(string addr)

参数:

注意：
1.如运行策略与终端不在同一设备上，必须调用此方法，7001为终端端口
2.不关注策略运行结果，可不启动终端并设置终端服务地址为 discovery.myquant.cn:7061

Current - 查询当前行情快照

查询当前行情快照，返回tick数据。回测时，返回回测时间点的tick数据

函数原型:

static GMDataList<Tick> Current(string symbols);

参数：

示例：

static GMDataList<Tick> currentData = GMApi.Current("SZSE.000001,SZSE.000002");

注意：

startTime和endTime中月,日,时,分,秒均可以只输入个位数,例:"2010-7-8 9:40:0"或"2017-7-30 12:3:0",但若对应位置为零，则0不可被省略,如不可输入"2017-7-30 12:3: "

HistoryTicks - 查询历史Tick行情

函数原型:

static GMDataList<Tick> HistoryTicks(string symbols, string startTime, string endTime, Adjust adjust = Adjust.ADJUST_NONE, string adjustEndTime = null, bool skipSuspended = true, string fillMissing = null)

参数：

示例：

GMDataList<Tick> historyTick = GMApi.HistoryTicks("SHSE.000300", "2010-07-28 08:00:00", "2017-07-30 16:00:00")

注意：

1.startTime和endTime中月,日,时,分,秒均可以只输入个位数,例:"2010-7-8 9:40:0"或"2017-7-30 12:3:0",但若对应位置为零，则0不可被省略,如不可输入"2017-7-30 12:3: "

2. skipSuspended 和 fillMissing 参数暂不支持

HistoryBars - 查询历史Bar行情

函数原型:

static GMDataList<Bar> HistoryBars(string symbols, string frequency, string startTime, string endTime, Adjust adjust = Adjust.ADJUST_NONE, string adjustEndTime = null, bool skipSuspended = true, string fillMissing = null)

参数：

示例：

//获取1分钟的bar
GMDataList<Bar> historyBar = GMApi.HistoryBars("SHSE.000300", "60s", "2010-07-28 08:00:00", "2017-07-30 16:00:00");
//获取60分钟的bar
GMDataList<Bar> historyBar = GMApi.HistoryBars("SHSE.000300", "3600s", "2010-07-28 08:00:00", "2017-07-30 16:00:00");
//获取日线
GMDataList<Bar> historyBar = GMApi.HistoryBars("SHSE.000300", "1d", "2010-07-28 08:00:00", "2018-07-30 16:00:00");

注意：

1.startTime和endTime中月,日,时,分,秒均可以只输入个位数,例:"2010-7-8 9:40:0"或"2017-7-30 12:3:0",但若对应位置为零，则0不可被省略,如不可输入"2017-7-30 12:3: "

2. skipSuspended 和 fillMissing 参数暂不支持

HistoryTicksN - 查询最新n条Tick行情

函数原型:

static GMDataList<Tick> HistoryTicksN(string symbols, int n, string endTime = null, Adjust adjust = Adjust.ADJUST_NONE, string adjustEndTime = null, bool skipSuspended = true, string fillMissing = null)

参数：

示例：

//获取沪深300最新10条tick
GMDataList<Tick> ticks = GMApi.HistoryTicksN("SHSE.000300", 10);

注意：

1.endTime中月,日,时,分,秒均可以只输入个位数,例:"2010-7-8 9:40:0"或"2017-7-30 12:3:0",但若对应位置为零，则0不可被省略,如不可输入"2017-7-30 12:3: "

2. skipSuspended 和 fillMissing 参数暂不支持

HistoryBarsN - 查询最新n条Bar行情

函数原型:

static GMDataList<Bar> HistoryBarsN(string symbols, string frequency, int n, string endTime = null, Adjust adjust = Adjust.ADJUST_NONE, string adjustEndTime = null, bool skipSuspended = true, string fillMissing = null)

参数：

示例：

//获取沪深300最新10条1分钟bar
GMDataList<Bar> bars = GMApi.HistoryBarsN("SHSE.000300", "60s", 10);

注意：

1.endTime中月,日,时,分,秒均可以只输入个位数,例:"2010-7-8 9:40:0"或"2017-7-30 12:3:0",但若对应位置为零，则0不可被省略,如不可输入"2017-7-30 12:3: "

2. skipSuspended 和 fillMissing 参数暂不支持

GetFundamentals - 查询基本面数据

函数原型:

static GMData<DataTable> GetFundamentals(string table, string symbols, string startDate, string endDate, string fields = null, string filter = null, string orderBy = null, int limit = 100000)

参数：

示例：

例1: 取股票代码 SHSE.600000, SZSE.000001, 离 2017-01-01 最近一个交易日的 股票交易财务衍生表 的 TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI 字段的值

GMData<DataTable> ds = GMApi.GetFundamentals("trading_derivative_indicator", "SHSE.600000,SZSE.000001", "2017-01-01", "2017-01-01", 
                "TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI")

例2: 取股票代码 SHSE.600000, SZSE.000001, 指定时间段 2016-01-01 -- 2017-01-01 股票交易财务衍生表 的 TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI 字段的值

GMData<DataTable> ds = GMApi.GetFundamentals("trading_derivative_indicator", "SHSE.600000,SZSE.000001", "2016-01-01", "2017-01-01",
                "TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI")

例3: 取指定股票 SHSE.600000, SHSE.600001, SHSE.600002 离 2017-01-01 最近一个交易日, 且满足条件 PCTTM > 0 and PCTTM < 10 股票交易财务衍生表 的 TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI 字段的值

GMData<DataTable> ds = GMApi.GetFundamentals("trading_derivative_indicator", "SHSE.600000,SHSE.600001,SHSE.600002", "2017-01-01", "2017-01-01", "PCTTM > 0 and PCTTM < 10",
                "TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI")

例4: 取指定股票 SHSE.600000,SZSE.000001 离 2016-01-20 最近一个财报, 同时满足条件 CURFDS > 0 and TOTLIABSHAREQUI > 0 的 资产负债 的数据

GMData<DataTable> ds = GMApi.GetFundamentals("balance_sheet", "2016-01-20", "2016-01-20",
                "CURFDS, SETTRESEDEPO, PLAC, TRADFINASSET, ',
                symbols='SHSE.600000, SZSE.000001'", 
                "CURFDS > 0 and TOTLIABSHAREQUI > 0"
                )

注意:

1.当 startDate == endDate 时, 取所举每个股票离 endDate 最近业务日期(交易日期或报告日期) 一条数据,当 startDate < endDate 时, 取指定时间段的数据,当 startDate > endDate 时, 返回空list/空DataFrame

2.startDate和endDate中月,日均可以只输入个位数,例:'2010-7-8'或'2017-7-30'

3.在该函数中，table参数只支持输入一个表名，若表名输入错误或以'table1,table2'方式输入多个表名，函数返回空结果集

4.若表名输入正确，但查询字段中出现非指定字符串，则返回错误

GetFundamentalsN - 查询基本面数据最新n条

取指定股票的最近 endDate 的 n 条记录

函数原型:

static GMData<DataTable> GetFundamentalsN(string table, string symbols, string endDate, int n = 1, string fields = null, string filter = null, string orderBy = null)

参数：

示例：

例: 取股票代码 SHSE.600000, SZSE.000001, 离 2017-01-01 最近3条(每个股票都有3条) 股票交易财务衍生表 的 TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI 字段的值

GMData<DataTable> ds = GMApi.GetFundamentalsN("trading_derivative_indicator", "SHSE.600000, SZSE.000001", "2017-01-01", 3,
                   "TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI")

注意:

1.endDate中月,日均可以只输入个位数,例:'2010-7-8'或'2017-7-30'

2.在该函数中，table参数只支持输入一个表名，若表名输入错误或以'table1,table2'方式输入多个表名，函数返回空结果集

3.若表名输入正确，但查询字段中出现非指定字符串，则返回错误

GetInstruments - 查询最新交易标的信息

查询最新交易标的信息,有基本数据及最新日频数据

函数原型:

static GMData<DataTable> GetInstruments(string symbols = null, string exchanges = null, string secTypes = null, string fields = null)

参数：

fields 字段：

注意：

1.停牌时且股票发生除权除息, 涨停价和跌停价可能有误差

2.预上市股票以1900-01-01为虚拟发布日期，未退市股票以2038-01-01为虚拟退市日期。

示例：

GMApi.GetInstruments("SZSE.000001");        //获取平安银行股票信息
GMApi.GetInstruments(null, "SZSE,SHSE", "stock");        //获取深交所、上交所所有股票信息

GetHistoryInstruments - 查询交易标的历史数据

返回指定symbols的标的日频历史数据

函数原型:

static GMData<DataTable> GetHistoryInstruments(string symbols, string startDate, string endDate, string fields = null)

参数：

fields 字段：

示例：

GMApi.GetHistoryInstruments("SZSE.000001,SZSE.000002", "2017-09-19", "2017-09-19");

注意：

1.停牌时且股票发生除权除息, 涨停价和跌停价可能有误差

2.为保护服务器, 单次查询最多返回 3300 条记录

3.startDate和endDate中月,日均可以只输入个位数,例:'2010-7-8'或'2017-7-30'

GetInstrumentinfos - 查询交易标的基本信息

获取到交易标的基本信息, 与时间无关.

函数原型:

static GMData<DataTable> GetInstrumentinfos(string symbols = null, string exchanges = null, string secTypes = null, string names = null, string fields = null)

参数：

字段：

示例：

GMData<DataTable> ds = GMApi.GetInstrumentinfos("SHSE.000001,SHSE.000002");

注意：

1.对于检索所需标的信息的4种手段symbols,exchanges,secTypes,names,若输入参数之间出现任何矛盾（换句话说，所有的参数限制出满足要求的交集为空),则返回空结果集
例如GetInstrumentinfos("SZSE","4") 返回的是空结果集

GetConstituents - 查询指数成份股

函数原型:

static GMData<DataTable> GetConstituents(string index, string tradeDate = null)

参数：

字段：

示例：

GMData<DataTable> ds = GMApi.GetConstituents("SHSE.000001", "2017-07-10");

注意：

1.tradeDate 中月,日均可以只输入个位数,例:"2010-7-8"或"2017-7-30",但若对应位置为零，则0不可被省略

GetIndustry - 查询行业股票列表

函数原型:

static GMDataList<string> GetIndustry(string code)

参数：

示例：

#返回所有以J6开头的行业代码对应的成分股(包括:J66,J67,J68,J69的成分股)
GMDataList<string> da = GMApi.GetIndustry("j6");

注意：

1.在该函数中，code参数只支持输入一个行业代码

GetTradingDates - 查询交易日历

函数原型:

static GMDataList<DateTime> GetTradingDates(string exchange, string startDate, string endDate)

参数：

示例：

GMDataList<DateTime> da = GMApi.GetTradingDates("SZSE", "2017-01-01", "2017-01-30");

注意：

1.exchange参数仅支持输入单个交易所代码

2.startDate和endDate中月,日均可以只输入个位数,
例:"2010-7-8"或"2017-7-30"

GetPreviousTradingDate - 返回指定日期的上一个交易日

函数原型:

static GMData<DateTime> GetPreviousTradingDate(string exchange, string date)

参数：

示例：

GMData<DateTime> dt = GMApi.GetPreviousTradingDate("SZSE", "2017-05-01");

注意：

1.exchange参数仅支持输入单个交易所代码

2.date中月,日均可以只输入个位数,
例:'2010-7-8'或'2017-7-30'

GetNextTradingDate - 返回指定日期的下一个交易日

函数原型:

static GMData<DateTime> GetNextTradingDate(string exchange, string date)

参数：

示例：

GMData<DateTime> dt = GMApi.GetNextTradingDate("SZSE", "2017-05-01");

注意：

1.exchange参数仅支持输入单个交易所代码

2.date中月,日均可以只输入个位数,
例:"2010-7-8"或"2017-7-30"

GetDividend - 查询分红送配

函数原型:

static GMData<DataTable> GetDividend(string symbol, string startDate, string endDate = null)

参数：

返回字段：

示例：

GMData<DataTable> ds = GMApi.GetDividend("SHSE.600000", "2000-01-01", "2017-12-31");

注意:

1.在该函数中，symbol参数只支持输入一个标的代码

2.startDate和endDate中月,日均可以只输入个位数,
例:"2010-7-8"或"2017-7-30"

GetContinuousContracts - 获取连续合约

函数原型:

static GMData<DataTable> GetContinuousContracts(string csymbol, string startDate = null, string endDate = null)

参数：

返回字段：

示例：

GMData<DataTable> ds = GMApi.GetContinuousContracts("SHFE.AG", "2017-07-01", "2017-08-01");

注意:

1.在该函数中，csymbol参数只支持输入一个标的代码

2.startDate和endDate中月,日均可以只输入个位数,
例:'2017-7-1'或'2017-8-1'