# 行情数据查询函数（免费）
# 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");
← 策略基类 通用数据函数（免费） →