# 股票增值数据函数(付费)
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输入非交易日,会返回空。