数据查询函数
行情数据查询函数(免费)
current - 查询当前行情快照
查询当前行情快照,返回tick数据。回测时,返回回测时间点的tick数据
函数原型:
DataArray<Tick>* current(const char *symbols);
参数:
| 参数名 | 类型 | 说明 | 
|---|---|---|
| symbols | const char * | 查询代码,如有多个代码, 中间用 , (英文逗号) 隔开 | 
| 返回值 | DataArray | 
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数组 | 
示例:
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'等, 默认 '1d', 详情见订阅频率 | 
| 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数组 | 
示例:
//获取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 *symbols, 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);
参数:
| 参数名 | 类型 | 说明 | 
|---|---|---|
| symbols | 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数组 | 
示例:
//获取沪深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 *symbols, 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);
参数:
| 参数名 | 类型 | 说明 | 
|---|---|---|
| symbols | const char * | 标的代码,若要获取多个标的的历史数据,可以采用中间用 , (英文逗号) 隔开的方法 | 
| frequency | const char * | 频率, 支持 '1d', '60s'等, 默认 '1d', 详情见订阅频率 | 
| 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数组 | 
示例:
//获取沪深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, 超出部分不返回