开始入门

操作指引

SDK

数据文档

常见问题

量化工具

其他

文江博客开发文档掘金量化帮助文档文章详情

文章来源于网络收集而来，版权归原创者所有，如有侵权请及时联系！

数据查询函数

发布于 2024-06-22 12:53:28 字数 124137 浏览 0 评论 0 收藏 0

行情数据查询函数（免费）

`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")

注意：

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 数组

示例：

//获取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");

注意：

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 数组

示例：

//获取沪深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 数组

示例：

//获取沪深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 数组

示例：

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 数组

示例：

//获取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 数组

示例：

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 数组

示例：

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 数组

示例：

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

通用数据函数（免费）

C++ 通用数据 API 包含在 3.5.18 版本及以上版本，不需要引入新库

`get_symbol_infos` - 查询标的基本信息

获取指定(范围)交易标的基本信息，与时间无关.

此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataArray<SymbolInfo>* get_symbol_infos(long long sec_type1, long long sec_type2 = 0, const char *exchanges = NULL, const char *symbols = NULL)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
sec_type1	int	证券品种大类	Y	无	指定一种证券大类，只能输入一个. 证券大类 sec_type1 清单 1010: 股票， 1020: 基金， 1030: 债券， 1040: 期货， 1050: 期权， 1060: 指数，1070：板块.
sec_type2	int	证券品种细类	N	0	指定一种证券细类，只能输入一个. 默认`0`表示不区分细类，即证券大类下所有细类. 证券细类见 sec_type2 清单 - 股票 101001:A 股，101002:B 股，101003:存托凭证 - 基金 102001:ETF，102002:LOF，102005:FOF - 债券 103001:可转债，103008:回购 - 期货 104001:股指期货，104003:商品期货，104006:国债期货 - 期权 105001:股票期权，105002:指数期权，105003:商品期权 - 指数 106001:股票指数，106002:基金指数，106003:债券指数，106004:期货指数 - 板块：107001:概念板块
exchanges	str	交易所代码	N	NULL	输入交易所代码，可输入多个. 采用 str 格式时，多个交易所代码必须用英文逗号分割，如：`"SHSE,SZSE"` 默认`NULL`表示所有交易所. 交易所代码清单 SHSE:上海证券交易所，SZSE:深圳证券交易所， CFFEX:中金所，SHFE:上期所，DCE:大商所， CZCE:郑商所， INE:上海国际能源交易中心，GFEX:广期所
symbols	str	标的代码	N	NULL	输入标的代码，可输入多个. 采用 str 格式时，多个标的代码必须用英文逗号分割，如：`"SHSE.600008,SZSE.000002"` 默认`NULL`表示所有标的.

返回值：

SymbolInfo 结构数组，参见SymbolInfo定义与DataArray类的用法。

示例：

get_symbol_infos(1010, 0, NULL, "SHSE.600008,SZSE.000002")

注意：

1. sec_type1为必填参数，即一次只能查询一个品种的标的基本信息。

2. 查询的标的信息根据参数组合sec_type1, sec_type2, exchanges, symbols取交集，若输入参数之间出现任何矛盾（换句话说，所有的参数限制出满足要求的交集为空)，则返回空

3. 若输入包含无效标的代码symbols，则返回只包含有效标的代码对应的数据。

4. 参数组合示例：

查询以下范围 symbol 的基本信息	sec_type1	sec_type2	exchanges	symbols
查询指定股票	1010	0	NULL	'SHSE.600008,SZSE.000002'
查询 A 股股票	1010	101001	NULL	NULL
查询深交所股票	1010	0	'SZSE'	NULL
查询 ETF	1020	102001	NULL	NULL
查询上交所 LOF	1020	102002	'SHSE'	NULL
查询可转债	1030	103001	NULL	NULL
查询深交所可转债	1030	103001	'SZSE'	NULL
查询股指期货	1040	104001	NULL	NULL
查询商品期货	1040	104003	NULL	NULL
查询郑商所和大商所期货	1040	0	'CZCE,DCE'	NULL
查询股票期权	1050	105001	NULL	NULL
查询上交所股票期权	1050	105001	'SHSE'	NULL
查询指数期权	1050	105002	NULL	NULL
查询商品期权	1050	105003	NULL	NULL
查询上期所商品期权	105003	0	'SHFE'	NULL
查询股票指数	1060	106001	NULL	NULL

`get_symbols_by_date` - 查询指定交易日多标的交易信息

获取指定交易日多个标的交易信息，包括基本信息及日度数据.

此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataArray<SymbolContent>* get_symbols_by_date(long long sec_type1, long long sec_type2 = 0, const char *exchanges = NULL, const char *symbols = NULL, bool skip_suspended = true, bool skip_st = true, const char *trade_date = NULL);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
sec_type1	int	证券品种大类	Y	无	指定一种证券大类，只能输入一个. 证券大类 sec_type1 清单 1010: 股票， 1020: 基金， 1030: 债券， 1040: 期货， 1050: 期权， 1060: 指数，1070：板块.
sec_type2	int	证券品种细类	N	0	指定一种证券细类，只能输入一个. 默认`0`表示不区分细类，即证券大类下所有细类. 证券细类见 sec_type2 清单 - 股票 101001:A 股，101002:B 股，101003:存托凭证 - 基金 102001:ETF，102002:LOF，102005:FOF - 债券 103001:可转债，103008:回购 - 期货 104001:股指期货，104003:商品期货，104006:国债期货 - 期权 105001:股票期权，105002:指数期权，105003:商品期权 - 指数 106001:股票指数，106002:基金指数，106003:债券指数，106004:期货指数 - 板块：107001:概念板块
exchanges	str	交易所代码	N	NULL	输入交易所代码，可输入多个. 采用 str 格式时，多个交易所代码必须用英文逗号分割，如：`"SHSE,SZSE"` 默认`NULL`表示所有交易所. 交易所代码清单 SHSE:上海证券交易所，SZSE:深圳证券交易所， CFFEX:中金所，SHFE:上期所，DCE:大商所， CZCE:郑商所， INE:上海国际能源交易中心，GFEX:广期所
symbols	str	标的代码	N	NULL	输入标的代码，可输入多个. 采用 str 格式时，多个标的代码必须用英文逗号分割，如：`"SHSE.600008,SZSE.000002"` 默认`NULL`表示所有标的.
skip_suspended	bool	跳过停牌	N	true	是否跳过全天停牌，默认`true`跳过
skip_st	bool	跳过 ST	N	true	是否跳过包含 ST 的股票：`ST, ST, SST, SST`, 默认`true`跳过
trade_date	str	交易日期	N	NULL	交易日期，%Y-%m-%d 格式，默认`NULL`取最新截面(包含退市标的)

返回值：

SymbolContent 结构数组，参见SymbolContent定义与DataArray类的用法。

示例：

get_symbols_by_date(sec_type1=1010, 0, NULL, "SHSE.600008,SZSE.000002")

注意：

1. sec_type1为必填参数，即一次只能查询一个品种的标的最新交易日信息。

3. 若输入包含无效标的代码symbols，则返回只包含有效标的代码对应的数据。

4. 获取全 A 股票代码示例get_symbols(1010, 101001)

5. 可转债的到期日(退市日期)为delisted_date，转股价值为转股价值 = 转股数*股价 = (100/可转债转股价) * 股价

`get_history_symbol` - 查询指定标的多日交易信息

获取指定标的多个历史交易日的交易信息，包括基本信息及日度数据.

此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataArray<SymbolContent>* get_history_symbol(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbol	str	标的代码	Y	无	输入标的代码，只能输入一个.
start_date	str	开始时间	N	NULL	开始时间日期，%Y-%m-%d 格式，默认`NULL`表示当前时间
end_date	str	结束时间	N	NULL	结束时间日期，%Y-%m-%d 格式，默认`NULL`表示当前时间

返回值：

SymbolContent 结构数组，参见SymbolContent定义与DataArray类的用法。

示例：

get_history_symbol("SZSE.000002", "2022-09-01", "2022-09-30")

注意：

1. 若输入包含无效标的代码symbol，则返回只包含有效标的代码对应的数据。

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

3. 对每个标的，数据根据trade_date的升序进行排序。

4. start_date和end_date中月份和日期都可以只输入个位数，例:'2010-7-8'或'2017-7-30'

5. 当start_date大于或者等于 end_date 时, 取指定时间段的数据,当 start_date > end_date时, 返回报错

6. 可转债的到期日(退市日期)delisted_date，转股价值为转股价值 = 转股数*股价 = (100/可转债转股价) * 股价

`get_trading_dates_by_year` - 查询年度交易日历

查询一个交易所的指定年份的交易日历.

此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataArray<TradingDateContent>* get_trading_dates_by_year(const char *exchange, int start_year, int end_year);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
exchange	str	交易所代码	Y	无	只能填写一个交易所代码交易所代码清单: SHSE:上海证券交易所，SZSE:深圳证券交易所，CFFEX:中金所，SHFE:上期所，DCE:大商所，CZCE:郑商所，INE:上海国际能源交易中心，GFEX:广期所
start_year	int	开始年份	Y	无	查询交易日历开始年份（含），yyyy 格式
end_year	int	结束年份	Y	无	查询交易日历结束年份（含），yyyy 格式

**返回值:

TradingDateContent 结构数组，参见TradingDateContent定义与DataArray类的用法。

示例：

get_trading_dates_by_year("SHSE", 2020, 2023)

注意：

1. exchange参数仅支持输入单个交易所代码，若代码错误，会报错

2. 开始年份必须不晚于结束年份，否则返回空

`get_trading_session` - 查询交易时段

查询一个标的所属品种交易时间段.

此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataArray<TradingSession>* get_trading_session(const char *symbols);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbols	str	标的代码	Y	无	输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如：`"SHSE.600008,SZSE.000002"`

返回值：

TradingSession 结构数组，参见TradingSession定义与DataArray类的用法。

示例：

get_trading_session("SHFE.au2306")

注意：

1. 如果输入不存在的合约代码 symbol，会报错提示"该合约[symbol]不存在"。

`get_contract_expire_rest_days` - 查询合约到期剩余天数

查询期货合约、期权合约、可转债的到期剩余天数。

此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataArray<ContractExpireRestDays>* get_contract_expire_rest_days(const char *symbols, const char *start_date, const char *end_date, bool trade_flag = false);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbols	str	标的代码	Y	无	输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如：`"CFFEX.IF2212,CFFEX.IC2212"`
start_date	str	开始日期	Y	无	%Y-%m-%d 格式，不早于合约上市日
end_date	str	结束日期	Y	无	%Y-%m-%d 格式，不早于指定的开始日期，否则返回报错
trade_flag	bool	交易日	N	false	是否需要按交易日计算，默认`false`按自然日计算，则返回到期剩余自然日天数; 设置为`true`按交易日计算，则返回到期剩余交易日天数

返回值：

ContractExpireRestDays 结构数组，参见ContractExpireRestDays定义与DataArray类的用法。

示例：

get_contract_expire_rest_days("CFFEX.IM2212", "2022-12-12", "2022-12-16", true)

注意：

1. 参数start_date和end_date必须是yyyy-mm-dd字符串格式

2. 在到期日当天，到期剩余天数为 0。正数表示距离到期日的剩余天数，0 表示到期日当天，负数表示距离到期日已经过去的天数。

3. 如果输入不存在的合约代码symbol，会报错提示"该合约[symbol]不存在"。

4. 如果输入的合约代码symbol在时间段内的某个日期未上市，在该日期的到期剩余天数返回空。

5. 用于剩余天数计算的到期日是最后交易日。

股票财务数据及基础数据函数(免费)

C++ 股票与指数数据 API 包含在 3.5.18 版本及以上版本

`stk_get_index_constituents` - 查询指数成分股

查询指定指数在最新交易日的成分股和权重

此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataArray<StkIndexConstituent>* stk_get_index_constituents(const char *symbol, const char *trade_date = NULL);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
index	str	指数代码	Y	无	必填，只能输入一个指数，如：`'SHSE.000905'`
trade_date	str	交易日期	N	NULL	交易日期，%Y-%m-%d 格式，默认`NULL`为最新交易日

返回值：

StkIndexConstituent 结构数组，参见StkIndexConstituent定义与DataArray类的用法。

示例：

stk_get_index_constituents("SHSE.000300")

注意：

1. 数据日频更新，在交易日约 20 点更新当日数据。如果当日数据尚未更新，调用时不指定trade_date会返回前一交易日的成分数据，调用时指定trade_date为当日会返回空。

2. trade_date输入非交易日，会返回空。trade_date出入的日期格式错误，会报错。

3. 指数列表参考

`stk_get_fundamentals_balance` - 查询资产负债表数据

查询指定时间段某一股票所属上市公司的资产负债表数据

此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataSet* stk_get_fundamentals_balance(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbol	str	股票代码	Y	无	必填，只能填一个股票标的
fields	str	返回字段	Y	无	指定需要返回的财务字段，如有多个字段，中间用英文逗号分隔
rpt_type	int	报表类型	N	0	按报告期查询可指定以下报表类型： 1-一季度报 6-中报 9-前三季报 12-年报默认`0`为不限
data_type	int	数据类型	N	0	在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始 102-合并调整 201-母公司原始 202-母公司调整默认`0`返回当期合并调整，如果没有调整返回合并原始
start_date	str	开始时间	N	NULL	开始时间，时间类型为报告日期，%Y-%m-%d 格式，默认`NULL`表示最新时间
end_date	str	结束时间	N	NULL	结束时间，时间类型为报告日期，%Y-%m-%d 格式，默认`NULL`表示最新时间

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

字段名 类型 中文名称 说明

symbol str 股票代码

pub_date str 发布日期若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期

rpt_date str 报告日期报告截止日期，财报统计的最后一天在指定时间段[开始时间,结束时间]内的报告截止日期

rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报

data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整

[fields]

float

财务字段数据

指定返回 fields字段的数值. 支持的字段名请参考 stk_get_fundamentals_cashflow - 查询现金流量表数据
查询指定时间段某一股票所属上市公司的现金流量表数据
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_fundamentals_cashflow(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的
fields str 返回字段 Y 无指定需要返回的财务字段，如有多个字段，中间用英文逗号分隔
rpt_type int 报表类型 N 0 按报告期查询可指定以下报表类型： 1-一季度报
6-中报
9-前三季报
12-年报默认0为不限
data_type int 数据类型 N 0 在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始
102-合并调整
201-母公司原始
202-母公司调整默认0返回当期合并调整，如果没有调整返回合并原始
start_date str 开始时间 N NULL 开始时间，时间类型为报告日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间，时间类型为报告日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
pub_date str 发布日期若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date str 报告日期报告截止日期，财报统计的最后一天在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
[fields] float 财务字段数据指定返回 fields字段的数值. 支持的字段名请参考 stk_get_fundamentals_income - 查询利润表数据
查询指定时间段某一股票所属上市公司的利润表数据
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_fundamentals_income(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的
fields str 返回字段 Y 无指定需要返回的财务字段，如有多个字段，中间用英文逗号分隔
rpt_type int 报表类型 N 0 按报告期查询可指定以下报表类型： 1-一季度报
6-中报
9-前三季报
12-年报默认0为不限
data_type int 数据类型 N 0 在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始
102-合并调整
201-母公司原始
202-母公司调整默认0返回当期合并调整，如果没有调整返回合并原始
start_date str 开始时间 N NULL 开始时间，时间类型为报告日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间，时间类型为报告日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
pub_date str 发布日期若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date str 报告日期报告截止日期，财报统计的最后一天在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields float 财务字段数据指定返回 fields字段的数值. 支持的字段名请参考 stk_get_fundamentals_balance_pt - 查询资产负债表截面数据（多标的）
查询指定日期截面的股票所属上市公司的资产负债表数据（point-in-time）
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_fundamentals_balance_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str 股票代码 Y 无必填，可输入多个，多个标的代码必须用英文逗号分割，如：SHSE.600008,SZSE.000002
fields str 返回字段 Y 无指定需要返回的财务字段，如有多个字段，中间用英文逗号分隔
rpt_type int 报表类型 N 0 按报告期查询可指定以下报表类型：
1-一季度报
6-中报
9-前三季报
12-年报
默认0为不限
data_type int 数据类型 N 0 在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整默认0返回当期合并调整，如果没有调整返回合并原始
date str 查询日期 N NULL 查询时间，时间类型为发布日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
pub_date str 发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date str 报告日期报告截止日期，财报统计的最后一天
rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields list[float] 财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 stk_get_fundamentals_cashflow_pt - 查询现金流量表截面数据（多标的）
查询指定日期截面的股票所属上市公司的现金流量表数据（point-in-time）
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_fundamentals_cashflow_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str 股票代码 Y 无必填，可输入多个, 多个标的代码必须用英文逗号分割，如：SHSE.600008,SZSE.000002
fields str 返回字段 Y 无指定需要返回的财务字段，如有多个字段，中间用英文逗号分隔
rpt_type int 报表类型 N 0 按报告期查询可指定以下报表类型：
1-一季度报
6-中报
9-前三季报
12-年报
默认0为不限
data_type int 数据类型 N 0 在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整默认0返回当期合并调整，如果没有调整返回合并原始
date str 查询日期 N NULL 查询时间，时间类型为发布日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
pub_date str 发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date str 报告日期报告截止日期，财报统计的最后一天
rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields float 财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 stk_get_fundamentals_income_pt - 查询利润表截面数据（多标的）
查询指定日期截面的股票所属上市公司的利润表数据（point-in-time）
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_fundamentals_income_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str 股票代码 Y 无必填，可输入多个，多个标的代码必须用英文逗号分割，如：SHSE.600008,SZSE.000002
fields str 返回字段 Y 无指定需要返回的财务字段，如有多个字段，中间用英文逗号分隔
rpt_type int 报表类型 N 0 按报告期查询可指定以下报表类型：
1-一季度报
6-中报
9-前三季报
12-年报
默认0为不限
data_type int 数据类型 N 0 在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整默认0返回当期合并调整，如果没有调整返回合并原始
date str 查询日期 N NULL 查询时间，时间类型为发布日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
pub_date str 发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date str 报告日期报告截止日期，财报统计的最后一天
rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields float 财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 stk_get_finance_prime - 查询财务主要指标数据
查询指定时间段股票所属上市公司的财务主要指标
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_finance_prime(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的
fields str 返回字段 Y 无指定需要返回的财务主要指标，如有多个字段，中间用英文逗号分隔
rpt_type int 报表类型 N 0 按报告期查询可指定以下报表类型： 1-一季度报
6-中报
9-前三季报
12-年报默认0为不限
data_type int 数据类型 N 0 在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始
102-合并调整
201-母公司原始
202-母公司调整默认0返回当期合并调整，如果没有调整返回合并原始
start_date str 开始时间 N NULL 开始时间，时间类型为报告日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间，时间类型为报告日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
pub_date str 发布日期若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date str 报告日期报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields float 财务字段数据指定返回 fields字段的数值. 支持的字段名请参考 stk_get_finance_deriv - 查询财务衍生指标数据
查询指定时间段股票所属上市公司的财务衍生指标
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_finance_deriv(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的
fields str 返回字段 Y 无指定需要返回的财务衍生指标，如有多个字段，中间用英文逗号分隔
rpt_type int 报表类型 N 0 按报告期查询可指定以下报表类型： 1-一季度报
6-中报
9-前三季报
12-年报默认0为不限
data_type int 数据类型 N 0 在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始
102-合并调整
201-母公司原始
202-母公司调整默认0返回当期合并调整，如果没有调整返回合并原始
start_date str 开始时间 N NULL 开始时间，时间类型为报告日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间，时间类型为报告日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
pub_date str 发布日期若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date str 报告日期报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields float 财务字段数据指定返回 fields字段的数值. 支持的字段名请参考 stk_get_daily_valuation - 查询估值指标每日数据
查询指定时间段股票的每日估值指标
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_daily_valuation(const char *symbol, const char *fields, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的，使用时参考
fields str 返回字段 Y 无指定需要返回的财务字段，如有多个字段，中间用英文逗号分隔
start_date str 开始时间 N NULL 开始时间，时间类型为交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间，时间类型为交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
trade_date str 交易日期
fields list[float] 指标字段数据指定返回 fields字段的数值. 支持的字段名请参考 stk_get_daily_mktvalue - 查询市值指标每日数据
查询指定时间段股票的每日市值指标
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_daily_mktvalue(const char *symbol, const char *fields, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的
fields str 返回字段 Y 无指定需要返回的财务字段，如有多个字段，中间用英文逗号分隔
start_date str 开始时间 N NULL 开始时间，时间类型为交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间，时间类型为交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
trade_date str 交易日期
fields float 指标字段数据指定返回 fields字段的数值. 支持的字段名请参考 stk_get_daily_basic - 查询基础指标每日数据
查询指定时间段股票的每日基础指标
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_daily_basic(const char *symbol, const char *fields, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的
fields str 返回字段 Y 无指定需要返回的财务字段，如有多个字段，中间用英文逗号分隔
start_date str 开始时间 N NULL 开始时间，时间类型为交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间，时间类型为交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
trade_date str 交易日期
fields float 指标字段数据指定返回 fields字段的数值. 支持的字段名请参考 stk_get_finance_prime_pt - 查询财务主要指标截面数据（多标的）
查询指定日期截面上，股票所属上市公司的财务主要指标数据（point-in-time）
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_finance_prime_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str or list 股票代码 Y 无必填，可输入多个, 多个标的代码必须用英文逗号分割，如：SHSE.600008,SZSE.000002
fields str 返回字段 Y 无指定需要返回的财务主要指标，如有多个字段，中间用英文逗号分隔
rpt_type int 报表类型 N 0 按报告期查询可指定以下报表类型：
1-一季度报
6-中报
9-前三季报
12-年报
默认0为不限
data_type int 数据类型 N 0 在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整默认0返回当期合并调整，如果没有调整返回合并原始
date str 查询日期 N NULL 查询时间，时间类型为发布日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
pub_date str 发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date str 报告日期报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields float 财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 stk_get_finance_deriv_pt - 查询财务衍生指标截面数据（多标的）
查询指定日期截面上，股票所属上市公司的财务衍生指标数据（point-in-time）
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_finance_deriv_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str 股票代码 Y 无必填，可输入多个，多个标的代码必须用英文逗号分割，如：SHSE.600008,SZSE.000002
fields str 返回字段 Y 无指定需要返回的财务衍生指标，如有多个字段，中间用英文逗号分隔
rpt_type int 报表类型 N 0 按报告期查询可指定以下报表类型：
1-一季度报
6-中报
9-前三季报
12-年报
默认0为不限
data_type int 数据类型 N 0 在发布原始财务报告以后，上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整默认0返回当期合并调整，如果没有调整返回合并原始
date str 查询日期 N NULL 查询时间，时间类型为发布日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
pub_date str 发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date str 报告日期报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type int 报表类型返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type int 数据类型返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields float 财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 stk_get_daily_valuation_pt - 查询估值指标单日截面数据（多标的）
查询指定日期截面上，股票的单日估值指标（point-in-time）
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_daily_valuation_pt(const char *symbols, const char *fields, const char *trade_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str 股票代码 Y 无必填，可输入多个，多个标的代码必须用英文逗号分割，如：SHSE.600008,SZSE.000002
fields str 返回字段 Y 无指定需要返回的交易衍生指标，如有多个字段，中间用英文逗号分隔
trade_date str 查询日期 N NULL 查询时间，时间类型为交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
trade_date str 交易日期
fields float 指标字段数据指定查询 fields字段的数值. 支持的字段名请参考 stk_get_daily_mktvalue_pt - 查询市值指标单日截面数据（多标的）
查询指定日期截面上，股票的单日截面数据（point-in-time）
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_daily_mktvalue_pt(const char *symbols, const char *fields, const char *trade_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str 股票代码 Y 无必填，可输入多个，多个标的代码必须用英文逗号分割，如：SHSE.600008,SZSE.000002
fields str 返回字段 Y 无指定需要返回的交易衍生指标，如有多个字段，中间用英文逗号分隔
trade_date str 查询日期 N NULL 查询时间，时间类型为交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
trade_date str 交易日期
fields float 指标字段数据指定查询 fields字段的数值. 支持的字段名请参考 stk_get_daily_basic_pt - 查询基础指标单日截面数据（多标的）
查询指定日期截面上，股票的单日市值指标（point-in-time）
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataSet* stk_get_daily_basic_pt(const char *symbols, const char *fields, const char *trade_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str 股票代码 Y 无必填，可输入多个，多个标的代码必须用英文逗号分割，如：SHSE.600008,SZSE.000002
fields str 返回字段 Y 无指定需要返回的交易衍生指标，如有多个字段，中间用英文逗号分隔
trade_date str 查询日期 N NULL 查询时间，时间类型为交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
一个结果集，参见DataSet类的用法，结果集中返回字段如下：
字段名 类型 中文名称 说明
symbol str 股票代码
trade_date str 交易日期
fields list[float] 指标字段数据指定查询 fields字段的数值. 支持的字段名请参考期货基础数据函数(免费)
C++ 股票与指数数据 API 包含在 3.5.18 版本及以上版本
fut_get_continuous_contracts - 查询连续合约对应的真实合约
查询指定时间段连续合约在每个交易日上对应的真实合约
函数原型：
DataArray<FutContinuousContractsInfo>* fut_get_continuous_contracts(const char *csymbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
csymbol str 连续合约代码 Y 无必填，只能输入一个支持主力合约、次主力、前 5 个月份连续和加权指数合约代码，如： 1000 股指期货主力连续合约：CFFEX.IM， 1000 股指期货次主力连续合约：CFFEX.IM22， 1000 股指期货当月连续合约：CFFEX.IM00， 1000 股指期货下月连续合约：CFFEX.IM01， 1000 股指期货下季连续合约：CFFEX.IM02， 1000 股指期货隔季连续合约：CFFEX.IM03， 1000 股指期货加权指数合约：CFFEX.IM99
start_date str 开始时间 N NULL 开始时间日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
FutContinuousContractsInfo 结构数组，参见FutContinuousContractsInfo定义与DataArray类的用法。
示例：
fut_get_continuous_contracts("SHFE.NI", "2022-09-01", "2022-09-15")
注意：
1. 具体合约（真实合约）：交易所.品种名到期月份对应期货具体合约 symbol，如 CFFEX.IF2206
2. 主力连续合约（期货连续合约，由真实合约拼接）：交易所.品种名对应主力连续合约 symbol，如 CFFEX.IF，CFFEX.IC
主力连续合约切换规则 1. 每个品种只选出唯一一个主力合约。
2. 日成交量和持仓量都为最大的合约，确定为新的主力合约，每日收盘结算后判断，于下一交易日进行指向切换，日内不会进行主力合约的切换。
3. 按照第二条规定产生新的主力合约之前，维持原来的主力合约不变。
4. 若出现当前主力合约的成交量和持仓量都不是最大的情况，当前指向合约在下一个交易日必须让出主力合约身份，金融期货新主力指向成交量最大的合约（中金所），商品期货新主力指向持仓量最大的合约（上期所、大商所、郑商所、上期能源）。
3. 次主力连续合约（期货连续合约，由真实合约拼接）：交易所.品种名 22对应次主力连续合约 symbol，如 CFFEX.IF22，CFFEX.IC22
次主力连续合约切换规则 1. 每个品种只选出唯一一个次主力合约。
2. 金融期货日成交量第二大、或商品期货日持仓量第二大的合约，确定为新的次主力合约，每日收盘结算后判断，于下一交易日进行指向切换，日内不会进行次主力合约的切换。
3. 按照第二条规定产生新的次主力合约之前，维持原来的次主力合约不变。
4. 若金融期货出现当前次主力合约的成交量、或商品期货出现当前次主力合约持仓量不是第二大的情况，当前指向合约在下一个交易日必须让出次主力合约身份，金融期货新主力指向成交量第二大的合约（中金所），商品期货新主力指向持仓量第二大的合约（上期所、大商所、郑商所、上期能源）。
4. 月份连续合约（期货连续合约，由真实合约拼接）：交易所.品种名月份排序对应月份连续合约 symbol，如 SHFE.RB00，SHFE.RB01，...，SHFE.RB04（同一品种最多有最近 5 个月的月份连续合约）
月份连续合约的切换规则 1. 该品种上市合约按交割月份排序
2. 00 对应最近月份合约，01 对应其后一个合约，02 对应再后一个合约，依次类推
3. 合约最后交易日盘后切换。
5. 当start_date 小于或等于 end_date时取指定时间段的数据,当start_date > end_date时返回报错。
股票增值数据函数(付费)
C++ 股票与指数数据 API 包含在 3.5.18 版本及以上版本
stk_get_industry_category - 查询行业分类
查询指定行业来源的行业列表
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkIndustryCategory>* stk_get_industry_category(const char *source = NULL, int level = 0);
参数：
参数名类型中文名称必填默认值参数用法说明
source str 行业来源 N 'zjh2012' 'zjh2012'- 证监会行业分类 2012（默认）， 'sw2021'- 申万行业分类 2021, 查看行业分类
level int 行业分级 N 1 1 - 一级行业（默认），2 - 二级行业，3 - 三级行业
返回值：
StkIndustryCategory 结构数组，参见StkIndustryCategory定义与DataArray类的用法。
示例：
stk_get_industry_category("sw2021", 2)
注意：
1. 证监会行业分类 2012 没有三级行业，若输入source='zjh2012', level=3则参数无效，返回空
stk_get_industry_constituents - 查询行业成分股
查询指定某个行业的成分股
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkIndustryConstituent>* stk_get_industry_constituents(const char *industry_code, const char *date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
industry_code str 行业代码 Y 无需要查询成分股的行业代码，可通过stk_get_industry_category获取, 查看行业分类
date str 查询日期 N NULL 查询行业成分股的指定日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
StkIndustryConstituent 结构数组，参见StkIndustryConstituent定义与DataArray类的用法。
示例：
stk_get_industry_constituents("A", "2022-09-05")
注意：
1. 只能指定一个行业代码查询成分股。
stk_get_symbol_industry - 查询股票的所属行业
查询指定股票所属的行业
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkSymbolIndustry>* stk_get_symbol_industry(const char *symbols, const char *source = NULL, int level = 0, const char *date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str 股票代码 Y 无多个代码可用，多个标的代码必须用英文逗号分割如："SHSE.600008,SZSE.000002"
source str 行业来源 N NULL 'zjh2012'- 证监会行业分类 2012（默认）， 'sw2021'- 申万行业分类 2021, 查看行业分类
level int 行业分级 N 0 1 - 一级行业（默认），2 - 二级行业，3 - 三级行业
date str 查询日期 N NULL 查询行业分类的指定日期，%Y-%m-%d 格式，默认""表示最新时间
返回值：
StkSymbolIndustry 结构数组，参见StkSymbolIndustry定义与DataArray类的用法。
示例：
stk_get_symbol_industry("SHSE.600000, SZSE.000002", "zjh2012", 1)
注意：
1. 证监会行业分类 2012 没有三级行业，若输入source='zjh2012', level=3则参数无效，返回空
stk_get_sector_category - 查询板块分类
查询指定类型的板块列表
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkSectorCategory>* stk_get_sector_category(const char *sector_type);
参数：
参数名类型中文名称必填默认值参数用法说明
sector_type str 板块类型 Y 无只能选择一种类型，可选择 1001:市场类 1002:地域类 1003:概念类, 查看板块分类
返回值：
StkSectorCategory 结构数组，参见StkSectorCategory定义与DataArray类的用法。
示例：
stk_get_sector_category("1003")
stk_get_sector_constituents - 查询板块成分股
查询指定某个板块的成分股
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkSectorConstituent>* stk_get_sector_constituents(const char *sector_code);
参数：
参数名类型中文名称必填默认值参数用法说明
sector_code str 板块代码 Y 无需要查询成分股的板块代码，可通过stk_get_sector_category获取, 查看板块分类
返回值：
StkSectorConstituent 结构数组，参见StkSectorConstituent定义与DataArray类的用法。
示例：
stk_get_sector_constituents("007089")
注意：
1. 只能指定一个板块代码查询成分股。
stk_get_symbol_sector - 查询股票的所属板块
查询指定股票所属的板块
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkSymbolSector>* stk_get_symbol_sector(const char *symbols, const char *sector_type);
参数：
参数名类型中文名称必填默认值参数用法说明
symbols str 股票代码 Y 无多个代码可用, 多个标的代码必须用英文逗号分割如："SHSE.600008,SZSE.000002"
sector_type str 板块类型 Y 无只能选择一种类型，可选择 1001:市场类 1002:地域类 1003:概念类
返回值：
StkSectorConstituent 结构数组，参见StkSectorConstituent定义与DataArray类的用法。
示例：
stk_get_symbol_sector("SHSE.600008,SZSE.000002", "1002")
stk_get_dividend - 查询股票分红送股信息
查询指定股票在一段时间内的分红送股信息
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StockDividend>* stk_get_dividend(const char *symbol, const char *start_date, const char *end_date);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 标的代码 Y 无必填，只能填一个股票标的
start_date str 开始时间 Y 无必填，开始时间日期（除权除息日），%Y-%m-%d 格式
end_date str 结束时间 Y 无必填，结束时间日期（除权除息日），%Y-%m-%d 格式
返回值：
StockDividend 结构数组，参见StockDividend定义与DataArray类的用法。
示例：
stk_get_dividend("SHSE.600000", "2022-07-01", "2022-07-31")
注意：
1. 当start_date小于或等于end_date 时取指定时间段的数据,当start_date>end_date时返回报错.
stk_get_ration - 查询股票配股信息
查询指定股票在一段时间内的配股信息
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkRation>* stk_get_ration(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 标的代码 Y 无必填，只能填一个股票标的
start_date str 开始时间 Y 无必填, 开始时间日期（除权除息日），%Y-%m-%d 格式
end_date str 结束时间 Y 无必填, 结束时间日期（除权除息日），%Y-%m-%d 格式
返回值：
StkRation 结构数组，参见StkRation定义与DataArray类的用法。
示例：
stk_get_ration("SZSE.000728", "2005-01-01", "2022-09-30")
注意：
1. 当start_date 小于或等于 end_date 时取指定时间段的数据,当start_date > end_date时返回报错.
stk_get_adj_factor - 查询股票的复权因子
查询某只股票在一段时间内的复权因子
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkAdjFactor>* stk_get_adj_factor(const char *symbol, const char *start_date = NULL, const char *end_date = NULL, const char *base_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 标的代码 Y 无必填，只能填一个股票标的
start_date str 开始时间 N NULL 开始时间交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
base_date str 复权基准日 N NULL 前复权的基准日，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
StkAdjFactor 结构数组，参见StkAdjFactor定义与DataArray类的用法。
示例：
stk_get_adj_factor("SZSE.000651", "2015-01-01", "2022-09-01")
注意：
1. T+1 日复权因子会二次更新，分别约在 T 日 19:00 和 T+1 日 19:00 更新
2. 复权价格计算： T日后复权价格 = T日不复权价格 * T日累计后复权因子 T日前复权价格 = T日不复权价格 * T日前复权因子
3. 上市首日后复权因子和累计后复权因子为 1，最近一次除权除息日后的前复权因子为 1
4. 前复权基准日base_date 应不早于设定的结束日期end_date，不晚于最新交易日。若设定的基准日早于end_date则等同于end_date，若设定的基准日晚于最新交易日则等同于最新交易日。
5. 当start_date小于或等于 end_date 时取指定时间段的数据,当start_date > end_date时返回报错.
stk_get_shareholder_num - 查询股东户数
查询上市公司股东总数，A 股股东、B 股股东、H 股股东总数
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkShareholderNum>* stk_get_shareholder_num(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的
start_date str 开始时间 N NULL 开始时间日期（公告日期），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（公告日期），%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
StkShareholderNum 结构数组，参见StkShareholderNum定义与DataArray类的用法。
示例：
stk_get_shareholder_num("SZSE.002594", "2022-01-01", "2022-08-01")
注意：
当start_date == end_date时，取离end_date最近公告日期的一条数据，当start_dat < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
stk_get_top_shareholder - 查询十大股东
查询上市公司前十大股东的持股情况，包括持股数量，所持股份性质等
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkShareholder>* stk_get_top_shareholder(const char *symbol, const char *start_date = NULL, const char *end_date = NULL, bool tradable_holder = false);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的
start_date str 开始时间 N NULL 开始时间日期（公告日期），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（公告日期），%Y-%m-%d 格式，默认NULL表示最新时间
tradable_holder bool 是否流通股东 N false false-十大股东（默认）、true-十大流通股东默认false表示十大股东
返回值：
StkShareholder 结构数组，参见StkShareholder定义与DataArray类的用法。
示例：
stk_get_top_shareholder("SHSE.603906", "2022-06-01", "2022-08-01")
注意：
当start_date == end_date时，取离end_date最近公告日期的一条数据，当start_dat < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
stk_get_share_change - 查询股本变动
查询上市公司的一段时间内公告的股本变动情况
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<StkShareChange>* stk_get_share_change(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 股票代码 Y 无必填，只能填一个股票标的
start_date str 开始时间 N NULL 开始时间日期（发布日期），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（发布日期），%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
StkShareChange 结构数组，参见StkShareChange定义与DataArray类的用法。
示例：
stk_get_share_change("SHSE.605090", "2020-01-01", "2022-10-01")
注意：
当start_date == end_date时，取离end_date最近发布日期的一条数据，当start_dat < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
期货增值数据函数(付费)
C++ 期货数据 API 包含在 3.5.18 版本及以上版本，不需要引入新库
fut_get_contract_info - 查询期货标准品种信息
查询交易所披露的期货标准品种的合约规格/合约文本
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FutContractInfo>* fut_get_contract_info(const char *product_codes);
参数：
参数名类型中文名称必填默认值参数用法说明
product_codes str 品种代码 Y 无必填，交易品种代码，如：IF，AL 多个代码可用，多个标的代码必须用英文逗号分割，如：IF, AL
返回值：
FutContractInfo 结构数组，参见FutContractInfo定义与DataArray类的用法。
示例：
fut_get_contract_info("IF")
fut_get_transaction_ranking - 查询期货每日成交持仓排名
查询期货合约每日成交量/持买单量/持卖单量排名
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FutTransactionRanking>* fut_get_transaction_ranking(const char *symbol, const char *trade_date = NULL, const char *indicator = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 期货合约代码 Y 无必填，期货真实合约代码
trade_date str 交易日期 N NULL 交易日期，%Y-%m-%d 格式，默认NULL表示最新交易日
indicator str 排名指标 N NULL 用于排名的依据，可选： 'volume'-成交量排名（默认NULL表示成交量排名） 'long'-持买单量排名 'short'-持卖单量排名
返回值：
FutTransactionRanking 结构数组，参见FutTransactionRanking定义与DataArray类的用法。
示例：
fut_get_transaction_ranking("SHFE.ag2212", "2022-10-10", "volume")
注意：
1. 当上一交易日没有进入前 20 名，ranking_change返回 0.
2. 数据日频更新，当日更新前返回前一交易日的排名数据，约在交易日 20 点左右更新当日数据。
fut_get_warehouse_receipt - 查询期货仓单数据
查询交易所在交易日期货品种的注册仓单数量、有效预报
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
期货仓单是指由期货交易所指定交割仓库，按照期货交易所指定的程序，签发的符合合约规定质量的实物提货凭证。记录了交易所所有期货实物的库存情况以及变更情况。
函数原型：
DataArray<FutWarehouseReceiptInfo>* fut_get_warehouse_receipt(const char *product_code, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
product_code str 品种代码 Y 无必填，只能填写一个交易品种代码，如：AL
start_date str 开始时间 N NULL 开始时间日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
FutWarehouseReceiptInfo 结构数组，参见FutWarehouseReceiptInfo定义与DataArray类的用法。
示例：
fut_get_warehouse_receipt("AL", "2023-06-20", "2023-06-29")
注意：
1. 支持郑商所、大商所、上期所和上海国际能源交易中心的期货品种。
2. 注册仓单数量每日更新，其余数据上期所一周一披露，郑商所一天一披露。
3. 当start_date 小于或等于 end_date 时, 取指定时间段的数据,当 start_date > end_date 时, 返回报错。
基金增值数据函数(付费)
C++ 基金数据 API 包含在 3.5.18 版本及以上版本
fnd_get_etf_constituents - 查询 ETF 最新成分股
查询某只 ETF 在最新交易日的成分股持有情况和现金替代信息
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FndEtfConstituents>* fnd_get_etf_constituents(const char *symbol);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str ETF 代码 Y 无必填，只能输入一个 symbol, 如：SZSE.159919
返回值：
FndEtfConstituents 结构数组，参见FndEtfConstituents定义与DataArray类的用法。
示例：
fnd_get_etf_constituents("SHSE.510050")
注意：
1. 只返回上交所、深交所的成分股，不提供其余交易所的成分股票。
fnd_get_stock_portfolio - 查询基金资产组合(股票投资组合)
查询某只基金在指定日期的基金资产组合(股票投资组合)
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FndPortfolioStockInfo>* fnd_get_stock_portfolio(const char *symbol, int report_type, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 基金代码 Y 无必填，只能输入一个基金的[symbol]，如：SZSE.161133
report_type int 报表类别 Y 无公布持仓所在的报表类别，必填，可选： 1:第一季度 2:第二季度 3:第三季报 4:第四季度 6:中报 9:前三季报 12:年报
start_date str 开始时间 N NULL 开始时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
FndPortfolioStockInfo 结构数组，参见FndPortfolioStockInfo定义与DataArray类的用法。
示例：
fnd_get_stock_portfolio("SHSE.510300", 1)
注意：
1. 仅提供场内基金（ETF、LOF、FOF-LOF）的资产组合数据。
2. 当start_date == end_date时，取离end_date最近公告日期的一条数据，当start_dat < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
fnd_get_bond_portfolio - 查询基金资产组合(债券投资组合)
查询某只基金在指定日期的基金资产组合(债券投资组合)
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FndPortfolioBondInfo>* fnd_get_bond_portfolio(const char *symbol, int report_type, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 基金代码 Y 无必填，只能输入一个基金的[symbol]，如：SZSE.161133
report_type int 报表类别 Y 无公布持仓所在的报表类别，必填，可选： 1:第一季度 2:第二季度 3:第三季报 4:第四季度 6:中报 9:前三季报 12:年报
start_date str 开始时间 N NULL 开始时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
FndPortfolioBondInfo 结构数组，参见FndPortfolioBondInfo定义与DataArray类的用法。
示例：
fnd_get_bond_portfolio("SHSE.510300", 1)
注意：
1. 仅提供场内基金（ETF、LOF、FOF-LOF）的资产组合数据。
2. 当start_date == end_date时，取离end_date最近公告日期的一条数据，当start_dat < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
fnd_get_fund_portfolio - 查询基金资产组合(基金投资组合)
查询某只基金在指定日期的基金资产组合(基金投资组合)
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FndPortfolioFundInfo>* fnd_get_fund_portfolio(const char *symbol, int report_type, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 基金代码 Y 无必填，只能输入一个基金的[symbol]，如：SZSE.161133
report_type int 报表类别 Y 无公布持仓所在的报表类别，必填，可选： 1:第一季度 2:第二季度 3:第三季报 4:第四季度 6:中报 9:前三季报 12:年报
start_date str 开始时间 N NULL 开始时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
FndPortfolioFundInfo 结构数组，参见FndPortfolioFundInfo定义与DataArray类的用法。
注意：
1. 仅提供场内基金（ETF、LOF、FOF-LOF）的资产组合数据。
2. 当start_date == end_date时，取离end_date最近公告日期的一条数据，当start_dat < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
fnd_get_net_value - 查询基金净值数据
查询某只基金在指定时间段的基金净值数据
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FndNetValueInfo>* fnd_get_net_value(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 基金代码 Y 无必填，只能输入一个基金的[symbol]如：SZSE.159919
start_date str 开始时间 N NULL 开始时间日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
FndNetValueInfo 结构数组，参见FndNetValueInfo定义与DataArray类的用法。
示例：
fnd_get_net_value("SHSE.510300")
注意：
1. 仅提供场内基金（ETF、LOF、FOF-LOF）的净值数据。
2. 当start_date == end_date时，取离end_date最近日期的一条数据，当start_date < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
fnd_get_adj_factor - 查询基金复权因子
查询某只基金在一段时间内的复权因子
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FndAdjFactorInfo>* fnd_get_adj_factor(const char *symbol, const char *start_date = NULL, const char *end_date = NULL, const char *base_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 基金代码 Y 无必填，只能输入一个基金的[symbol]，如：SZSE.159919
start_date str 开始时间 N NULL 开始时间交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间交易日期，%Y-%m-%d 格式，默认NULL表示最新时间
base_date str 复权基准日 N NULL 前复权的基准日，%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
FndAdjFactorInfo 结构数组，参见FndAdjFactorInfo定义与DataArray类的用法。
示例：
fnd_get_adj_factor("SHSE.510300")
注意：
1. T+1 日复权因子会二次更新，分别在 T 日 19:00 和 T+1 日 19:00 更新。仅提供场内基金（ETF、LOF、FOF-LOF）的复权因子数据。
2. 复权价格计算： T日后复权价格 = T日不复权价格 * T日累计后复权因子 T日前复权价格 = T日不复权价格 * T日前复权因子
3. 上市首日后复权因子合累计后复权因子为 1，最近一次除权除息日后的交易日前复权因子为 1
4. 前复权基准日base_date应不早于设定的结束日期end_date，不晚于最新交易日。若设定的基准日早于end_date则等同于end_date，若设定的基准日晚于最新交易日则等同于最新交易日。
5. 当start_date 小于或等于 end_date 时取指定时间段的数据,当start_date > end_date时返回报错.
fnd_get_dividend - 查询基金分红信息
查询指定基金在一段时间内的分红信息
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FndDividendInfo>* fnd_get_dividend(const char *symbol, const char *start_date, const char *end_date);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 基金代码 Y 无必填，只能输入一个基金的[symbol], 如：SZSE.159919
start_date str 开始时间 Y 无必填，开始时间日期（场内除息日），%Y-%m-%d 格式
end_date str 结束时间 Y 无必填，结束时间日期（场内除息日），%Y-%m-%d 格式
返回值：
FndDividendInfo 结构数组，参见FndDividendInfo定义与DataArray类的用法。
示例：
fnd_get_dividend("SHSE.510300", "2021-1-1", "2023-1-1")
fnd_get_split - 查询基金拆分折算信息
查询指定基金在一段时间内的拆分折算信息
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<FndSplitInfo>* fnd_get_split(const char *symbol, const char *start_date, const char *end_date);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 基金代码 Y 无必填，只能输入一个基金的[symbol]，如：SZSE.159919
start_date str 开始时间 Y 无必填，开始时间日期（场内除权日），%Y-%m-%d 格式
end_date str 结束时间 Y 无必填，结束时间日期（场内除权日），%Y-%m-%d 格式
返回值：
FndSplitInfo 结构数组，参见FndSplitInfo定义与DataArray类的用法。
示例：
fnd_get_split("SZSE.161725", "2000-01-01", "2022-09-07")
可转债增值数据函数(付费)
C++ 可转债数据 API 包含在 3.5.18 版本及以上版本
bnd_get_conversion_price - 查询可转债转股价变动信息
查询可转债一段时间的转股价变动和转股结果
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<BndConversionPrice>* bnd_get_conversion_price(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 可转债代码 Y 无必填，只能输入一个可转债的[symbol]
start_date str 开始时间 N NULL 开始时间日期（转股价格生效日），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（转股价格生效日），%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
BndConversionPrice 结构数组，参见BndConversionPrice定义与DataArray类的用法。
示例：
bnd_get_conversion_price("SZSE.123015")
注意：
1. 本期转股数、累计转股金额、债券流通余额在执行日期收盘后才有数据。
2. 当start_date == end_date时，取离end_date最近转股价格生效日期的一条数据，当start_date < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
bnd_get_call_info - 查询可转债赎回信息
查询可转债一段时间内的赎回情况
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<BndCallInfo>* bnd_get_call_info(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 可转债代码 Y 无必填，只能输入一个可转债的[symbol]
start_date str 开始时间 N NULL 开始时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
BndCallInfo 结构数组，参见BndCallInfo定义与DataArray类的用法。
示例：
bnd_get_call_info("SHSE.110041")
注意：
当start_date == end_date时，取离end_date最近公告日的一条数据，当start_date < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
bnd_get_put_info - 查询可转债回售信息
查询可转债一段时间内的回售情况
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<BndPutInfo>* bnd_get_put_info(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 可转债代码 Y 无必填，只能输入一个可转债的[symbol]
start_date str 开始时间 N NULL 开始时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
BndPutInfo 结构数组，参见BndPutInfo定义与DataArray类的用法。
示例：
bnd_get_put_info("SZSE.128015")
注意：
当start_date == end_date时，取离end_date最近公告日的一条数据，当start_date < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
bnd_get_amount_change - 查询可转债剩余规模变动
查询可转债转股、回售、赎回等事件导致的剩余规模变动的情况
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<BndAmountChange>* bnd_get_amount_change(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
参数名类型中文名称必填默认值参数用法说明
symbol str 可转债代码 Y 无必填，只能输入一个可转债的[symbol]
start_date str 开始时间 N NULL 开始时间日期（变动日期），%Y-%m-%d 格式，默认NULL表示最新时间
end_date str 结束时间 N NULL 结束时间日期（变动日期），%Y-%m-%d 格式，默认NULL表示最新时间
返回值：
BndAmountChange 结构数组，参见BndAmountChange定义与DataArray类的用法。
示例：
bnd_get_amount_change("SZSE.123015")
注意：
1. 变动类型指定为首发时，返回的剩余金额为发行金额。
2. 当start_date == end_date时，取离end_date最近变动日期的一条数据，当start_date < end_date时，取指定时间段的数据，当start_date > end_date时，返回报错。
老版本数据函数
以下接口在终端版本号大于 3.17.0.0 的版本不再维护，请切换到新的通用接口
get_fundamentals - 查询基本面数据
函数原型：
DataSet* get_fundamentals(const char *table, const char *symbols, const char *start_date, const char *end_date, const char *fields, const char *filter = NULL, const char *order_by = NULL, int limit = 1000);
参数：
参数名类型说明
table const char* 表名，只支持单表查询. 具体表名及 fields 字段名及 filter 可过滤的字段参考财务数据文档
symbols const char* 标的代码, 多个代码可用 ,(英文逗号)分割
start_date const char* 开始时间, (%Y-%m-%d 格式)
end_date const char* 结束时间, (%Y-%m-%d 格式)
fields const char* 查询字段 (必填)
| limit | int | 数量. 为保护服务器, 一次查询最多返回 40000 条记录 | | 返回值 | DataSet* | 一个结果集 |
示例：
例 1: 取股票代码 SHSE.600000, SZSE.000001, 离 2017-01-01 最近一个交易日的股票交易财务衍生表的 TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI 字段的值
DataSet* ds = get_fundamentals("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 字段的值
DataSet* ds = get_fundamentals("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 字段的值
DataSet* ds = get_fundamentals("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 的资产负债的数据
DataSet* ds = get_fundamentals("balance_sheet", "2016-01-20", "2016-01-20", "CURFDS, SETTRESEDEPO, PLAC, TRADFINASSET, ', symbols="SHSE.600000, SZSE.000001", "CURFDS > 0 and TOTLIABSHAREQUI > 0" )
注意：
1. 当 start_date == end_date 时, 取所举每个股票离 end_date 最近业务日期(交易日期或报告日期) 一条数据,当 start_date < end_date 时, 取指定时间段的数据,当 start_date > end_date 时, 返回空
2. start_date 和 end_date 中月,日均可以只输入个位数,例:"2010-7-8"或"2017-7-30"
3. 在该函数中，table 参数只支持输入一个表名，若表名输入错误或以"table1,table2"方式输入多个表名，函数返回空结果集
4. 若表名输入正确，但查询字段中出现非指定字符串，则返回错误
get_fundamentals_n - 查询基本面数据最新 n 条
取指定股票的最近 end_date 的 n 条记录
函数原型：
DataSet* get_fundamentals_n(const char *table, const char *symbols, const char *end_date, const char *fields, int n = 1, const char *filter = NULL, const char * order_by = NULL);
参数：
参数名类型说明
table const char * 表名. 具体表名及 fields 字段名及 filter 可过滤的字段参考财务数据文档
symbols const char * 标的代码, 多个代码可用 ,(英文逗号)分割
end_date const char * 结束时间, (%Y-%m-%d 格式)
fields const char * 查询字段 (必填)
n int 每个股票取最近的数量(正整数)
返回值 DataSet* 一个结果集
示例：
例: 取股票代码 SHSE.600000, SZSE.000001, 离 2017-01-01 最近 3 条(每个股票都有 3 条) 股票交易财务衍生表的 TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI 字段的值
DataSet* ds = get_fundamentals_n("trading_derivative_indicator", "SHSE.600000, SZSE.000001", "2017-01-01", 3, "TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI")
注意：
1. end_date 中月,日均可以只输入个位数,例:'2010-7-8'或'2017-7-30'
2. 在该函数中，table 参数只支持输入一个表名，若表名输入错误或以'table1,table2'方式输入多个表名，函数返回空结果集
3. 若表名输入正确，但查询字段中出现非指定字符串，则返回错误
get_instruments - 查询最新交易标的信息
查询最新交易标的信息,有基本数据及最新日频数据
函数原型：
DataSet* get_instruments(const char *exchanges = NULL, const char *sec_types = NULL, const char* fields = NULL);
参数：
参数名类型说明
exchanges const char * 交易所代码, 多个交易所代码可用 ,(英文逗号)分割, NULL 表示所有
sec_types const char * 指定类别, 品种类型，stock: 股票, fund: 基金, index: 指数, future: 期货, bond: 债券, bond_convertible: 可转债, option: 期权, confuture: 期货连续合约, 多个品种可用 ,(英文逗号)分割, NULL 表示所有品种
fields const char * 查询字段默认 NULL 表示所有
返回值 DataSet* 一个结果集
字段：
字段名类型说明
symbol string 标的代码
sec_level int 1-正常,2-ST 股票,3-*ST 股票,4-股份转让,5-处于退市整理期的证券,6-上市开放基金 LOF,7-交易型开放式指数基金(ETF),8-非交易型开放式基金(暂不交易,仅揭示基金净值及开放申购赎回业务),9-仅提供净值揭示服务的开放式基金;,10-仅在协议交易平台挂牌交易的证券,11-仅在固定收益平台挂牌交易的证券,12-风险警示产品,13-退市整理产品,99-其它
is_suspended int 是否停牌. 1: 是, 0: 否
multiplier double 合约乘数
margin_ratio double 保证金比率
settle_price double 结算价
position int 持仓量
pre_close double 昨收价
pre_settle double 昨结算价
upper_limit double 涨停价（首次公开发行上市的股票上市前 5 日无涨跌停价，返回0）
lower_limit double 跌停价（首次公开发行上市的股票上市前 5 日无涨跌停价，返回0）
adj_factor double 复权因子.基金跟股票才有
created_at longlong(utc) 交易日期
示例：
//取深交所所有代码 DataSet* ds = get_instruments("SZSE"); //取深交所所有股票和基金 DataSet* ds = get_instruments("SZSE", "stock,fund");
注意：
1. 停牌时且股票发生除权除息, 涨停价和跌停价可能有误差
2. 预上市股票以 1900-01-01 为虚拟发布日期，未退市股票以 2038-01-01 为虚拟退市日期。
get_history_instruments - 查询交易标的历史数据
返回指定 symbols 的标的日频历史数据
函数原型：
DataSet* get_history_instruments(const char *symbols, const char *start_date, const char *end_date, const char *fields = NULL);
参数：
参数名类型说明
symbols const char * 标的代码, 多个代码可用 ,(英文逗号)分割
start_date const char * 开始时间. (%Y-%m-%d 格式)
end_date const char * 结束时间. (%Y-%m-%d 格式)
fields const char * 查询字段. NULL 表示所有字段
返回值 DataSet* 一个结果集
字段：
字段名类型说明
symbol string 标的代码
sec_level int 1-正常,2-ST 股票,3-*ST 股票,4-股份转让,5-处于退市整理期的证券,6-上市开放基金 LOF,7-交易型开放式指数基金(ETF),8-非交易型开放式基金(暂不交易,仅揭示基金净值及开放申购赎回业务),9-仅提供净值揭示服务的开放式基金;,10-仅在协议交易平台挂牌交易的证券,11-仅在固定收益平台挂牌交易的证券,12-风险警示产品,13-退市整理产品,99-其它
is_suspended int 是否停牌. 1: 是, 0: 否
multiplier double 合约乘数
margin_ratio double 保证金比率
settle_price double 结算价
position int 持仓量
pre_close double 昨收价
pre_settle double 昨结算价
upper_limit double 涨停价（首次公开发行上市的股票上市前 5 日无涨跌停价，返回0）
lower_limit double 跌停价（首次公开发行上市的股票上市前 5 日无涨跌停价，返回0）
adj_factor double 复权因子.基金跟股票才有
created_at longlong(utc) 交易日期
示例：
get_history_instruments(symbols="SZSE.000001,SZSE.000002", start_date="2017-09-19", end_date="2017-09-19");
注意：
1. 停牌时且股票发生除权除息, 涨停价和跌停价可能有误差
2. 为保护服务器, 单次查询最多返回 33000 条记录
3. start_date 和 end_date 中月,日均可以只输入个位数,例:'2010-7-8'或'2017-7-30'
get_instrumentinfos - 查询交易标的基本信息
获取到交易标的基本信息, 与时间无关.
函数原型：
DataSet* get_instrumentinfos(const char *symbols = NULL, const char *exchanges = NULL, const char * sec_types = NULL, const char *names = NULL, const char *fields = NULL);
参数：
参数名类型说明
symbols const char * 标的代码, 多个代码可用 ,(英文逗号)分割, NULL 表示所有
exchanges const char * 交易市场代码, 多个交易所代码可用 ,(英文逗号)分割, NULL 表示所有市场
sec_types const char * 指定类别, 品种类型， stock: 股票, fund: 基金, index: 指数, future: 期货, option: 期权, confuture: 期货连续合约, 多个品种可用 ,(英文逗号)分割, NULL 表示所有品种
names const char * 查询代码, NULL 表示所有
fields const char * 查询字段 NULL 表示所有
返回值 DataSet* 一个结果集
字段：
字段名类型说明
symbol string 标的代码
sec_type int 1: 股票, 2: 基金, 3: 指数, 4: 期货, 5: 期权, 10: 期货连续合约
exchange string 见交易所代码
sec_id string 代码
sec_name string 名称
price_tick double 最小变动单位
listed_date longlong(utc) 上市日期
delisted_date longlong(utc) 退市日期
示例：
DataSet* ds = get_instrumentinfos("SHSE.000001,SHSE.000002");
注意：
1. 对于检索所需标的信息的 4 种手段symbols,exchanges,sec_types,names,若输入参数之间出现任何矛盾（换句话说，所有的参数限制出满足要求的交集为空),则返回空结果集例如get_instrumentinfos("SZSE","4") 返回的是空结果集
get_constituents - 查询指数成份股
函数原型：
DataSet* get_constituents(const char *index, const char *trade_date = NULL);
参数：
参数名类型说明
index const char * 表示指数的 symbol,比如上证指数 SHSE.000001, 不支持多个 symbol
trade_date const char * 交易日 (%Y-%m-%d 格式) NULL 表示最新日期
返回值 DataSet* 一个结果集
字段：
字段名类型说明
symbol string 标的代码
weight double 权重
示例：
DataSet* ds = get_constituents("SHSE.000001", "2017-07-10");
注意：
1. trade_date 中月,日均可以只输入个位数,例:"2010-7-8"或"2017-7-30",但若对应位置为零，则0不可被省略
get_industry - 查询行业股票列表
函数原型：
DataArray<Symbol>* get_industry(const char *code);
参数：
参数名类型说明
code const char * 行业代码
返回值 DataArray* 一个 symbol 数组
示例：
#返回所有以J6开头的行业代码对应的成分股(包括:J66,J67,J68,J69的成分股) DataArray<Symbol>* da = get_industry("j6");
注意：
1. 在该函数中，code 参数只支持输入一个行业代码
get_trading_dates - 查询交易日历
函数原型：
DataArray<TradingDate>* get_trading_dates(const char *exchange, const char *start_date, const char *end_date);
参数：
参数名类型说明
exchange const char * 交易市场代码
start_date const char * 开始时间 (%Y-%m-%d 格式)
end_date const char * 结束时间 (%Y-%m-%d 格式)
返回值 DataArray* 一个交易日数组
示例：
DataArray<TradingDate>* da = get_trading_dates("SZSE", "2017-01-01", "2017-01-30");
注意：
1. exchange参数仅支持输入单个交易所代码
2. start_date和end_date中月,日均可以只输入个位数,
例:'2010-7-8'或'2017-7-30'
get_previous_trading_date - 返回指定日期的上一个交易日
函数原型：
int get_previous_trading_date(const char *exchange, const char *date, char *output_date);
参数：
参数名类型说明
exchange const char * 交易市场代码
date const char * 时间 (%Y-%m-%d 格式)
output_date char * 出参，返回值，上一个交易日，字符串格式，由用户分配 buf, 大于 32 字节即可
返回值 int 0 表示成功，非 0 表示失败
示例：
char trading_date[32] = {0}; get_previous_trading_date("SZSE", "2017-05-01", trading_date);
注意：
1. exchange参数仅支持输入单个交易所代码
2. date中月,日均可以只输入个位数,
例:"2010-7-8"或"2017-7-30"
get_next_trading_date - 返回指定日期的下一个交易日
函数原型：
int get_next_trading_date(const char *exchange, const char *date, char *output_date);
参数：
参数名类型说明
exchange const char * 交易市场代码
date const char * 时间 (%Y-%m-%d 格式)
output_date char * 出参，返回值，下一个交易日，字符串格式，由用户分配 buf, 大于 32 字节即可
返回值 int 0 表示成功，非 0 表示失败
示例：
char trading_date[32] = {0}; get_next_trading_date(exchange="SZSE", date="2017-05-01", trading_date);
注意：
1. exchange参数仅支持输入单个交易所代码
2. date中月,日均可以只输入个位数,
例:"2010-7-8"或"2017-7-30"
get_dividend - 查询分红送配
函数原型：
DataSet* get_dividend(const char *symbol, const char *start_date, const char *end_date);
参数：
参数名类型说明
symbol const char * 标的代码, (必填)
start_date const char * 开始时间 (%Y-%m-%d 格式)
end_date const char * 结束时间 (%Y-%m-%d 格式)
返回值 DataSet* 一个结果集
字段：
字段名类型说明
symbol string 标的代码
cash_div double 每股派现
allotment_ratio double 每股配股比例
allotment_price double 配股价
share_div_ratio double 每股送股比例
share_trans_ratio double 每股转增比例
示例：
DataSet* ds = get_dividend("SHSE.600000", "2000-01-01", "2017-12-31");
注意：
1. 在该函数中，symbol 参数只支持输入一个标的代码
2. start_date和end_date中月,日均可以只输入个位数,
例:'2010-7-8'或'2017-7-30'
get_continuous_contracts - 获取连续合约
函数原型：
DataSet* get_continuous_contracts(const char *csymbol, const char *start_date, const char *end_date);
参数：
参数名类型说明
csymbol const char * 期货连续合约代码, 比如获取主力合约，输入 SHFE.AG;获取连续合约，输入 SHFE.AG01
start_date const char * 开始时间 (%Y-%m-%d 格式)
end_date const char * 结束时间 (%Y-%m-%d 格式)
返回值 DataSet* 一个结果集
字段：
字段名类型说明
symbol string 真实合约
created_at longlong(utc) 交易日
示例：
DataSet* get_continuous_contracts"SHFE.AG", "2017-07-01", "2017-08-01");
注意：
1. 在该函数中，csymbol 参数只支持输入一个标的代码
2. start_date和end_date中月,日均可以只输入个位数,
例:'2017-7-1'或'2017-8-1'

分享到QQ

分享到微博

如果你对这篇内容有疑问，欢迎到本站社区发帖提问参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。

发布评论

需要登录才能够评论，你可以免费注册一个本站的账号。

列表为空，暂无数据

开始入门

操作指引

SDK

数据文档

常见问题

量化工具

其他

其他

数据查询函数

行情数据查询函数（免费）

current - 查询当前行情快照

history_ticks - 查询历史 Tick 行情

history_bars - 查询历史 Bar 行情

history_ticks_n - 查询最新 n 条 Tick 行情

history_bars_n - 查询最新 n 条 Bar 行情

history_l2ticks - 查询历史 L2-Tick 行情

history_l2bars - 查询历史 L2-Bar 行情

history_l2transactions - 查询历史 L2 逐笔成交

history_l2orders - 查询历史 L2 逐笔委托

history_l2orders_queue - 查询历史 L2 委托队列

通用数据函数（免费）

get_symbol_infos - 查询标的基本信息

get_symbols_by_date - 查询指定交易日多标的交易信息

get_history_symbol - 查询指定标的多日交易信息

get_trading_dates_by_year - 查询年度交易日历

get_trading_session - 查询交易时段

get_contract_expire_rest_days - 查询合约到期剩余天数

股票财务数据及基础数据函数(免费)

stk_get_index_constituents - 查询指数成分股

stk_get_fundamentals_balance - 查询资产负债表数据

fut_get_continuous_contracts - 查询连续合约对应的真实合约

股票增值数据函数(付费)

stk_get_industry_category - 查询行业分类

stk_get_industry_constituents - 查询行业成分股

stk_get_symbol_industry - 查询股票的所属行业

stk_get_sector_category - 查询板块分类

stk_get_sector_constituents - 查询板块成分股

stk_get_symbol_sector - 查询股票的所属板块

stk_get_dividend - 查询股票分红送股信息

stk_get_ration - 查询股票配股信息

stk_get_adj_factor - 查询股票的复权因子

stk_get_shareholder_num - 查询股东户数

stk_get_top_shareholder - 查询十大股东

stk_get_share_change - 查询股本变动

期货增值数据函数(付费)

fut_get_contract_info - 查询期货标准品种信息

fut_get_transaction_ranking - 查询期货每日成交持仓排名

fut_get_warehouse_receipt - 查询期货仓单数据

基金增值数据函数(付费)

fnd_get_etf_constituents - 查询 ETF 最新成分股

fnd_get_stock_portfolio - 查询基金资产组合(股票投资组合)

fnd_get_bond_portfolio - 查询基金资产组合(债券投资组合)

fnd_get_fund_portfolio - 查询基金资产组合(基金投资组合)

fnd_get_net_value - 查询基金净值数据

fnd_get_adj_factor - 查询基金复权因子

fnd_get_dividend - 查询基金分红信息

fnd_get_split - 查询基金拆分折算信息

可转债增值数据函数(付费)

bnd_get_conversion_price - 查询可转债转股价变动信息

bnd_get_call_info - 查询可转债赎回信息

bnd_get_put_info - 查询可转债回售信息

bnd_get_amount_change - 查询可转债剩余规模变动

老版本数据函数

get_fundamentals - 查询基本面数据

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

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

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

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

get_constituents - 查询指数成份股

get_industry - 查询行业股票列表

get_trading_dates - 查询交易日历

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

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

get_dividend - 查询分红送配

get_continuous_contracts - 获取连续合约

如果你对这篇内容有疑问，欢迎到本站社区发帖提问 参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。

发布评论

`current` - 查询当前行情快照

`history_ticks` - 查询历史 Tick 行情

`history_bars` - 查询历史 Bar 行情

`history_ticks_n` - 查询最新 n 条 Tick 行情

`history_bars_n` - 查询最新 n 条 Bar 行情

`history_l2ticks` - 查询历史 L2-Tick 行情

`history_l2bars` - 查询历史 L2-Bar 行情

`history_l2transactions` - 查询历史 L2 逐笔成交

`history_l2orders` - 查询历史 L2 逐笔委托

`history_l2orders_queue` - 查询历史 L2 委托队列

`get_symbol_infos` - 查询标的基本信息

`get_symbols_by_date` - 查询指定交易日多标的交易信息

`get_history_symbol` - 查询指定标的多日交易信息

`get_trading_dates_by_year` - 查询年度交易日历

`get_trading_session` - 查询交易时段

`get_contract_expire_rest_days` - 查询合约到期剩余天数

`stk_get_index_constituents` - 查询指数成分股

`stk_get_fundamentals_balance` - 查询资产负债表数据

`fut_get_continuous_contracts` - 查询连续合约对应的真实合约

`stk_get_industry_category` - 查询行业分类

`stk_get_industry_constituents` - 查询行业成分股

`stk_get_symbol_industry` - 查询股票的所属行业

`stk_get_sector_category` - 查询板块分类

`stk_get_sector_constituents` - 查询板块成分股

`stk_get_symbol_sector` - 查询股票的所属板块

`stk_get_dividend` - 查询股票分红送股信息

`stk_get_ration` - 查询股票配股信息

`stk_get_adj_factor` - 查询股票的复权因子

`stk_get_shareholder_num` - 查询股东户数

`stk_get_top_shareholder` - 查询十大股东

`stk_get_share_change` - 查询股本变动

`fut_get_contract_info` - 查询期货标准品种信息

`fut_get_transaction_ranking` - 查询期货每日成交持仓排名

`fut_get_warehouse_receipt` - 查询期货仓单数据

`fnd_get_etf_constituents` - 查询 ETF 最新成分股

`fnd_get_stock_portfolio` - 查询基金资产组合(股票投资组合)

`fnd_get_bond_portfolio` - 查询基金资产组合(债券投资组合)

`fnd_get_fund_portfolio` - 查询基金资产组合(基金投资组合)

`fnd_get_net_value` - 查询基金净值数据

`fnd_get_adj_factor` - 查询基金复权因子

`fnd_get_dividend` - 查询基金分红信息

`fnd_get_split` - 查询基金拆分折算信息

`bnd_get_conversion_price` - 查询可转债转股价变动信息

`bnd_get_call_info` - 查询可转债赎回信息

`bnd_get_put_info` - 查询可转债回售信息

`bnd_get_amount_change` - 查询可转债剩余规模变动

`get_fundamentals` - 查询基本面数据

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

`get_instruments` - 查询最新交易标的信息

`get_history_instruments` - 查询交易标的历史数据

`get_instrumentinfos` - 查询交易标的基本信息

`get_constituents` - 查询指数成份股

`get_industry` - 查询行业股票列表

`get_trading_dates` - 查询交易日历

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

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

`get_dividend` - 查询分红送配

`get_continuous_contracts` - 获取连续合约

如果你对这篇内容有疑问，欢迎到本站社区发帖提问参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。