# 股票增值数据函数(付费)
python 股票与指数数据 API 包含在 gm3.0.148 版本及以上版本
# stk_get_industry_category - 查询行业分类
查询指定行业来源的行业列表
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_industry_category(source='zjh2012', level=1)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| source | str | 行业来源 | N | 'zjh2012' | 'zjh2012'- 证监会行业分类 2012（默认）， 'sw2021'- 申万行业分类 2021, 查看行业分类 |
| level | int | 行业分级 | N | 1 | 1 - 一级行业（默认），2 - 二级行业，3 - 三级行业 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| industry_code | str | 行业代码 | 所选行业来源，对应的行业代码 |
| industry_name | str | 行业名称 | 所选行业来源，对应的行业名称 |
示例：
industry_category = stk_get_industry_category(source='sw2021', level=2)
输出：
industry_code industry_name
0 110100 种植业
1 110200 渔业
2 110300 林业Ⅱ
3 110400 饲料
4 110500 农产品加工
.. ... ...
129 760100 环境治理
130 760200 环保设备Ⅱ
131 770100 个护用品
132 770200 化妆品
133 770300 医疗美容
[134 rows x 2 columns]
注意：
1. 证监会行业分类 2012 没有三级行业，若输入source='zjh2012', level=3则参数无效，返回空dataframe
# stk_get_industry_constituents - 查询行业成分股
查询指定某个行业的成分股
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_industry_constituents(industry_code, date="")
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| industry_code | str | 行业代码 | Y | 无 | 需要查询成分股的行业代码，可通过stk_get_industry_category获取, 查看行业分类 |
| date | str | 查询日期 | N | "" | 查询行业成分股的指定日期，%Y-%m-%d 格式，默认""表示最新时间 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| industry_code | str | 行业代码 | 成分股的行业代码 |
| industry_name | str | 行业名称 | 成分股的行业名称 |
| symbol | str | 成分股票代码 | exchange.sec_id |
| sec_name | str | 成分股名称 | symbol 对应的股票名称 |
| date_in | str | 纳入日期 | 成分股被纳入指定行业的日期，%Y-%m-%d 格式 |
| date_out | str | 剔除日期 | 成分股被剔除指定行业的日期，%Y-%m-%d 格式 |
示例：
stk_get_industry_constituents(industry_code='A', date='2022-09-05')
输出：
industry_code industry_name symbol sec_name date_in date_out
0 04 渔业 SZSE.000798 中水渔业 2012-12-31
1 01 农业 SHSE.600359 新农开发 2012-12-31
2 01 农业 SHSE.600371 万向德农 2012-12-31
3 01 农业 SHSE.600506 香梨股份 2012-12-31
4 02 林业 SZSE.000592 平潭发展 2012-12-31
5 01 农业 SHSE.600598 北大荒 2012-12-31
6 01 农业 SZSE.002041 登海种业 2012-12-31
7 01 农业 SHSE.600540 新赛股份 2012-12-31
8 01 农业 SHSE.600354 敦煌种业 2012-12-31
9 04 渔业 SHSE.600467 好当家 2012-12-31
10 03 畜牧业 SHSE.600975 新五丰 2012-12-31
11 04 渔业 SZSE.200992 中鲁B 2012-12-31
12 01 农业 SHSE.600313 农发种业 2015-07-20
13 04 渔业 SHSE.600097 开创国际 2012-12-31
14 01 农业 SHSE.600108 亚盛集团 2012-12-31
15 03 畜牧业 SHSE.600965 福成股份 2012-12-31
16 05 农、林、牧、渔服务业 SZSE.000711 京蓝科技 2016-12-31
17 05 农、林、牧、渔服务业 SZSE.000713 丰乐种业 2012-12-31
18 03 畜牧业 SZSE.000735 罗牛山 2012-12-31
19 02 林业 SZSE.000663 永安林业 2012-12-31
20 01 农业 SZSE.300189 神农科技 2012-12-31
21 04 渔业 SZSE.002069 ST獐子岛 2012-12-31
22 03 畜牧业 SZSE.002234 民和股份 2012-12-31
23 04 渔业 SZSE.002086 ST东洋 2012-12-31
24 01 农业 SHSE.601118 海南橡胶 2012-12-31
25 03 畜牧业 SZSE.002157 正邦科技 2021-09-30
26 03 畜牧业 SZSE.002299 圣农发展 2012-12-31
27 03 畜牧业 SZSE.002458 益生股份 2012-12-31
28 04 渔业 SZSE.300094 国联水产 2012-12-31
29 03 畜牧业 SZSE.300106 西部牧业 2012-12-31
30 02 林业 SZSE.002679 福建金森 2012-12-31
31 04 渔业 SHSE.600257 大湖股份 2012-12-31
32 01 农业 SZSE.000998 隆平高科 2012-12-31
33 01 农业 SZSE.300087 荃银高科 2012-12-31
34 03 畜牧业 SZSE.300313 ST天山 2019-06-30
35 04 渔业 SZSE.002696 百洋股份 2012-12-31
36 03 畜牧业 SZSE.002505 鹏都农牧 2012-12-31
37 03 畜牧业 SZSE.002714 牧原股份 2014-01-09
38 03 畜牧业 SZSE.002746 仙坛股份 2015-02-02
39 01 农业 SZSE.300511 雪榕生物 2016-04-14
40 01 农业 SZSE.002772 众兴菌业 2015-06-10
41 03 畜牧业 SZSE.300498 温氏股份 2015-10-29
42 03 畜牧业 SZSE.002982 湘佳股份 2020-04-03
43 01 农业 SZSE.300143 盈康生命 2012-12-31
44 03 畜牧业 SZSE.300761 立华股份 2019-01-22
45 03 畜牧业 SHSE.605296 神农集团 2021-04-20
46 03 畜牧业 SHSE.603477 巨星农牧 2020-09-30
47 03 畜牧业 SZSE.140006 牧原优01 2014-01-09
48 03 畜牧业 SZSE.001201 东瑞股份 2020-06-05
49 01 农业 SZSE.300970 华绿生物 2015-07-21
50 01 农业 SZSE.300972 万辰生物 2015-08-18
51 03 畜牧业 SZSE.300967 晓鸣股份 2014-10-30
52 03 畜牧业 SZSE.002124 天邦食品 2021-09-30
53 03 畜牧业 SZSE.002321 ST华英 2012-12-31
54 02 林业 SZSE.002200 ST交投 2012-12-31
55 02 林业 SHSE.600265 ST景谷 2012-12-31
注意：
1. 只能指定一个行业代码查询成分股。
# stk_get_symbol_industry - 查询股票的所属行业
查询指定股票所属的行业
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_symbol_industry(symbols, source="zjh2012", level=1, date="")
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbols | str or list | 股票代码 | Y | 无 | 多个代码可用 ，使用时参考symbol 采用 str 格式时，多个标的代码必须用英文逗号分割如：'SHSE.600008,SZSE.000002' 采用 list 格式时，多个标的代码示例：['SHSE.600008', 'SZSE.000002'] |
| source | str | 行业来源 | N | 'zjh2012' | 'zjh2012'- 证监会行业分类 2012（默认）， 'sw2021'- 申万行业分类 2021, 查看行业分类 |
| level | int | 行业分级 | N | 1 | 1 - 一级行业（默认），2 - 二级行业，3 - 三级行业 |
| date | str | 查询日期 | N | "" | 查询行业分类的指定日期，%Y-%m-%d 格式，默认""表示最新时间 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| symbol | str | 股票代码 | exchange.sec_id |
| sec_name | str | 股票名称 | symbol 对应的股票名称 |
| industry_code | str | 行业代码 | 指定行业来源下，symbol 所属的行业代码 |
| industry_name | str | 行业名称 | 指定行业来源下，symbol 所属的行业名称 |
示例：
stk_get_symbol_industry(symbols='SHSE.600000, SZSE.000002', source="zjh2012", level=1, date="")
输出：
symbol sec_name industry_code industry_name
0 SHSE.600000 浦发银行 J 金融业
1 SZSE.000002 万科A K 房地产业
注意：
1. 证监会行业分类 2012 没有三级行业，若输入source='zjh2012', level=3则参数无效，返回空dataframe
# stk_get_sector_category - 查询板块分类
查询指定类型的板块列表
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_sector_category(sector_type)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| sector_type | str | 板块类型 | Y | 无 | 只能选择一种类型，可选择 1001:市场类 1002:地域类 1003:概念类, 查看板块分类 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| sector_code | str | 板块代码 | 所选板块类型的板块代码 |
| sector_name | str | 板块名称 | 所选板块类型的板块名称 |
示例：
stk_get_sector_category(sector_type='1003')
输出：
sector_code sector_name
0 007001 军工
1 007003 煤化工
2 007004 新能源
3 007005 节能环保
4 007007 AB股
.. ... ...
420 007499 存储芯片
421 007500 液冷概念
422 007501 中特估
423 007502 央企改革
424 007503 混合现实
[425 rows x 2 columns]
# stk_get_sector_constituents - 查询板块成分股
查询指定某个板块的成分股
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_sector_constituents(sector_code)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| sector_code | str | 板块代码 | Y | 无 | 需要查询成分股的板块代码，可通过stk_get_sector_category获取, 查看板块分类 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| sector_code | str | 板块代码 | 查询的板块代码 |
| sector_name | str | 板块名称 | 查询的板块代码对应的板块名称 |
| symbol | str | 成分股票代码 | exchange.sec_id |
| sec_name | str | 成分股票名称 | symbol 对应的股票名称 |
示例：
stk_get_sector_constituents(sector_code='007089')
输出：
sector_code sector_name symbol sec_name
0 007089 央视50 SHSE.600196 复星医药
1 007089 央视50 SZSE.000848 承德露露
2 007089 央视50 SZSE.000049 德赛电池
3 007089 央视50 SHSE.600887 伊利股份
4 007089 央视50 SZSE.300003 乐普医疗
5 007089 央视50 SZSE.300024 机器人
6 007089 央视50 SZSE.002008 大族激光
7 007089 央视50 SZSE.000895 双汇发展
8 007089 央视50 SZSE.002410 广联达
9 007089 央视50 SZSE.300183 东软载波
10 007089 央视50 SHSE.601166 兴业银行
11 007089 央视50 SHSE.600563 法拉电子
12 007089 央视50 SZSE.000423 东阿阿胶
13 007089 央视50 SZSE.300244 迪安诊断
14 007089 央视50 SHSE.600522 中天科技
15 007089 央视50 SZSE.300124 汇川技术
16 007089 央视50 SHSE.600398 海澜之家
17 007089 央视50 SHSE.601607 上海医药
18 007089 央视50 SZSE.002294 信立泰
19 007089 央视50 SZSE.300136 信维通信
20 007089 央视50 SHSE.600585 海螺水泥
21 007089 央视50 SHSE.600276 恒瑞医药
22 007089 央视50 SHSE.600036 招商银行
23 007089 央视50 SZSE.002120 韵达股份
24 007089 央视50 SHSE.603986 兆易创新
25 007089 央视50 SHSE.603160 汇顶科技
26 007089 央视50 SZSE.000651 格力电器
27 007089 央视50 SHSE.601088 中国神华
28 007089 央视50 SHSE.601939 建设银行
29 007089 央视50 SHSE.600016 民生银行
30 007089 央视50 SZSE.000538 云南白药
31 007089 央视50 SZSE.000002 万科A
32 007089 央视50 SHSE.601601 中国太保
33 007089 央视50 SHSE.601318 中国平安
34 007089 央视50 SHSE.600535 天士力
35 007089 央视50 SHSE.601398 工商银行
36 007089 央视50 SHSE.601988 中国银行
37 007089 央视50 SHSE.600085 同仁堂
38 007089 央视50 SHSE.600660 福耀玻璃
39 007089 央视50 SHSE.600519 贵州茅台
40 007089 央视50 SHSE.600690 海尔智家
41 007089 央视50 SZSE.002415 海康威视
42 007089 央视50 SZSE.002230 科大讯飞
43 007089 央视50 SZSE.000596 古井贡酒
44 007089 央视50 SZSE.300070 碧水源
45 007089 央视50 SZSE.002038 双鹭药业
46 007089 央视50 SHSE.600104 上汽集团
47 007089 央视50 SHSE.600600 青岛啤酒
48 007089 央视50 SZSE.000333 美的集团
49 007089 央视50 SZSE.000726 鲁泰A
注意：
1. 只能指定一个板块代码查询成分股。
# stk_get_symbol_sector - 查询股票的所属板块
查询指定股票所属的板块
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_symbol_sector(symbols, sector_type)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbols | str or list | 股票代码 | Y | 无 | 多个代码可用 ，使用时参考symbol 采用 str 格式时，多个标的代码必须用英文逗号分割如：'SHSE.600008,SZSE.000002' 采用 list 格式时，多个标的代码示例：['SHSE.600008', 'SZSE.000002'] |
| sector_type | str | 板块类型 | Y | 无 | 只能选择一种类型，可选择 1001:市场类 1002:地域类 1003:概念类 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| symbol | str | 股票代码 | exchange.sec_id |
| sec_name | str | 股票名称 | symbol 对应的股票名称 |
| sector_code | str | 板块代码 | 指定板块类型下，symbol 所属的板块代码 |
| sector_name | str | 板块名称 | 指定板块类型下，symbol 所属的板块名称 |
示例：
stk_get_symbol_sector(symbols='SHSE.600008,SZSE.000002', sector_type='1002')
输出：
symbol sec_name sector_code sector_name
0 SHSE.600008 首创环保 006002001001 北京市
1 SZSE.000002 万科A 006006001015 深圳市
# stk_get_dividend - 查询股票分红送股信息
查询指定股票在一段时间内的分红送股信息
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_dividend(symbol, start_date, end_date)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 标的代码 | Y | 无 | 必填，只能填一个股票标的，使用时参考symbol |
| start_date | str | 开始时间 | Y | 无 | 必填，开始时间日期（除权除息日），%Y-%m-%d 格式 |
| end_date | str | 结束时间 | Y | 无 | 必填，结束时间日期（除权除息日），%Y-%m-%d 格式 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| symbol | str | 股票代码 | exchange.sec_id |
| scheme_type | str | 分配方案 | 现金分红，送股，转增 |
| pub_date | str | 公告日 | %Y-%m-%d 格式 |
| equity_reg_date | str | 股权登记日 | %Y-%m-%d 格式 |
| ex_date | str | 除权除息日 | %Y-%m-%d 格式 |
| cash_pay_date | str | 现金红利发放日 | %Y-%m-%d 格式 |
| share_acct_date | str | 送转股到账日 | %Y-%m-%d 格式 |
| share_lst_date | str | 新增股份上市流通日 | 红股上市日或送（转增）股份上市交易日, %Y-%m-%d 格式 |
| cash_af_tax | float | 税后红利 | 单位：元/10 股 |
| cash_bf_tax | float | 税前红利 | 单位：元/10 股 |
| bonus_ratio | float | 送股比例 | 10:X |
| convert_ratio | float | 转增比例 | 10:X |
| base_date | str | 股本基准日 | %Y-%m-%d 格式 |
| base_share | float | 股本基数 | 基准股本 |
示例：
stk_get_dividend(symbol='SHSE.600000', start_date='2022-07-01', end_date='2022-07-31')
输出：
symbol scheme_type pub_date equity_reg_date ex_date cash_pay_date share_acct_date share_lst_date cash_af_tax cash_bf_tax bonus_ratio convert_ratio base_date base_share
0 SHSE.600000 现金分红 2022-07-13 2022-07-20 2022-07-21 2022-07-21 None None 3.69 4.1 0.0 0.0 2022-07-20 2.9352e+10
注意：
1. 当start_date小于或等于end_date 时取指定时间段的数据,当start_date>end_date时返回报错.
# stk_get_ration - 查询股票配股信息
查询指定股票在一段时间内的配股信息
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_ration(symbol, start_date, end_date)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 标的代码 | Y | 无 | 必填，只能填一个股票标的，使用时参考symbol |
| start_date | str | 开始时间 | Y | 无 | 必填, 开始时间日期（除权除息日），%Y-%m-%d 格式 |
| end_date | str | 结束时间 | Y | 无 | 必填, 结束时间日期（除权除息日），%Y-%m-%d 格式 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| symbol | str | 股票代码 | exchange.sec_id |
| pub_date | str | 公告日 | %Y-%m-%d 格式 |
| equity_reg_date | str | 股权登记日 | %Y-%m-%d 格式 |
| ex_date | str | 除权除息日 | %Y-%m-%d 格式 |
| ration_ratio | float | 配股比例 | 10:X |
| ration_price | float | 配股价格 | 单位：元 |
示例：
stk_get_ration(symbol='SZSE.000728', start_date="2005-01-01", end_date="2022-09-30")
输出：
symbol pub_date equity_reg_date ex_date ration_ratio ration_price
0 SZSE.000728 2020-10-09 2020-10-13 2020-10-22 3.0 5.44
注意：
1. 当start_date 小于或等于 end_date 时取指定时间段的数据,当start_date > end_date时返回报错.
# stk_get_adj_factor - 查询股票的复权因子
查询某只股票在一段时间内的复权因子
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_adj_factor(symbol, start_date="", end_date="", base_date="")
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 标的代码 | Y | 无 | 必填，只能填一个股票标的，使用时参考symbol |
| start_date | str | 开始时间 | N | "" | 开始时间交易日期，%Y-%m-%d 格式，默认""表示最新时间 |
| end_date | str | 结束时间 | N | "" | 结束时间交易日期，%Y-%m-%d 格式，默认""表示最新时间 |
| base_date | str | 复权基准日 | N | "" | 前复权的基准日，%Y-%m-%d 格式，默认""表示最新时间 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| trade_date | str | 交易日期 | 开始时间至结束时间的交易日期 |
| adj_factor_bwd | float | 当日后复权因子 | T 日后复权因子=T-1 日的收盘价/T 日昨收价 |
| adj_factor_bwd_acc | float | 当日累计后复权因子 | T 日累计后复权因子=T 日后复权因子 ×T-1 日累计后复权因子, ... 第一个累计后复权因子=第一个后复权因子 |
| adj_factor_fwd | float | 当日前复权因子 | T 日前复权因子=T 日累计后复权因子/复权基准日累计后复权因子 |
| adj_factor_fwd_acc | float | 当日累计前复权因子 | T 日累计前复权因子=1/T 日后复权因子, T-1 日累计前复权因子=1/(T 日后复权因子 ×T-1 日后复权因子), ... 第一个累计前复权因子=1/最新累计后复权因子 |
示例：
stk_get_adj_factor(symbol='SZSE.000651', start_date="2015-01-01", end_date="2022-09-01", base_date="")
输出：
trade_date adj_factor_bwd adj_factor_bwd_acc adj_factor_fwd adj_factor_fwd_acc
0 2015-01-05 1.0 49.1697 0.3315 3.0169
1 2015-01-06 1.0 49.1697 0.3315 3.0169
2 2015-01-07 1.0 49.1697 0.3315 3.0169
3 2015-01-08 1.0 49.1697 0.3315 3.0169
4 2015-01-09 1.0 49.1697 0.3315 3.0169
... ... ... ... ... ...
1862 2022-08-26 1.0 148.3407 1.0000 1.0000
1863 2022-08-29 1.0 148.3407 1.0000 1.0000
1864 2022-08-30 1.0 148.3407 1.0000 1.0000
1865 2022-08-31 1.0 148.3407 1.0000 1.0000
1866 2022-09-01 1.0 148.3407 1.0000 1.0000
[1867 rows x 5 columns]
注意：
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 股股东总数
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_shareholder_num(symbol, start_date="", end_date="")
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 股票代码 | Y | 无 | 必填，只能填一个股票标的，使用时参考symbol |
| start_date | str | 开始时间 | N | "" | 开始时间日期（公告日期），%Y-%m-%d 格式，默认""表示最新时间 |
| end_date | str | 结束时间 | N | "" | 结束时间日期（公告日期），%Y-%m-%d 格式，默认""表示最新时间 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| symbol | str | 股票代码 | exchange.sec_id |
| sec_name | str | 股票名称 | symbol 对应的股票名称 |
| pub_date | str | 公告日期 | |
| expiry_date | str | 截止日期 | |
| total_share | int | 股东总数 | |
| total_share_a | int | A 股股东总数 | |
| total_share_b | int | 流通 B 股股东总数 | |
| total_share_h | int | 流通 H 股股东总数 | |
| other_share | int | 其他股东户数 | |
| total_share_pfd | int | 优先股股东总数（表决权恢复） | |
| total_share_mgn | int | 股东户数（含融资融券） | 合并普通账户和融资融券信用账户后的股东总户数 |
| total_share_no_mgn | int | 股东户数（不含融资融券） | 普通账户的股东总户数 |
示例：
stk_get_shareholder_num(symbol='SZSE.002594', start_date="2022-01-01", end_date="2022-08-01")
输出：
symbol sec_name pub_date expiry_date total_share total_share_a total_share_b total_share_h other_share total_share_pfd total_share_mgn total_share_no_mgn
0 SZSE.002594 比亚迪 2022-03-30 2021-12-31 357227 357109 0 118 0 0 0 0
1 SZSE.002594 比亚迪 2022-03-30 2022-02-28 392631 392511 0 120 0 0 0 0
2 SZSE.002594 比亚迪 2022-04-28 2022-03-31 405607 405486 0 121 0 0 0 0
注意：
当start_date == end_date时，取离end_date最近公告日期的一条数据，
当start_dat < end_date时，取指定时间段的数据，
当start_date > end_date时，返回报错。
# stk_get_top_shareholder - 查询十大股东
查询上市公司前十大股东的持股情况，包括持股数量，所持股份性质等
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_top_shareholder(symbol, start_date="", end_date="", tradable_holder=False)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 股票代码 | Y | 无 | 必填，只能填一个股票标的，使用时参考symbol |
| start_date | str | 开始时间 | N | "" | 开始时间日期（公告日期），%Y-%m-%d 格式，默认""表示最新时间 |
| end_date | str | 结束时间 | N | "" | 结束时间日期（公告日期），%Y-%m-%d 格式，默认""表示最新时间 |
| tradable_holder | bool | 是否流通股东 | N | False | False-十大股东（默认）、True-十大流通股东 默认False表示十大股东 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| symbol | str | 股票代码 | exchange.sec_id |
| sec_name | str | 股票名称 | symbol 对应的股票名称 |
| pub_date | str | 公告日期 | |
| expiry_date | str | 截止日期 | |
| holder_name | str | 股东名称 | |
| holder_rank | int | 股东序号 | 名次 |
| holder_type | str | 股东类型 | |
| holder_attr | str | 股东性质 | 十大流通股东不返回 |
| share_type | str | 股份类型 | 股份性质 |
| share_num | float | 持股数量 | 持有数量（股） |
| share_ratio1 | float | 持股比例 1 | 持股占总股本比例（%） |
| share_ratio2 | float | 持股比例 2 | 持股占已上市流通股比例（%），仅十大流通股东才返回 |
| share_pledge | float | 质押股份数量 | 股权质押涉及股数（股） |
| share_freeze | float | 冻结股份数量 | 股权冻结涉及股数（股） |
示例：
stk_get_top_shareholder(symbol='SHSE.603906', start_date="2022-06-01", end_date="2022-08-01", tradable_holder=False)
输出：
symbol sec_name pub_date expiry_date holder_name holder_rank holder_type holder_attr share_type share_num share_ratio1 share_ratio2 share_pledge share_freeze
0 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 上海歆享资产管理有限公司-歆享盈新1号私募证券投资基金 10 投资公司 境内法人股 流通A股 3.1941e+06 0.66 0.0 0.0 0.0
1 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 上海迎水投资管理有限公司-迎水日新9号私募证券投资基金 9 投资公司 境内法人股 流通A股 3.2252e+06 0.67 0.0 0.0 0.0
2 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 中国工商银行股份有限公司-南方卓越优选3个月持有期混合型证券投资基金 5 证券投资基金 境内法人股 流通A股 4.9513e+06 1.03 0.0 0.0 0.0
3 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 中国工商银行股份有限公司-申万菱信新经济混合型证券投资基金 7 证券投资基金 境内法人股 流通A股 3.7343e+06 0.77 0.0 0.0 0.0
4 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 中国工商银行股份有限公司-财通资管价值成长混合型证券投资基金 3 证券投资基金 境内法人股 流通A股 8.1342e+06 1.69 0.0 0.0 0.0
5 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 中国工商银行股份有限公司-财通资管均衡价值一年持有期混合型证券投资基金 8 证券投资基金 境内法人股 流通A股 3.6870e+06 0.76 0.0 0.0 0.0
6 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 平安基金-中国平安人寿保险股份有限公司-平安人寿-平安基金权益委托投资1号单一资产管理计划 4 基金资产管理计划 境内法人股 流通A股 5.6035e+06 1.16 0.0 0.0 0.0
7 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 建投嘉驰(上海)投资有限公司 6 投资公司 国有股 流通A股 4.4512e+06 0.92 0.0 0.0 0.0
8 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 朱香兰 2 个人 自然人股 流通A股 2.3619e+07 4.90 0.0 0.0 0.0
9 SHSE.603906 龙蟠科技 2022-06-18 2022-06-10 石俊峰 1 个人 自然人股 流通A股 2.1266e+08 44.11 0.0 0.0 0.0
10 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 JPMORGAN CHASE BANK,NATIONAL ASSOCIATION 8 QFII 境外法人股 流通A股 5.5692e+06 0.99 0.0 0.0 0.0
11 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 中国工商银行股份有限公司-南方卓越优选3个月持有期混合型证券投资基金 10 证券投资基金 境内法人股 流通A股 4.9513e+06 0.88 0.0 0.0 0.0
12 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 中国工商银行股份有限公司-财通资管价值成长混合型证券投资基金 4 证券投资基金 境内法人股 流通A股 1.1999e+07 2.12 0.0 0.0 0.0
13 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 中国工商银行股份有限公司-财通资管均衡价值一年持有期混合型证券投资基金 9 证券投资基金 境内法人股 流通A股 5.5354e+06 0.98 0.0 0.0 0.0
14 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 平安基金-中国平安人寿保险股份有限公司-平安人寿-平安基金权益委托投资1号单一资产管理计划 7 基金资产管理计划 境内法人股 流通A股 5.6035e+06 0.99 0.0 0.0 0.0
15 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 成都丝路重组股权投资基金管理有限公司-成都振兴嘉业贰号股权投资中心(有限合伙) 5 投资公司 境内法人股 流通A股 5.6582e+06 1.00 0.0 0.0 0.0
16 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 朱香兰 2 个人 自然人股 流通A股 2.3619e+07 4.18 0.0 0.0 0.0
17 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 汇添富基金-中信银行理财之乐赢成长周期一年B款理财产品-汇添富中信添富牛170号单一资产管理计划 3 基金资产管理计划 境内法人股 流通A股 1.3203e+07 2.34 0.0 0.0 0.0
18 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 济南江山投资合伙企业(有限合伙) 5 投资公司 境内法人股 流通A股 5.6582e+06 1.00 0.0 0.0 0.0
19 SHSE.603906 龙蟠科技 2022-06-18 2022-06-16 石俊峰 1 个人 自然人股 流通A股 2.1266e+08 37.63 0.0 0.0 0.0
注意：
当start_date == end_date时，取离end_date最近公告日期的一条数据，
当start_dat < end_date时，取指定时间段的数据，
当start_date > end_date时，返回报错。
# stk_get_share_change - 查询股本变动
查询上市公司的一段时间内公告的股本变动情况
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准
函数原型：
stk_get_share_change(symbol, start_date="", end_date="")
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 股票代码 | Y | 无 | 必填，只能填一个股票标的，使用时参考symbol |
| start_date | str | 开始时间 | N | "" | 开始时间日期（发布日期），%Y-%m-%d 格式，默认""表示最新时间 |
| end_date | str | 结束时间 | N | "" | 结束时间日期（发布日期），%Y-%m-%d 格式，默认""表示最新时间 |
返回值：dataframe
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| symbol | str | 股票代码 | exchange.sec_id |
| company_name | str | 公司名称 | symbol 对应的公司名称 |
| pub_date | str | 发布日期 | |
| chg_date | str | 股本变动日期 | |
| chg_reason | str | 股本变动原因 | |
| chg_event | str | 股本变动事件 | |
| share_total | float | 总股本 | 未流通股份+已流通股份，单位：股 |
| share_total_nlf | float | 未流通股份 | 单位：股 |
| share_prom | float | 一、发起人股份 | 国有发起人股 + 发起社会法人股 + 其他发起人股份，单位：股 |
| share_prom_state | float | 1.国有发起人股 | 国家持股+国有法人股，单位：股 |
| share_state | float | （1）国家股 | 单位：股 |
| share_state_lp | float | （2）国有法人股 | 单位：股 |
| share_prom_soc | float | 2.发起社会法人股 | 境内社会法人股+境外法人股，单位：股 |
| share_dc_lp | float | （1）境内社会法人股 | 单位：股 |
| share_os_lp | float | （2）境外法人股 | 单位：股 |
| share_prom_other | float | 3.其他发起人股份 | 单位：股 |
| share_rs | float | 二、募集人股份 | 募集国家股+募集境内法人股+募集境外法人股，单位：股 |
| share_rs_state | float | 1.募集国家股 | 单位：股 |
| share_rs_dc_lp | float | 2.募集境内法人股 | 募集境内国有法人股+募集境内社会法人股，单位：股 |
| share_rs_state_lp | float | （1）募集境内国有法人股 | 单位：股 |
| share_rs_soc_lp | float | （2）募集境内社会法人股 | 单位：股 |
| share_rs_os_lp | float | 3.募集境外法人股 | 单位：股 |
| share_emp_nlf | float | 三、内部职工股 | 单位：股 |
| share_pfd_nlf | float | 四、优先股 | 单位：股 |
| share_oth_nlf | float | 五、其他未流通股份 | 单位：股 |
| share_circ | float | 流通股份 | 单位：股，无限售条件股份+有限售条件股份，实际流通股份可用share_ttl_unl（无限售条件股份） |
| share_ttl_unl | float | 无限售条件股份 | 人民币普通股（A 股）+ 境内上市外资股（B 股）+ 境外上市外资股（H 股）+ 其他已流通股份，单位：股 |
| share_a_unl | float | 1.人民币普通股（A 股） | 单位：股 |
| share_b_unl | float | 2.境内上市外资股（B 股） | 单位：股 |
| share_h_unl | float | 3.境外上市外资股（H 股） | 单位：股 |
| share_oth_unl | float | 4.其他已流通股份 | 单位：股 |
| share_ttl_ltd | float | 有限售条件股份 | 单位：股 |
| share_gen_ltd | float | 一、一般有限售条件股份 | 限售国家持股+ 限售国有法人持股+ 限售其他内资持股+ 限售外资持股+ 锁定股份+ 高管持股，单位：股 |
| share_state_ltd | float | 1.限售国家持股 | 单位：股 |
| share_state_lp_ltd | float | 2.限售国有法人持股 | 单位：股 |
| share_oth_dc_ltd | float | 3.限售其他内资持股 | 限售境内非国有法人持股+限售境内自然人持股，单位：股 |
| share_nst_dc_lp_ltd | float | （1）限售境内非国有法人持股 | 单位：股 |
| share_dc_np_ltd | float | （2）限售境内自然人持股 | 单位：股 |
| share_forn_ltd | float | 4.限售外资持股 | 限售境外法人持股+限售境外自然人持股，单位：股 |
| share_os_lp_ltd | float | （1）限售境外法人持股 | 单位：股 |
| share_os_np_ltd | float | （2）限售境外自然人持股 | 单位：股 |
| share_lk_ltd | float | 5.锁定股份 | 单位：股 |
| share_gm_ltd | float | 6.高管持股(原始披露) | 单位：股 |
| share_plc_lp_ltd | float | 二、配售法人持股 | 战略投资者配售股份+一般法人投资者配售+ 证券投资基金配售股份，单位：股 |
| share_plc_si_ltd | float | 1.战略投资者配售股份 | 单位：股 |
| share_plc_lp_gen_ltd | float | 2.一般法人投资者配售股份 | 单位：股 |
| share_plc_fnd_ltd | float | 3.证券投资基金配售股份 | 单位：股 |
| share_a_ltd | float | 限售流通 A 股 | 单位：股 |
| share_b_ltd | float | 限售流通 B 股 | 单位：股 |
| share_h_ltd | float | 限售流通 H 股 | 单位：股 |
| share_oth_ltd | float | 其他限售股份 | 单位：股 |
| share_list_date | str | 变动股份上市日 | %Y-%m-%d 格式 |
示例：
stk_get_share_change(symbol='SHSE.605090', start_date="2020-01-01", end_date="2022-10-01")
输出：
symbol company_name pub_date chg_date chg_reason chg_event share_total share_total_nlf share_prom share_prom_state share_state share_state_lp share_prom_soc share_dc_lp share_os_lp share_prom_other share_rs share_rs_state share_rs_dc_lp share_rs_state_lp share_rs_soc_lp share_rs_os_lp share_emp_nlf share_pfd_nlf share_oth_nlf share_circ share_ttl_unl share_a_unl share_b_unl share_h_unl share_oth_unl share_ttl_ltd share_gen_ltd share_state_ltd share_state_lp_ltd share_oth_dc_ltd share_nst_dc_lp_ltd share_dc_np_ltd share_forn_ltd share_os_lp_ltd share_os_np_ltd share_lk_ltd share_gm_ltd share_plc_lp_ltd share_plc_si_ltd share_plc_lp_gen_ltd share_plc_fnd_ltd share_a_ltd share_b_ltd share_h_ltd share_oth_ltd share_list_date
0 SHSE.605090 江西九丰能源股份有限公司 2021-05-24 2021-05-13 首发A股上市 发行融资 4.4297e+08 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 4.4297e+08 8.2970e+07 8.2970e+07 0.0 0.0 0.0 3.6000e+08 3.6000e+08 0.0 0.0 3.1967e+08 2.1591e+08 1.0376e+08 4.0330e+07 4.0330e+07 0.0 0.0 1.0376e+08 0.0 0.0 0.0 0.0 3.6000e+08 0.0 0.0 0.0 2021-05-25
1 SHSE.605090 江西九丰能源股份有限公司 2022-05-12 2022-05-18 转增股上市 分红派息 6.2016e+08 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 6.2016e+08 1.1616e+08 1.1616e+08 0.0 0.0 0.0 5.0400e+08 5.0400e+08 0.0 0.0 4.4754e+08 3.0228e+08 1.4526e+08 5.6462e+07 5.6462e+07 0.0 0.0 0.0000e+00 0.0 0.0 0.0 0.0 5.0400e+08 0.0 0.0 0.0 2022-05-19
2 SHSE.605090 江西九丰能源股份有限公司 2022-05-25 2022-05-30 首发限售股份上市 限售股解禁 6.2016e+08 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 6.2016e+08 2.5281e+08 2.5281e+08 0.0 0.0 0.0 3.6735e+08 3.6735e+08 0.0 0.0 3.6735e+08 2.2209e+08 1.4526e+08 0.0000e+00 0.0000e+00 0.0 0.0 0.0000e+00 0.0 0.0 0.0 0.0 3.6735e+08 0.0 0.0 0.0 2022-05-30
注意：
当start_date == end_date时，取离end_date最近发布日期的一条数据，
当start_dat < end_date时，取指定时间段的数据，
当start_date > end_date时，返回报错。
# stk_abnor_change_stocks - 查询龙虎榜股票数据
查询指定时间段龙虎榜股票数据
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.0.163 版本新增
函数原型：
stk_abnor_change_stocks(symbols=None, change_types=None, trade_date=None, fields=None, df=False)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbols | str or list | 股票代码 | N | None | 输入标的代码，可输入多个. 采用 str 格式时，多个标的代码必须用英文逗号分割，如：'SHSE.600008,SZSE.000002'; 采用 list 格式时，多个标的代码示例：['SHSE.600008', 'SZSE.000002'], 默认None表示所有标的。 |
| change_types | str or list | 异动类型 | N | None | 输入异动类型，可输入多个. 采用 str 格式时，多个异动类型必须用英文逗号分割，如：'106,107'; 采用 list 格式时，多个异动类型示例：['106','107']； 默认None表示所有异动类型。龙虎榜异动类型列表 |
| trade_date | str or datetime.date | 交易日期 | N | None | 交易日期，支持str格式（%Y-%m-%d 格式）和 datetime.date 格式，默认None表示最新交易日期。 |
| fields | str | 返回字段 | N | None | 指定需要返回的字段，如有多个字段，中间用英文逗号分隔，默认 None 返回所有字段。 |
| df | bool | 返回格式 | N | False | 是否返回 dataframe 格式 ， 默认False返回 list[dict],列表每项的dict的key值为参数指定的 fields 。 |
返回值：
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| symbol | str | 股票代码 | exchange.sec_id |
| trade_date | str | 交易日期 | |
| change_type | str | 异动类型 | 交易所披露的公开信息及异常波动信息的原因类型,龙虎榜异动类型列表 |
| change_type_name | str | 异动类型说明 | 交易所披露的公开信息及异常波动信息的原因的中文说明 |
| abnor_start_date | str | 异动开始日期 | 股票异动开始的日期，仅部分异动类型才有 |
| abnor_end_date | str | 异动结束日期 | 股票异动结束的日期，仅部分异动类型才有 |
| close | float | 收盘价 | 股票的日频收盘价 |
| cum_volume | int | 累计成交量 | 股票的累计成交量，当存在具体异动开始/结束日期时，累计成交量为区间成交量；当不存在具体异动开始/结束日期时，累计成交量为当日成交量 |
| cum_amount | float | 累计成交额 | 股票的累计成交额，当存在具体异动开始/结束日期时，累计成交额为区间成交额；当不存在具体异动开始/结束日期时，累计成交额为当日成交额 |
| prc_change_rate | float | 涨跌幅% | 当日涨跌幅 |
| avg_turn_rate | float | 日均换手率比值 | 异动类型中，触发相应异动事件的日均换手率比值 |
| stat_value | float | 统计值 | 异动类型中，触发相应异动事件的统计值 |
示例：
stk_abnor_change_stocks(symbols=None, change_types='106', trade_date=None, fields=None, df=False)
输出：
[{'symbol': 'SZSE.000017', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '日涨幅偏离值达到7%的前5只证券', 'close': 12.77, 'cum_volume': 110996688, 'cum_amount': 1375429201.0, 'prc_change_rate': 9.9914, 'stat_value': 9.05},
{'symbol': 'SZSE.001217', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '日涨幅偏离值达到7%的前5只证券', 'close': 16.68, 'cum_volume': 54707801, 'cum_amount': 798100880.0, 'prc_change_rate': 10.0264, 'stat_value': 9.05},
{'symbol': 'SZSE.002230', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '日涨幅偏离值达到7%的前5只证券', 'close': 42.11, 'cum_volume': 105142255, 'cum_amount': 4299831646.0, 'prc_change_rate': 10.0052, 'stat_value': 9.05},
{'symbol': 'SZSE.002517', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '日涨幅偏离值达到7%的前5只证券', 'close': 11.2, 'cum_volume': 134710030, 'cum_amount': 1488908194.0, 'prc_change_rate': 10.0196, 'stat_value': 9.05},
{'symbol': 'SZSE.003027', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '日涨幅偏离值达到7%的前5只证券', 'close': 28.84, 'cum_volume': 26272266, 'cum_amount': 727342648.0, 'prc_change_rate': 9.9924, 'stat_value': 9.05},
{'symbol': 'SHSE.600200', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '有价格涨跌幅限制的日收盘价格涨幅偏离值达到7%的前五只证券', 'close': 8.97, 'cum_volume': 5877996, 'cum_amount': 52725624.0, 'prc_change_rate': 10.0613, 'stat_value': 9.53},
{'symbol': 'SHSE.600629', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '有价格涨跌幅限制的日收盘价格涨幅偏离值达到7%的前五只证券', 'close': 4.93, 'cum_volume': 25619361, 'cum_amount': 121095785.0, 'prc_change_rate': 10.0446, 'stat_value': 9.52},
{'symbol': 'SHSE.600675', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '有价格涨跌幅限制的日收盘价格涨幅偏离值达到7%的前五只证券', 'close': 3.16, 'cum_volume': 37060390, 'cum_amount': 111530727.0, 'prc_change_rate': 10.1045, 'stat_value': 9.58},
{'symbol': 'SHSE.600816', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '有价格涨跌幅限制的日收盘价格涨幅偏离值达到7%的前五只证券', 'close': 2.83, 'cum_volume': 21759618, 'cum_amount': 59379245.0, 'prc_change_rate': 10.1167, 'stat_value': 9.59},
{'symbol': 'SHSE.600836', 'trade_date': '2024-01-23', 'change_type': '106', 'change_type_name': '有价格涨跌幅限制的日收盘价格涨幅偏离值达到7%的前五只证券', 'close': 3.81, 'cum_volume': 21817595, 'cum_amount': 78789358.0, 'prc_change_rate': 10.1156, 'stat_value': 9.59}]
注意：
1. 数据日频更新，在交易日约20点更新当日数据。如果当前交易日数据尚未更新，调用时不指定trade_date会返回前一交易日的数据，调用时指定trade_date为当前交易日会返回空。
2. trade_date输入非交易日，会返回空。
# stk_abnor_change_detail - 查询龙虎榜营业部数据
查询指定时间段龙虎榜营业数据
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.0.163 版本新增
函数原型：
stk_abnor_change_detail(symbols=None, change_types=None, trade_date=None, fields=None, df=False)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbols | str or list | 股票代码 | N | None | 输入标的代码，可输入多个. 采用 str 格式时，多个标的代码必须用英文逗号分割，如：'SHSE.600008,SZSE.000002'; 采用 list 格式时，多个标的代码示例：['SHSE.600008', 'SZSE.000002'], 默认None表示所有标的。 |
| change_types | str or list | 异动类型 | N | None | 输入异动类型，可输入多个. 采用 str 格式时，多个异动类型必须用英文逗号分割，如：'106,107'; 采用 list 格式时，多个异动类型示例：['106','107']； 默认None表示所有异动类型。龙虎榜异动类型列表 |
| trade_date | str or datetime.date | 交易日期 | N | None | 交易日期，支持str格式（%Y-%m-%d 格式）和 datetime.date 格式，默认None表示最新交易日期。 |
| fields | str | 返回字段 | N | None | 指定需要返回的字段，如有多个字段，中间用英文逗号分隔，默认 None 返回所有字段。 |
| df | bool | 返回格式 | N | False | 是否返回 dataframe 格式 ， 默认False返回 list[dict],列表每项的dict的key值为参数指定的 fields 。 |
返回值：
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| symbol | str | 股票代码 | exchange.sec_id |
| trade_date | str | 交易日期 | |
| change_type | str | 异动类型 | 交易所披露的公开信息及异常波动信息的原因类型,龙虎榜异动类型列表 |
| side | int | 交易方向 | 0-买入 1-卖出 |
| sales_dept | str | 营业部名称 | |
| buy_amount | float | 买入金额 | |
| sell_amount | float | 卖出金额 | |
| rank | int | 排名 | |
| avg_turn_rate | float | 日均换手率比值 | |
| stat_days | str | 统计天数 |
示例：
stk_abnor_change_detail(symbols=['SZSE.300799'], change_types=None, trade_date='2024-01-23', fields=None, df=False)
输出：
[{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨东环路第一证券营业部', 'buy_amount': 14564894.0, 'sell_amount': 7558746.0, 'rank': 1, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨团结路第二证券营业部', 'buy_amount': 9851257.0, 'sell_amount': 7961995.0, 'rank': 2, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨东环路第二证券营业部', 'buy_amount': 9168211.0, 'sell_amount': 10625788.4, 'rank': 3, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨金融城南环路证券营业部', 'buy_amount': 8130605.0, 'sell_amount': 4825320.0, 'rank': 4, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨团结路第一证券营业部', 'buy_amount': 7874940.0, 'sell_amount': 7103053.0, 'rank': 5, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '东方财富证券股份有限公司拉萨东环路第二证券营业部', 'buy_amount': 9168211.0, 'sell_amount': 10625788.4, 'rank': 1, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '华泰证券股份有限公司杭州求是路证券营业部', 'buy_amount': 86904.0, 'sell_amount': 8832233.0, 'rank': 2, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '东方财富证券股份有限公司拉萨团结路第二证券营业部', 'buy_amount': 9851257.0, 'sell_amount': 7961995.0, 'rank': 3, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '东方财富证券股份有限公司拉萨东环路第一证券营业部', 'buy_amount': 14564894.0, 'sell_amount': 7558746.0, 'rank': 4, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '东方财富证券股份有限公司拉萨团结路第一证券营业部', 'buy_amount': 7874940.0, 'sell_amount': 7103053.0, 'rank': 5, 'change_type': '149'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨东环路第一证券营业部', 'buy_amount': 20244889.0, 'sell_amount': 13720238.0, 'rank': 1, 'stat_days': '2 ', 'change_type': '153'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨东环路第二证券营业部', 'buy_amount': 16872156.0, 'sell_amount': 16700434.4, 'rank': 2, 'stat_days': '2 ', 'change_type': '153'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨团结路第二证券营业部', 'buy_amount': 16274111.0, 'sell_amount': 13804247.0, 'rank': 3, 'stat_days': '2 ', 'change_type': '153'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨团结路第一证券营业部', 'buy_amount': 13191129.0, 'sell_amount': 13434925.0, 'rank': 4, 'stat_days': '2 ', 'change_type': '153'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'sales_dept': '东方财富证券股份有限公司拉萨金融城南环路证券营业部', 'buy_amount': 12009881.0, 'sell_amount': 7226749.0, 'rank': 5, 'stat_days': '2 ', 'change_type': '153'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '东方财富证券股份有限公司拉萨东环路第二证券营业部', 'buy_amount': 16872156.0, 'sell_amount': 16700434.4, 'rank': 1, 'stat_days': '2 ', 'change_type': '153'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '东方财富证券股份有限公司拉萨团结路第二证券营业部', 'buy_amount': 16274111.0, 'sell_amount': 13804247.0, 'rank': 2, 'stat_days': '2 ', 'change_type': '153'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '东方财富证券股份有限公司拉萨东环路第一证券营业部', 'buy_amount': 20244889.0, 'sell_amount': 13720238.0, 'rank': 3, 'stat_days': '2 ', 'change_type': '153'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '东方财富证券股份有限公司拉萨团结路第一证券营业部', 'buy_amount': 13191129.0, 'sell_amount': 13434925.0, 'rank': 4, 'stat_days': '2 ', 'change_type': '153'},
{'symbol': 'SZSE.300799', 'trade_date': '2024-01-23', 'side': 1, 'sales_dept': '东方财富证券股份有限公司拉萨东城区江苏大道证券营业部', 'buy_amount': 8374957.0, 'sell_amount': 11359868.5, 'rank': 5, 'stat_days': '2 ', 'change_type': '153'}]
注意：
1. 数据日频更新，在交易日约20点更新当日数据。如果当前交易日数据尚未更新，调用时不指定trade_date会返回前一交易日的数据，调用时指定trade_date为当前交易日会返回空。
2. trade_date输入非交易日，会返回空。
# stk_quota_shszhk_infos - 查询沪深港通额度数据
查询指定时间段沪深港通额度数据
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.0.163 版本新增
交易所信息披露调整，2024.8.19起，NF-北向资金/SH-沪股通/SZ-深股通只返回结算汇率数据，历史数据不受影响，SHHK-沪港股通/SZHK-深港股通不受影响
函数原型：
stk_quota_shszhk_infos(types=None, start_date=None, end_date=None, count=None, df=False)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| types | str or list | 类型 | N | None | 类型，可输入多个，采用 str 格式时，多个类型必须用英文逗号分割，如：'SZ,SHHK' 采用 list 格式时，多个标的代码示例：['SZ', 'SHHK']，类型包括：SH - 沪股通 ，SHHK - 沪港股通 ，SZ - 深股通 ，SZHK - 深港股通，NF - 北向资金（沪股通+深股通），默认 None 为全部北向资金。 |
| start_date | str or datetime.date | 开始日期 | N | None | 开始日期，支持str格式（%Y-%m-%d 格式）和 datetime.date 格式，默认None表示最新交易日期。 |
| end_date | str or datetime.date | 结束日期 | N | None | 结束日期，支持str格式（%Y-%m-%d 格式）和 datetime.date 格式，默认None表示最新交易日期。 |
| count | int | 交易日数量 | N | None | 数量(正整数)，不能与start_date同时使用，否则返回报错；与 end_date 同时使用时，表示获取 end_date 前 count 个交易日的数据(包含 end_date 当日)；默认为 None ，不使用该字段。 |
| df | bool | 返回格式 | N | False | 是否返回 dataframe 格式 ， 默认False返回 list[dict],列表每项的dict的key值为参数指定的 fields 。 |
返回值：
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| type | str | 类型 | SH - 沪股通 ，SHHK - 沪港股通 ，SZ - 深股通 ，SZHK - 深港股通，NF - 北向资金（沪股通+深股通） |
| trade_date | str | 最新交易日期 | |
| daily_quota | float | 每日额度上限(亿元) | |
| day_balance | float | 当日余额(亿元) | |
| day_used | float | 当日使用额度(亿元) | |
| day_used_rate | float | 当日额度使用率(%) | |
| day_buy_amount | float | 当日买入成交金额(亿元) | |
| day_buy_volume | float | 当日买入成交笔数(笔) | |
| day_sell_amount | float | 当日卖出成交金额(亿元) | |
| day_sell_volume | float | 当日卖出成交笔数(笔) | |
| day_net_amount | float | 当日买卖成交净额(亿元) | |
| settle_exrate_buy | float | 沪深港通结算汇率(买入) | |
| settle_exrate_sell | float | 沪深港通结算汇率(卖出) |
示例：
stk_quota_shszhk_infos(types='SHHK', start_date=None, end_date='2024-01-23', count=1, df=False)
输出：
[{'type': 'SHHK', 'trade_date': '2024-01-23', 'daily_quota': 420.0, 'day_balance': 433.3, 'day_used': -13.3, 'day_used_rate': -3.167, 'day_buy_amount': 63.4454, 'day_buy_volume': 179494.0, 'day_sell_amount': 86.4077, 'day_sell_volume': 216835.0, 'settle_exrate_buy': 0.9209, 'settle_exrate_sell': 0.9225, 'day_net_amount': -22.9623}]
注意：
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 当日)；默认为 None ，不使用该字段。
# stk_hk_inst_holding_detail_info - 查询沪深港通标的港股机构持股明细数据
查询沪深港通标的港股机构持股明细数据
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.0.163 版本新增
交易所信息披露调整，数据最晚更新到2024.8.16，历史数据不受影响
函数原型：
stk_hk_inst_holding_detail_info(symbols=None, trade_date=None, df=False)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 股票代码 | N | None | 输入标的代码，可输入多个. 采用 str 格式时，多个标的代码必须用英文逗号分割，如：'SHSE.600008,SZSE.000002' 采用 list 格式时，多个标的代码示例：['SHSE.600008', 'SZSE.000002'] 默认None表示所有标的。 |
| trade_date | str or datetime.date | 交易日期 | N | None | 交易日期，支持str格式（%Y-%m-%d 格式）和 datetime.date 格式，默认None表示最新交易日期。 |
| df | bool | 返回格式 | N | False | 是否返回 dataframe 格式 ， 默认False返回 list[dict],列表每项的dict的key值为参数指定的 fields 。 |
返回值：
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| trade_date | str | 最新交易日期 | 最新交易日期 |
| symbol | str | 证券代码 | 证券代码 |
| sec_name | str | 证券简称 | 证券简称 |
| participant_name | str | 参与者名称 | 参与者名称 |
| share_holding | int | 持股量(股) | 持股量(股) |
| shares_rate | float | 占已发行股份(%) | 占已发行股份(%) |
示例：
stk_hk_inst_holding_detail_info(symbols='SHSE.600008', trade_date=None, df=False)
输出：
[{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': 'CREDIT SUISSE SECURITIES (HONG KONG) LTD', 'share_holding': 374905, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': 'J.P. MORGAN BROKING (HONG KONG) LTD', 'share_holding': 6445488, 'shares_rate': 0.08},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': 'JPMORGAN CHASE BANK, NATIONAL ASSOCIATION', 'share_holding': 19630045, 'shares_rate': 0.26},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': 'MLFE LTD', 'share_holding': 2134425, 'shares_rate': 0.02},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': 'MORGAN STANLEY HONG KONG SECURITIES LTD', 'share_holding': 2962125, 'shares_rate': 0.04},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': 'Societe Generale', 'share_holding': 176637, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': 'UBS SECURITIES HONG KONG LTD', 'share_holding': 2238651, 'shares_rate': 0.03},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '上银证券有限公司', 'share_holding': 132000, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '东亚证券有限公司', 'share_holding': 7000, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '中信证券经纪(香港)有限公司', 'share_holding': 22900, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '中信里昂证券有限公司', 'share_holding': 158790, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '中国国际金融香港证券有限公司', 'share_holding': 821082, 'shares_rate': 0.01},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '中国建设银行(亚洲)股份有限公司', 'share_holding': 10600, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '中国银行(香港)有限公司', 'share_holding': 219800, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '中银国际证券有限公司', 'share_holding': 49824935, 'shares_rate': 0.67},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '元大证券(香港)有限公司', 'share_holding': 60000, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '创兴证券有限公司', 'share_holding': 13000, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '华盛资本证券有限公司', 'share_holding': 27800, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '国信证券(香港)经纪有限公司', 'share_holding': 400, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '国泰君安证券(香港)有限公司', 'share_holding': 280600, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '大华继显(香港)有限公司', 'share_holding': 141800, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '宝生证券有限公司', 'share_holding': 655900, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '富途证券国际(香港)有限公司', 'share_holding': 77300, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '广发证券(香港)经纪有限公司', 'share_holding': 14000, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '恒生证券有限公司', 'share_holding': 179700, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '永丰金证券(亚洲)有限公司', 'share_holding': 52000, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '法国巴黎银行', 'share_holding': 4579831, 'shares_rate': 0.06},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '渣打银行(香港)有限公司', 'share_holding': 13222494, 'shares_rate': 0.18},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '盈透证券香港有限公司', 'share_holding': 47930, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '耀才证券国际(香港)有限公司', 'share_holding': 3000, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '花旗银行', 'share_holding': 11468541, 'shares_rate': 0.15},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '辉立证券(香港)有限公司', 'share_holding': 337500, 'shares_rate': 0.0},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '香港上海汇丰银行有限公司', 'share_holding': 10059735, 'shares_rate': 0.13},
{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'participant_name': '高盛(亚洲)证券有限公司', 'share_holding': 5938226, 'shares_rate': 0.08}]
注意：
1. 数据日频更新，在交易日约20点更新当日数据。如果当前交易日数据尚未更新，调用时不指定trade_date会返回前一交易日的数据，调用时指定trade_date为当前交易日会返回空。
2. trade_date输入非交易日，会返回空。
# stk_hk_inst_holding_info - 查询沪深港通标的港股机构持股数据
查询沪深港通标的港股机构持股数据
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.0.163 版本新增
交易所信息披露调整，数据最晚更新到2024.8.16，历史数据不受影响
函数原型：
stk_hk_inst_holding_info(symbols=None, trade_date=None, df=False)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 股票代码 | N | None | 输入标的代码，可输入多个. 采用 str 格式时，多个标的代码必须用英文逗号分割，如：'SHSE.600008,SZSE.000002' 采用 list 格式时，多个标的代码示例：['SHSE.600008', 'SZSE.000002'] 默认None表示所有标的。 |
| trade_date | str or datetime.date | 交易日期 | N | None | 交易日期，支持str格式（%Y-%m-%d 格式）和 datetime.date 格式，默认None表示最新交易日期。 |
| df | bool | 返回格式 | N | False | 是否返回 dataframe 格式 ， 默认False返回 list[dict],列表每项的dict的key值为参数指定的 fields 。 |
返回值：
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| trade_date | str | 最新交易日期 | 最新交易日期 |
| symbol | str | 证券代码 | 证券代码 |
| sec_name | str | 证券简称 | 证券简称 |
| participant_name | str | 参与者名称 | 参与者名称 |
| cum_share_holding | int | 累计持股量(股) | 累计持股量(股) |
| cum_shares_rate | float | 累计占已发行股份(%) | 累计占已发行股份(%) |
示例：
stk_hk_inst_holding_info(symbols='SHSE.600008,SZSE.000002', trade_date=None, df=False)
输出：
[{'symbol': 'SHSE.600008', 'trade_date': '2024-01-25', 'sec_name': '首创环保', 'cum_share_holding': 132319140, 'cum_shares_rate': 1.71},
{'symbol': 'SZSE.000002', 'trade_date': '2024-01-25', 'sec_name': '万科A', 'cum_share_holding': 228964226, 'cum_shares_rate': 2.23}]
注意：
1. 数据日频更新，在交易日约20点更新当日数据。如果当前交易日数据尚未更新，调用时不指定trade_date会返回前一交易日的数据，调用时指定trade_date为当前交易日会返回空。
2. trade_date输入非交易日，会返回空。
# stk_active_stock_top10_shszhk_info - 查询沪深港通十大活跃成交股数据
查询沪深港通十大活跃成交股数据
此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.0.163 版本新增
函数原型：
stk_active_stock_top10_shszhk_info(types=None, trade_date=None, df=False)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| types | str or list | 类型 | N | None | 类型，可输入多个，采用 str 格式时，多个类型必须用英文逗号分割，如：'SZ,SHHK' 采用 list 格式时，多个标的代码示例：['SZ', 'SHHK']，类型包括：SH - 沪股通 ，SHHK - 沪港股通 ，SZ - 深股通 ，SZHK - 深港股通，NF - 北向资金（沪股通+深股通），默认 None 为全部北向资金。 |
| trade_date | str or datetime.date | 交易日期 | N | None | 交易日期，支持str格式（%Y-%m-%d 格式）和 datetime.date 格式，默认None表示最新交易日期。 |
| df | bool | 返回格式 | N | False | 是否返回 dataframe 格式 ， 默认False返回 list[dict],列表每项的dict的key值为参数指定的 fields 。 |
返回值：
| 字段名 | 类型 | 中文名称 | 说明 |
|---|---|---|---|
| trade_type | str | 类型 | SH - 沪股通 ，SHHK - 沪港股通 ，SZ - 深股通 ，SZHK - 深港股通，NF - 北向资金（沪股通+深股通） |
| trade_date | str | 最新交易日期 | |
| rank | int | 排名 | |
| symbol | str | 代码 | |
| sec_name | str | 名称 | |
| close | float | 收盘价格(元) | |
| price_range | float | 涨跌幅(%) | |
| buy_amount | float | 买入金额(万元) | （沪深港通）买入金额(万元) |
| buy_volume | float | 卖出金额(万元) | （沪深港通）卖出金额(万元) |
| total_amount | float | 成交金额(万元) | （沪深港通）成交金额(万元) |
| stock_total_amount | float | 股票成交金额(万元) | 股票成交金额(万元) |
| transaction_rate | float | 成交占比(%) | （沪深港通）成交金额(万元)占股票成交金额(万元)的比例(%) |
| market_value_total | float | 总市值(亿元) | |
| cum_number_of_times | int | 累计上榜次数 | 股票进入每日十大活跃成交股的次数 |
| currency | str | 币种 | CNY(人民币) , HKD(港元) |
示例：
stk_active_stock_top10_shszhk_info(types='SZHK', trade_date=None, df=False)
输出：
[{'symbol': 'HK.03690', 'trade_date': '2024-01-25', 'rank': 4, 'type': 'SZHK', 'sec_name': '美团-W', 'close': 69.4, 'price_range': -1.2802, 'buy_amount': 30656.8865, 'sell_amount': 28844.0799, 'total_amount': 59500.9664, 'stock_total_amount': 310032.2982, 'transaction_rate': 19.1919, 'market_value_total': 4333.9628, 'cum_number_of_times': 1996, 'currency': 'HKD'},
{'symbol': 'HK.02318', 'trade_date': '2024-01-25', 'rank': 8, 'type': 'SZHK', 'sec_name': '中国平安', 'close': 34.6, 'price_range': 4.8485, 'buy_amount': 11403.6125, 'sell_amount': 10698.3075, 'total_amount': 22101.92, 'stock_total_amount': 296208.1587, 'transaction_rate': 7.4616, 'market_value_total': 6300.7412, 'cum_number_of_times': 790, 'currency': 'HKD'},
{'symbol': 'HK.01810', 'trade_date': '2024-01-25', 'rank': 10, 'type': 'SZHK', 'sec_name': '小米集团-W', 'close': 13.74, 'price_range': 0.292, 'buy_amount': 6782.6328, 'sell_amount': 13975.542, 'total_amount': 20758.1748, 'stock_total_amount': 115367.6607, 'transaction_rate': 17.9931, 'market_value_total': 3445.2863, 'cum_number_of_times': 1246, 'currency': 'HKD'},
{'symbol': 'HK.01797', 'trade_date': '2024-01-25', 'rank': 6, 'type': 'SZHK', 'sec_name': '东方甄选', 'close': 24.2, 'price_range': -8.3333, 'buy_amount': 21350.9475, 'sell_amount': 12630.7475, 'total_amount': 33981.695, 'stock_total_amount': 67946.4211, 'transaction_rate': 50.0125, 'market_value_total': 246.0016, 'cum_number_of_times': 348, 'currency': 'HKD'},
{'symbol': 'HK.01024', 'trade_date': '2024-01-25', 'rank': 9, 'type': 'SZHK', 'sec_name': '快手-W', 'close': 44.6, 'price_range': -0.112, 'buy_amount': 14876.216, 'sell_amount': 6185.893, 'total_amount': 21062.109, 'stock_total_amount': 97141.6742, 'transaction_rate': 21.6818, 'market_value_total': 1948.6613, 'cum_number_of_times': 637, 'currency': 'HKD'},
{'symbol': 'HK.00981', 'trade_date': '2024-01-25', 'rank': 7, 'type': 'SZHK', 'sec_name': '中芯国际', 'close': 16.04, 'price_range': 3.4839, 'buy_amount': 15796.551, 'sell_amount': 7910.155, 'total_amount': 23706.706, 'stock_total_amount': 74554.1682, 'transaction_rate': 31.798, 'market_value_total': 1274.6363, 'cum_number_of_times': 1533, 'currency': 'HKD'},
{'symbol': 'HK.00941', 'trade_date': '2024-01-25', 'rank': 2, 'type': 'SZHK', 'sec_name': '中国移动', 'close': 67.65, 'price_range': 2.3449, 'buy_amount': 61646.64, 'sell_amount': 26017.6775, 'total_amount': 87664.3175, 'stock_total_amount': 248358.7732, 'transaction_rate': 35.2975, 'market_value_total': 14472.2173, 'cum_number_of_times': 1118, 'currency': 'HKD'},
{'symbol': 'HK.00883', 'trade_date': '2024-01-25', 'rank': 3, 'type': 'SZHK', 'sec_name': '中国海洋石油', 'close': 14.44, 'price_range': 4.7896, 'buy_amount': 57442.304, 'sell_amount': 23673.3544, 'total_amount': 81115.6584, 'stock_total_amount': 269234.0355, 'transaction_rate': 30.1283, 'market_value_total': 6868.6407, 'cum_number_of_times': 1044, 'currency': 'HKD'},
{'symbol': 'HK.00762', 'trade_date': '2024-01-25', 'rank': 5, 'type': 'SZHK', 'sec_name': '中国联通', 'close': 5.45, 'price_range': 4.6065, 'buy_amount': 21708.258, 'sell_amount': 12586.296, 'total_amount': 34294.554, 'stock_total_amount': 59194.3214, 'transaction_rate': 57.9355, 'market_value_total': 1667.5978, 'cum_number_of_times': 112, 'currency': 'HKD'},
{'symbol': 'HK.00700', 'trade_date': '2024-01-25', 'rank': 1, 'type': 'SZHK', 'sec_name': '腾讯控股', 'close': 290.8, 'price_range': 3.1938, 'buy_amount': 31622.082, 'sell_amount': 76991.966, 'total_amount': 108614.048, 'stock_total_amount': 984146.2621, 'transaction_rate': 11.0364, 'market_value_total': 27487.5599, 'cum_number_of_times': 3613, 'currency': 'HKD'}]
注意：
1. 数据日频更新，在交易日约20点更新当日数据。如果当前交易日数据尚未更新，调用时不指定trade_date会返回前一交易日的数据，调用时指定trade_date为当前交易日会返回空。
2. trade_date输入非交易日，会返回空。