Question

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时，返回报错。

stk_abnor_change_stocks - 查询龙虎榜股票数据

查询指定时间段龙虎榜股票数据

此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.6.14 版本新增

函数原型：

DataArray<StkAbnorChangeStocks>* stk_abnor_change_stocks(const char *symbols = NULL, const char *change_types = NULL, const char *trade_date = NULL);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbols	str	股票代码	N	NULL	输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002"; 默认NULL表示所有标的。
change_types	str	异动类型	N	NULL	输入异动类型，可输入多个. 多个异动类型必须用英文逗号分割，如："106,107"; 默认NULL表示所有异动类型。龙虎榜异动类型列表
trade_date	str	交易日期	N	NULL	交易日期，%Y-%m-%d 格式，默认NULL表示最新交易日期。

返回值：

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

示例：

stk_abnor_change_stocks(NULL, "106")

输出：

注意：

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

2. trade_date输入非交易日，会返回空。

stk_abnor_change_detail - 查询龙虎榜营业部数据

查询指定时间段龙虎榜营业数据

此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.6.14 版本新增

函数原型：

DataArray<StkAbnorChangeDetail>* stk_abnor_change_detail(const char *symbols = NULL, const char *change_types = NULL, const char *trade_date = NULL)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbols	str	股票代码	N	NULL	输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002"; 默认NULL表示所有标的。
change_types	str	异动类型	N	NULL	输入异动类型，可输入多个. 多个异动类型必须用英文逗号分割，如："106,107"; 默认NULL表示所有异动类型。龙虎榜异动类型列表
trade_date	str	交易日期	N	NULL	交易日期，%Y-%m-%d 格式，默认NULL表示最新交易日期。

返回值：

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

示例：

stk_abnor_change_detail("SZSE.300799", NULL, "2024-01-23")

注意：

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

2. trade_date输入非交易日，会返回空。

stk_quota_shszhk_infos - 查询沪深港通额度数据

查询指定时间段沪深港通额度数据

此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.6.14 版本新增

函数原型：

DataArray<StkQuotaShszhkInfos>* stk_quota_shszhk_infos(const char *types = NULL, const char *start_date = NULL, const char *end_date = NULL, int count = 0)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
types	str	类型	N	NULL	类型，可输入多个，多个类型必须用英文逗号分割，如："SZ,SHHK" , 类型包括：SH - 沪股通 ，SHHK - 沪港股通 ，SZ - 深股通 ，SZHK - 深港股通，NF - 北向资金（沪股通+深股通），默认 NULL 为全部北向资金。
start_date	str	开始日期	N	NULL	开始日期，%Y-%m-%d 格式，默认NULL表示最新交易日期。
end_date	str	结束日期	N	NULL	结束日期，%Y-%m-%d 格式，默认NULL表示最新交易日期。
count	int	交易日数量	N	0	数量(正整数)，不能与start_date同时使用，否则返回报错；与 end_date 同时使用时，表示获取 end_date 前 count 个交易日的数据(包含 end_date 当日)；默认为 0 ，不使用该字段。

返回值：

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

示例：

stk_quota_shszhk_infos("SHHK", NULL, "2024-01-23", 1)

注意：

1. 当start_date == end_date时，取离end_date最近公告日期的一条数据， 当start_dat < end_date时，取指定时间段的数据， 当start_date > end_date时，返回报错。

2. count不能与start_date同时使用，否则返回报错；与 end_date 同时使用时，表示获取 end_date 前 count 个交易日的数据(包含 end_date 当日)；默认为 0 ，不使用该字段。

stk_hk_inst_holding_detail_info - 查询沪深港通标的港股机构持股明细数据

查询沪深港通标的港股机构持股明细数据

此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.6.14 版本新增

函数原型：

DataArray<StkHkInstHoldingDetailInfo>* stk_hk_inst_holding_detail_info(const char *symbols = NULL, const char *trade_date = NULL)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbol	str	股票代码	N	NULL	输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002" 默认NULL表示所有标的。
trade_date	str	交易日期	N	NULL	交易日期，%Y-%m-%d 格式，默认NULL表示最新交易日期。

返回值： StkHkInstHoldingDetailInfo 结构数组，参见StkHkInstHoldingDetailInfo定义与DataArray类的用法。

示例：

stk_hk_inst_holding_detail_info("SHSE.600008")

注意：

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

2. trade_date输入非交易日，会返回空。

stk_hk_inst_holding_info - 查询沪深港通标的港股机构持股数据

查询沪深港通标的港股机构持股数据

此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.6.14 版本新增

函数原型：

DataArray<StkHkInstHoldingInfo>* stk_hk_inst_holding_info(const char *symbols = NULL, const char *trade_date = NULL)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbol	str	股票代码	N	NULL	输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002" , 默认NULL表示所有标的。
trade_date	str	交易日期	N	NULL	交易日期，%Y-%m-%d 格式，默认NULL表示最新交易日期。

返回值： StkHkInstHoldingInfo 结构数组，参见StkHkInstHoldingInfo定义与DataArray类的用法。

示例：

stk_hk_inst_holding_info("SHSE.600008,SZSE.000002")

注意：

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

2. trade_date输入非交易日，会返回空。

stk_active_stock_top10_shszhk_info - 查询沪深港通十大活跃成交股数据

查询沪深港通十大活跃成交股数据

此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.6.14 版本新增

函数原型：

DataArray<StkActiveStockTop10ShszhkInfo>* stk_active_stock_top10_shszhk_info(const char *types = NULL, const char *trade_date = NULL)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
types	str	类型	N	NULL	类型，可输入多个，多个类型必须用英文逗号分割，如："SZ,SHHK" ，类型包括：SH - 沪股通 ，SHHK - 沪港股通 ，SZ - 深股通 ，SZHK - 深港股通，NF - 北向资金（沪股通+深股通），默认 NULL 为全部北向资金。
trade_date	str	交易日期	N	NULL	交易日期，%Y-%m-%d 格式，默认NULL表示最新交易日期。

返回值： StkActiveStockTop10ShszhkInfo 结构数组，参见StkActiveStockTop10ShszhkInfo定义与DataArray类的用法。

示例：

stk_active_stock_top10_shszhk_info("SZHK")

注意：

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

2. trade_date输入非交易日，会返回空。

---