Question

current - 查询当前行情快照

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

函数原型：

DataArray<Tick>* current(const char *symbols);

参数：

参数名	类型	说明
symbols	const char *	查询代码，如有多个代码, 中间用 , (英文逗号) 隔开
返回值	DataArray<Tick>*	Tick 数组

示例：

DataArray<Tick>* current_data = current("SZSE.000001,SZSE.000002");

注意：

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

history_ticks - 查询历史 Tick 行情

函数原型：

DataArray<Tick>* history_ticks(const char *symbols, const char *start_time, const char *end_time, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

参数名	类型	说明
symbols	const char *	标的代码,若要获取多个标的的历史数据，可以采用中间用 , (英文逗号) 隔开的方法
start_time	const char *	开始时间 (%Y-%m-%d %H:%M:%S 格式),其中日线包含 start_time 数据, 非日线不包含 start_time 数据
end_time	const char *	结束时间 (%Y-%m-%d %H:%M:%S 格式),
adjust	int	ADJUST_NONE or 0: 不复权, ADJUST_PREV or 1: 前复权, ADJUST_POST or 2: 后复权 默认不复权
adjust_end_time	const char *	复权基点时间, 默认当前时间
skip_suspended	bool	是否跳过停牌, 默认跳过
fill_missing	const char *	填充方式, None - 不填充, 'NaN' - 用空值填充, 'Last' - 用上一个值填充, 默认 None
返回值	DataArray<Tick>*	一个 Tick 数组

示例：

DataArray<Tick>* history_tick = history_ticks(symbol="SHSE.000300", start_time="2010-07-28",  end_time="2017-07-30")

注意：

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

2. skip_suspended 和 fill_missing 参数暂不支持

3. 单次返回数据量最大返回 33000, 超出部分不返回

history_bars - 查询历史 Bar 行情

函数原型：

 DataArray<Bar>* history_bars(const char *symbols, const char *frequency, const char *start_time, const char *end_time, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

参数名	类型	说明
symbols	const char *	标的代码,若要获取多个标的的历史数据，可以采用中间用 , (英文逗号) 隔开的方法
frequency	const char *	频率, 支持 '1d', '60s', '300s' , '1800s' , '3600s' 等
start_time	const char *	开始时间 (%Y-%m-%d %H:%M:%S 格式),其中日线包含 start_time 数据, 非日线不包含 start_time 数据
end_time	const char *	结束时间 (%Y-%m-%d %H:%M:%S 格式),
adjust	int	ADJUST_NONE or 0: 不复权, ADJUST_PREV or 1: 前复权, ADJUST_POST or 2: 后复权 默认不复权
adjust_end_time	const char *	复权基点时间, 默认当前时间
skip_suspended	bool	是否跳过停牌, 默认跳过
fill_missing	const char *	填充方式, None - 不填充, 'NaN' - 用空值填充, 'Last' - 用上一个值填充, 默认 None
返回值	DataArray<Bar>*	一个 Bar 数组

示例：

//获取1分钟的bar
DataArray<Bar>* history_bar = history_bars(symbol="SHSE.000300", "60s", start_time="2010-07-28",  end_time="2017-07-30");

//获取60分钟的bar
DataArray<Bar>* history_bar = history_bars(symbol="SHSE.000300", "3600s", start_time="2010-07-28",  end_time="2017-07-30");

//获取日线
DataArray<Bar>* history_bar = history_bars(symbol="SHSE.000300", "1d", start_time="2010-07-28",  end_time="2018-07-30");

注意：

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

2. skip_suspended 和 fill_missing 参数暂不支持

3. 单次返回数据量最大返回 33000, 超出部分不返回

history_ticks_n - 查询最新 n 条 Tick 行情

函数原型：

DataArray<Tick>* history_ticks_n(const char *symbol, int n, const char *end_time = NULL, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

参数名	类型	说明
symbol	const char *	标的代码,只支持单个标的
n	int	获取行情的数量
end_time	const char *	从此时间开始，往前取行情, 如果为 NULL, 那么为当前时间开始
adjust	int	ADJUST_NONE or 0: 不复权, ADJUST_PREV or 1: 前复权, ADJUST_POST or 2: 后复权 默认不复权
adjust_end_time	const char *	复权基点时间, 默认当前时间
skip_suspended	bool	是否跳过停牌, 默认跳过
fill_missing	const char *	填充方式, None - 不填充, 'NaN' - 用空值填充, 'Last' - 用上一个值填充, 默认 None
返回值	DataArray<Tick>*	一个 Tick 数组

示例：

//获取沪深300最新10条tick
DataArray<Tick>* history_tick_n = history_ticks_n(symbol="SHSE.000300", 10);

注意：

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

2. skip_suspended 和 fill_missing 参数暂不支持

3. 单次返回数据量最大返回 33000, 超出部分不返回

history_bars_n - 查询最新 n 条 Bar 行情

函数原型：

DataArray<Bar>* history_bars_n(const char *symbol, const char *frequency, int n, const char *end_time = NULL, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

参数名	类型	说明
symbol	const char *	标的代码,只支持单个标的
frequency	const char *	频率, 支持 '1d', '60s', '300s' , '1800s' , '3600s' 等
n	int	获取行情的数量
end_time	const char *	从此时间开始，往前取行情, 如果为 NULL, 那么为当前时间开始
adjust	int	ADJUST_NONE or 0: 不复权, ADJUST_PREV or 1: 前复权, ADJUST_POST or 2: 后复权 默认不复权
adjust_end_time	const char *	复权基点时间, 默认当前时间
skip_suspended	bool	是否跳过停牌, 默认跳过
fill_missing	const char *	填充方式, None - 不填充, 'NaN' - 用空值填充, 'Last' - 用上一个值填充, 默认 None
返回值	DataArray<Bar>*	一个 Bar 数组

示例：

//获取沪深300最新10条1分钟bar
DataArray<Bar>* history_bars_n = history_bars_n(symbol="SHSE.000300", "60s", 10);

注意：

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

2. skip_suspended 和 fill_missing 参数暂不支持

3. 单次返回数据量最大返回 33000, 超出部分不返回

history_l2ticks - 查询历史 L2-Tick 行情

仅特定券商付费提供

函数原型：

DataArray<Tick>* history_l2ticks(const char *symbols, const char *start_time, const char *end_time, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

参数名	类型	说明
symbols	const char *	标的代码,若要获取多个标的的历史数据，可以采用中间用 , (英文逗号) 隔开的方法
start_time	const char *	开始时间 (%Y-%m-%d %H:%M:%S 格式),其中日线包含 start_time 数据, 非日线不包含 start_time 数据
end_time	const char *	结束时间 (%Y-%m-%d %H:%M:%S 格式),
adjust	int	ADJUST_NONE or 0: 不复权, ADJUST_PREV or 1: 前复权, ADJUST_POST or 2: 后复权 默认不复权
adjust_end_time	const char *	复权基点时间, 默认当前时间
skip_suspended	bool	是否跳过停牌, 默认跳过
fill_missing	const char *	填充方式, None - 不填充, 'NaN' - 用空值填充, 'Last' - 用上一个值填充, 默认 None
返回值	DataArray<Tick>*	一个 Tick 数组

示例：

DataArray<Tick>* history_tick = history_l2ticks(symbol="SHSE.600000", start_time="2020-03-28",  end_time="2020-03-29")

history_l2bars - 查询历史 L2-Bar 行情

仅特定券商付费提供

函数原型：

DataArray<Bar>* history_l2bars(const char *symbols, const char *frequency, const char *start_time, const char *end_time, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

参数名	类型	说明
symbols	const char *	标的代码,若要获取多个标的的历史数据，可以采用中间用 , (英文逗号) 隔开的方法
frequency	const char *	频率, 支持 '1d', '60s', '300s' , '1800s' , '3600s' 等
start_time	const char *	开始时间 (%Y-%m-%d %H:%M:%S 格式),其中日线包含 start_time 数据, 非日线不包含 start_time 数据
end_time	const char *	结束时间 (%Y-%m-%d %H:%M:%S 格式),
adjust	int	ADJUST_NONE or 0: 不复权, ADJUST_PREV or 1: 前复权, ADJUST_POST or 2: 后复权 默认不复权
adjust_end_time	const char *	复权基点时间, 默认当前时间
skip_suspended	bool	是否跳过停牌, 默认跳过
fill_missing	const char *	填充方式, None - 不填充, 'NaN' - 用空值填充, 'Last' - 用上一个值填充, 默认 None
返回值	DataArray<Bar>*	一个 Bar 数组

示例：

//获取1分钟的bar
DataArray<Bar>* history_bar = history_l2bars(symbol="SHSE.000300", "60s", start_time="2010-07-28",  end_time="2017-07-30");

//获取60分钟的bar
DataArray<Bar>* history_bar = history_l2bars(symbol="SHSE.000300", "3600s", start_time="2010-07-28",  end_time="2017-07-30");

history_l2transactions - 查询历史 L2 逐笔成交

仅特定券商付费提供

函数原型：

DataArray<L2Transaction>* history_l2transactions(const char *symbols, const char *start_time, const char *end_time);

参数：

参数名	类型	说明
symbols	const char *	标的代码,若要获取多个标的的历史数据，可以采用中间用 , (英文逗号) 隔开的方法
start_time	const char *	开始时间 (%Y-%m-%d %H:%M:%S 格式),其中日线包含 start_time 数据, 非日线不包含 start_time 数据
end_time	const char *	结束时间 (%Y-%m-%d %H:%M:%S 格式),
返回值	DataArray<L2Transaction>*	一个 L2Transaction 数组

示例：

DataArray<L2Transaction>* data = history_l2transactions(symbol="SHSE.600000", start_time="2020-03-28",  end_time="2020-03-29");

history_l2orders - 查询历史 L2 逐笔委托

仅特定券商付费提供

函数原型：

DataArray<L2Order>* history_l2orders(const char *symbols, const char *start_time, const char *end_time);

参数：

参数名	类型	说明
symbols	const char *	标的代码,若要获取多个标的的历史数据，可以采用中间用 , (英文逗号) 隔开的方法
start_time	const char *	开始时间 (%Y-%m-%d %H:%M:%S 格式),其中日线包含 start_time 数据, 非日线不包含 start_time 数据
end_time	const char *	结束时间 (%Y-%m-%d %H:%M:%S 格式),
返回值	DataArray<L2Order>*	一个 L2Order 数组

示例：

DataArray<L2Order>* data = history_l2orders(symbol="SHSE.600000", start_time="2020-03-28",  end_time="2020-03-29");

history_l2orders_queue - 查询历史 L2 委托队列

仅特定券商付费提供

函数原型：

DataArray<L2OrderQueue>* history_l2orders_queue(const char *symbols, const char *start_time, const char *end_time);

参数：

参数名	类型	说明
symbols	const char *	标的代码,若要获取多个标的的历史数据，可以采用中间用 , (英文逗号) 隔开的方法
start_time	const char *	开始时间 (%Y-%m-%d %H:%M:%S 格式),其中日线包含 start_time 数据, 非日线不包含 start_time 数据
end_time	const char *	结束时间 (%Y-%m-%d %H:%M:%S 格式),
返回值	DataArray<L2OrderQueue>*	一个 L2OrderQueue 数组

示例：

DataArray<L2OrderQueue>* data = history_l2orders_queue(symbol="SHSE.600000", start_time="2020-03-28",  end_time="2020-03-29");

---