# 股票增值数据函数（付费）
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 版本新增
交易所信息披露调整，2024.8.19起，NF-北向资金/SH-沪股通/SZ-深股通只返回结算汇率数据，历史数据不受影响，SHHK-沪港股通/SZHK-深港股通不受影响
函数原型：
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 版本新增
交易所信息披露调整，数据最晚更新到2024.8.16，历史数据不受影响
函数原型：
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 版本新增
交易所信息披露调整，数据最晚更新到2024.8.16，历史数据不受影响
函数原型：
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输入非交易日，会返回空。