掘金量化—Python SDK文档—5.API 介绍(2)

news2024/12/23 10:34:32

 

Python SDK文档

5.API介绍

5.6通用数据函数(免费)

python 通用数据 API 包含在 gm3.0.148 版本及以上版本,不需要引入新库


get_symbol_infos - 查询标的基本信息

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

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

函数原型:

get_symbol_infos(sec_type1, sec_type2=None, exchanges=None, symbols=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
sec_type1int证券品种大类Y指定一种证券大类,只能输入一个. 证券大类 sec_type1 清单 1010: 股票, 1020: 基金, 1030: 债券 , 1040: 期货, 1050: 期权, 1060: 指数.
sec_type2int证券品种细类NNone指定一种证券细类,只能输入一个. 默认None表示不区分细类,即证券大类下所有细类. 证券细类见 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:期货指数
exchangesstr or list交易所代码NNone输入交易所代码,可输入多个. 采用 str 格式时,多个交易所代码必须用英文逗号分割,如:'SHSE,SZSE' 采用 list 格式时,多个交易所代码示例:['SHSE', 'SZSE'] 默认None表示所有交易所. 交易所代码清单 SHSE:上海证券交易所,SZSE:深圳证券交易所 , CFFEX:中金所,SHFE:上期所,DCE:大商所, CZCE:郑商所,INE:能源中心
symbolsstr or list标的代码NNone输入标的代码,可输入多个. 采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002'] 默认None表示所有标的.
dfbool返回格式NFalse是否返回 dataframe 格式,默认False返回字典格式,返回 list[dict], 列表每项的 dict 的 key 值为 fields 字段.

返回值:

字段名类型中文名称说明股票字段基金字段债券字段期货字段期权字段指数字段
symbolstr标的代码exchange.sec_id
sec_type1int证券品种大类1010: 股票,1020: 基金, 1030: 债券,1040: 期货, 1050: 期权,1060: 指数
sec_type2int证券品种细类- 股票 101001:A 股,101002:B 股,101003:存托凭证 - 基金 102001:ETF,102002:LOF,102005:FOF - 债券 103001:可转债,103003:国债,103006:企业债,103008:回购 - 期货 104001:股指期货,104003:商品期货,104006:国债期货 - 期权 105001:股票期权,105002:指数期权,105003:商品期权 - 指数 106001:股票指数,106002:基金指数,106003:债券指数,106004:期货指数
boardint板块A 股 10100101:主板 A 股 10100102:创业板 10100103:科创版 10100104:北交所股票 ETF 10200101:股票 ETF 10200102:债券 ETF 10200103:商品 ETF 10200104:跨境 ETF 10200105:货币 ETF 可转债 10300101:普通可转债 10300102:可交换债券 10300103:可分离式债券 10300104:定向可转债
exchangestr交易所代码SHSE:上海证券交易所, SZSE:深圳证券交易所, CFFEX:中金所, SHFE:上期所, DCE:大商所, CZCE:郑商所, INE:上海国际能源交易中心
sec_idstr交易所标的代码股票,基金,债券,指数的证券代码; 期货,期权的合约代码
sec_namestr交易所标的名称股票,基金,债券,指数的证券名称; 期货,期权的合约名称
sec_abbrstr交易所标的简称拼音或英文简称
price_tickfloat最小变动单位交易标的价格最小变动单位
trade_nint交易制度0 表示 T+0,1 表示 T+1,2 表示 T+2
listed_datedatetime.datetime上市日期证券/指数的上市日、衍生品合约的挂牌日
delisted_datedatetime.datetime退市日期股票/基金的退市日, 期货/期权的到期日(最后交易日), 可转债的赎回登记日
underlying_symbolstr标的资产期货/期权的合约标的物 symbol,可转债的正股标的 symbol
option_typestr行权方式期权行权方式,仅期权适用,E:欧式,A:美式
option_margin_ratio1float期权保证金计算系数 1计算期权单位保证金的第 1 个系数,仅期权适用
option_margin_ratio2float期权保证金计算系数 2计算期权单位保证金的第 2 个系数,仅期权适用
call_or_putstr合约类型期权合约类型,仅期权适用,C:Call(认购或看涨), P:Put(认沽或看跌)
conversion_start_datedatetime.datetime可转债开始转股日期可转债初始转股价的执行日期,仅可转债适用

示例:

get_symbol_infos(sec_type1=1010, symbols='SHSE.600008,SZSE.000002')

输出:

[{'symbol': 'SHSE.600008', 'sec_type1': 1010, 'sec_type2': 101001, 'board': 10100101, 'exchange': 'SHSE', 'sec_id': '600008', 'sec_name': '首创环保', 'sec_abbr': 'SCHB', 'price_tick': 0.01, 'trade_n': 1, 'listed_date': datetime.datetime(2000, 4, 27, 0, 0, tzinfo=tzfile('PRC')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=tzfile('PRC')), 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None},
 {'symbol': 'SZSE.000002', 'sec_type1': 1010, 'sec_type2': 101001, 'board': 10100101, 'exchange': 'SZSE', 'sec_id': '000002', 'sec_name': '万科A', 'sec_abbr': 'WKA', 'price_tick': 0.01, 'trade_n': 1, 'listed_date': datetime.datetime(1991, 1, 29, 0, 0, tzinfo=tzfile('PRC')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=tzfile('PRC')), 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None}]

注意:

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

2. 查询的标的信息根据参数组合sec_type1, sec_type2, exchanges, symbols取交集,若输入参数之间出现任何矛盾(换句话说,所有的参数限制出满足要求的交集为空),则返回空list/空DataFrame ,例如get_symbol_infos(sec_type1=1040,exchanges='SZSE')返回的是空值。

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

4. 参数组合示例:

查询以下范围 symbol 的基本信息sec_type1sec_type2exchangessymbols
查询指定股票1010NoneNone'SHSE.600008,SZSE.000002'
查询 A 股股票1010101001NoneNone
查询深交所股票1010None'SZSE'None
查询 ETF1020102001NoneNone
查询上交所 LOF1020102002'SHSE'None
查询可转债1030103001NoneNone
查询深交所可转债1030103001'SZSE'None
查询股指期货1040104001NoneNone
查询商品期货1040104003NoneNone
查询郑商所和大商所期货1040None'CZCE,DCE'None
查询股票期权1050105001NoneNone
查询上交所股票期权1050105001'SHSE'None
查询指数期权1050105002NoneNone
查询商品期权1050105003NoneNone
查询上期所商品期权105003None'SHFE'None
查询股票指数1060106001NoneNone


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

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

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

函数原型:

get_symbols(sec_type1, sec_type2=None, exchanges=None, symbols=None, skip_suspended=True, skip_st=True, trade_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
sec_type1int证券品种大类Y指定一种证券大类,只能输入一个. 证券大类 sec_type1 清单 1010: 股票, 1020: 基金, 1030: 债券 , 1040: 期货, 1050: 期权, 1060: 指数.
sec_type2int证券品种细类NNone指定一种证券细类,只能输入一个. 默认None表示不区分细类,即证券大类下所有细类. 证券细类见 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:期货指数
exchangesstr or list交易所代码NNone输入交易所代码,可输入多个. 采用 str 格式时,多个交易所代码必须用英文逗号分割,如:'SHSE,SZSE' 采用 list 格式时,多个交易所代码示例:['SHSE', 'SZSE'] 默认None表示所有交易所. 交易所代码清单 SHSE:上海证券交易所,SZSE:深圳证券交易所 , CFFEX:中金所,SHFE:上期所,DCE:大商所, CZCE:郑商所,INE:能源中心
symbolsstr or list标的代码NNone输入标的代码,可输入多个. 采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002'] 默认None表示所有标的.
skip_suspendedbool跳过停牌NTrue是否跳过全天停牌,默认True跳过
skip_stbool跳过 STNTrue是否跳过包含 ST 的股票:ST, *ST, SST, S*ST, 默认True跳过
trade_datestr交易日期NNone交易日期,%Y-%m-%d 格式,默认None取最新截面(包含退市标的)
dfbool返回格式NFalse是否返回 dataframe 格式,默认False返回字典格式,返回 list[dict], 列表每项的 dict 的 key 值为 fields 字段.

返回值:

字段名类型中文名称说明股票字段基金字段债券字段期货字段期权字段指数字段
trade_datedatetime.datetime交易日期最新交易日的日期
symbolstr标的代码exchange.sec_id
sec_type1int证券品种大类1010: 股票,1020: 基金, 1030: 债券,1040: 期货, 1050: 期权,1060: 指数
sec_type2int证券品种细类- 股票 101001:A 股,101002:B 股,101003:存托凭证 - 基金 102001:ETF,102002:LOF,102005:FOF - 债券 103001:可转债,103008:回购 - 期货 104001:股指期货,104003:商品期货,104006:国债期货 - 期权 105001:股票期权,105002:指数期权,105003:商品期权 - 指数 106001:股票指数,106002:基金指数,106003:债券指数,106004:期货指数
boardint板块A 股 10100101:主板 A 股 10100102:创业板 10100103:科创版 10100104:北交所股票 ETF 10200101:股票 ETF 10200102:债券 ETF 10200103:商品 ETF 10200104:跨境 ETF 10200105:货币 ETF 可转债 10300101:普通可转债 10300102:可交换债券 10300103:可分离式债券 10300104:定向可转债
exchangestr交易所代码SHSE:上海证券交易所, SZSE:深圳证券交易所, CFFEX:中金所, SHFE:上期所, DCE:大商所, CZCE:郑商所, INE:上海国际能源交易中心
sec_idstr交易所标的代码股票,基金,债券,指数的证券代码; 期货,期权的合约代码
sec_namestr交易所标的名称股票,基金,债券,指数的证券名称; 期货,期权的合约名称
sec_abbrstr交易所标的简称拼音或英文简称
price_tickfloat最小变动单位交易标的价格最小变动单位
trade_nint交易制度0 表示 T+0,1 表示 T+1,2 表示 T+2
listed_datedatetime.datetime上市日期证券/指数的上市日、衍生品合约的挂牌日
delisted_datedatetime.datetime退市日期股票/基金的退市日, 期货/期权的到期日(最后交易日), 可转债的赎回登记日
underlying_symbolstr标的资产期货/期权的合约标的物 symbol,可转债的正股标的 symbol
option_typestr行权方式期权行权方式,仅期权适用,E:欧式,A:美式
option_margin_ratio1float期权保证金计算系数 1计算期权单位保证金的第 1 个系数,仅期权适用
option_margin_ratio2float期权保证金计算系数 2计算期权单位保证金的第 2 个系数,仅期权适用
call_or_putstr合约类型期权合约类型,仅期权适用,C:Call(认购或看涨), P:Put(认沽或看跌)
conversion_start_datedatetime.datetime可转债开始转股日期可转债初始转股价的执行日期,仅可转债适用
is_adjustedbool合约调整是否调整合约,True:是,False:否(调整后会产生新的新的合约名称、新的行权价格、新的合约乘数)
is_suspendedbool是否停牌是否停牌,True:是,False:否
is_stbool是否 ST是否 ST,True: 是 ST 类(含ST, *ST, SST, S*ST), False: 否
positionint持仓量当日累计持仓量,当日盘后更新
settle_pricefloat结算价当日结算价,当日盘后更新
pre_settlefloat昨结价昨日结算价
pre_closefloat昨收价昨日收盘价
upper_limitfloat涨停价当日涨停价(首次公开发行上市的股票上市前 5 日无涨跌停价,返回0)
lower_limitfloat跌停价当日跌停价(首次公开发行上市的股票上市前 5 日无涨跌停价,返回0)
turn_ratefloat换手率当日换手率(%),当日盘后更新
adj_factorfloat复权因子当日累计后复权因子
margin_ratiofloat保证金比例期货最新保证金比例(交易所标准的最新期货保证金)
conversion_pricefloat转股价可转债最新转股价(转股价变动后的最新转股价)
exercise_pricefloat行权价期权最新行权价(期权合约调整后的最新行权价)
multiplierint合约乘数期货和期权合约最新合约乘数(期权合约调整后的最新合约乘数)

示例:

get_symbols(sec_type1=1010, symbols='SHSE.600008,SZSE.000002', trade_date='2022-01-13')

输出:

[{'trade_date': datetime.datetime(2022, 1, 13, 0, 0, tzinfo=tzfile('PRC')), 'pre_close': 3.47, 'upper_limit': 3.82, 'lower_limit': 3.12, 'turn_rate': 1.1215, 'adj_factor': 6.5564, 'margin_ratio': 1.0, 'multiplier': 1, 'is_adjusted': False, 'is_suspended': False, 'position': 0, 'settle_price': 0.0, 'pre_settle': 0.0, 'conversion_price': 0.0, 'exercise_price': 0.0, 'is_st': False, 'symbol': 'SHSE.600008', 'sec_type1': 1010, 'sec_type2': 101001, 'board': 10100101, 'exchange': 'SHSE', 'sec_id': '600008', 'sec_name': '首创环保', 'sec_abbr': 'SCHB', 'price_tick': 0.01, 'trade_n': 1, 'listed_date': datetime.datetime(2000, 4, 27, 0, 0, tzinfo=tzfile('PRC')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=tzfile('PRC')), 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None},
 {'trade_date': datetime.datetime(2022, 1, 13, 0, 0, tzinfo=tzfile('PRC')), 'pre_close': 22.05, 'upper_limit': 24.26, 'lower_limit': 19.85, 'turn_rate': 0.9394, 'adj_factor': 173.0897, 'margin_ratio': 1.0, 'multiplier': 1, 'is_adjusted': False, 'is_suspended': False, 'position': 0, 'settle_price': 0.0, 'pre_settle': 0.0, 'conversion_price': 0.0, 'exercise_price': 0.0, 'is_st': False, 'symbol': 'SZSE.000002', 'sec_type1': 1010, 'sec_type2': 101001, 'board': 10100101, 'exchange': 'SZSE', 'sec_id': '000002', 'sec_name': '万科A', 'sec_abbr': 'WKA', 'price_tick': 0.01, 'trade_n': 1, 'listed_date': datetime.datetime(1991, 1, 29, 0, 0, tzinfo=tzfile('PRC')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=tzfile('PRC')), 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None}]

注意:

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

2. 查询的标的信息根据参数组合sec_type1, sec_type2, exchanges, symbols取交集,若输入参数之间出现任何矛盾(换句话说,所有的参数限制出满足要求的交集为空),则返回空list/空DataFrame ,例如get_symbols(sec_type1=1040, exchanges='SZSE')返回的是空值。

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

4. 获取全 A 股票代码示例get_symbols(sec_type1=1010, sec_type2=101001, df=True)['symbol'].tolist()

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

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

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

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

函数原型:

get_history_symbol(symbol=None, start_date=None, end_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolstr标的代码Y输入标的代码,只能输入一个.
start_datestr开始时间NNone开始时间日期,%Y-%m-%d 格式,默认None表示当前时间
end_datestr结束时间NNone结束时间日期,%Y-%m-%d 格式,默认None表示当前时间
dfbool返回格式NFalse是否返回 dataframe 格式,默认False返回字典格式,返回 list[dict], 列表每项的 dict 的 key 值为 fields 字段.

返回值:

字段名类型中文名称说明股票字段基金字段债券字段期货字段期权字段指数字段
trade_datedatetime.datetime交易日期最新交易日的日期
symbolstr标的代码exchange.sec_id
sec_type1int证券品种大类1010: 股票,1020: 基金, 1030: 债券,1040: 期货, 1050: 期权,1060: 指数
sec_type2int证券品种细类- 股票 101001:A 股,101002:B 股,101003:存托凭证 - 基金 102001:ETF,102002:LOF,102005:FOF - 债券 103001:可转债,103008:回购 - 期货 104001:股指期货,104003:商品期货,104006:国债期货 - 期权 105001:股票期权,105002:指数期权,105003:商品期权 - 指数 106001:股票指数,106002:基金指数,106003:债券指数,106004:期货指数
boardint板块A 股 10100101:主板 A 股 10100102:创业板 10100103:科创版 10100104:北交所股票 ETF 10200101:股票 ETF 10200102:债券 ETF 10200103:商品 ETF 10200104:跨境 ETF 10200105:货币 ETF 可转债 10300101:普通可转债 10300102:可交换债券 10300103:可分离式债券 10300104:定向可转债
exchangestr交易所代码SHSE:上海证券交易所, SZSE:深圳证券交易所, CFFEX:中金所, SHFE:上期所, DCE:大商所, CZCE:郑商所, INE:上海国际能源交易中心
sec_idstr交易所标的代码股票,基金,债券,指数的证券代码; 期货,期权的合约代码
sec_namestr交易所标的名称股票,基金,债券,指数的证券名称; 期货,期权的合约名称
sec_abbrstr交易所标的简称拼音或英文简称
price_tickfloat最小变动单位交易标的价格最小变动单位
trade_nint交易制度0 表示 T+0,1 表示 T+1,2 表示 T+2
listed_datedatetime.datetime上市日期证券/指数的上市日、衍生品合约的挂牌日
delisted_datedatetime.datetime退市日期股票/基金的退市日, 期货/期权的到期日(最后交易日), 可转债的赎回登记日
underlying_symbolstr标的资产期货/期权的合约标的物 symbol,可转债的正股标的 symbol
option_typestr行权方式期权行权方式,仅期权适用,E:欧式,A:美式
option_margin_ratio1float期权保证金计算系数 1计算期权单位保证金的第 1 个系数,仅期权适用
option_margin_ratio2float期权保证金计算系数 2计算期权单位保证金的第 2 个系数,仅期权适用
call_or_putstr合约类型期权合约类型,仅期权适用,C:Call(认购或看涨), P:Put(认沽或看跌)
conversion_start_datedatetime.datetime可转债开始转股日期可转债初始转股价的执行日期,仅可转债适用
is_adjustedbool合约调整是否调整合约,True:是,False:否(调整后会产生新的新的合约名称、新的行权价格、新的合约乘数)
is_suspendedbool是否停牌是否停牌,True:是,False:否
is_stbool是否 ST是否 ST,True: 是 ST 类(含ST, *ST, SST, S*ST), False: 否
positionint持仓量当日累计持仓量,当日盘后更新
settle_pricefloat结算价当日结算价,当日盘后更新
pre_settlefloat昨结价昨日结算价
pre_closefloat昨收价昨日收盘价
upper_limitfloat涨停价当日涨停价(首次公开发行上市的股票上市前 5 日无涨跌停价,返回0)
lower_limitfloat跌停价当日跌停价(首次公开发行上市的股票上市前 5 日无涨跌停价,返回0)
turn_ratefloat换手率当日换手率(%),当日盘后更新
adj_factorfloat复权因子当日累计后复权因子
margin_ratiofloat保证金比例期货在指定交易日的交易所保证金比例
conversion_pricefloat转股价可转债在指定交易日的转股价
exercise_pricefloat行权价期权在指定交易日的行权价
multiplierint合约乘数期货/期权合约在指定交易日的合约乘数

示例:

get_history_symbol(symbol='SZSE.000002', start_date='2022-09-01', end_date='2022-09-30', df=True)

输出:

                  trade_date  pre_close  ...  conversion_start_date
0  2022-09-01 00:00:00+08:00      16.63  ...                   None
1  2022-09-02 00:00:00+08:00      16.84  ...                   None
2  2022-09-05 00:00:00+08:00      16.80  ...                   None
3  2022-09-06 00:00:00+08:00      17.17  ...                   None
4  2022-09-07 00:00:00+08:00      17.85  ...                   None
5  2022-09-08 00:00:00+08:00      17.52  ...                   None
6  2022-09-09 00:00:00+08:00      17.58  ...                   None
7  2022-09-13 00:00:00+08:00      18.15  ...                   None
8  2022-09-14 00:00:00+08:00      18.18  ...                   None
9  2022-09-15 00:00:00+08:00      17.91  ...                   None
10 2022-09-16 00:00:00+08:00      18.50  ...                   None
11 2022-09-19 00:00:00+08:00      18.00  ...                   None
12 2022-09-20 00:00:00+08:00      18.18  ...                   None
13 2022-09-21 00:00:00+08:00      17.56  ...                   None
14 2022-09-22 00:00:00+08:00      17.56  ...                   None
15 2022-09-23 00:00:00+08:00      17.49  ...                   None
16 2022-09-26 00:00:00+08:00      17.51  ...                   None
17 2022-09-27 00:00:00+08:00      17.44  ...                   None
18 2022-09-28 00:00:00+08:00      17.60  ...                   None
19 2022-09-29 00:00:00+08:00      17.46  ...                   None
20 2022-09-30 00:00:00+08:00      17.15  ...                   None

[21 rows x 34 columns]

注意:

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

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

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

4. start_dateend_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 - 查询年度交易日历

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

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

函数原型:

get_trading_dates_by_year(exchange, start_year, end_year)

参数:

参数名类型中文名称必填默认值参数用法说明
exchangestr交易所代码Y只能填写一个交易所代码 交易所代码清单: SHSE:上海证券交易所,SZSE:深圳证券交易所,CFFEX:中金所,SHFE:上期所,DCE:大商所,CZCE:郑商所,INE:上海国际能源交易中心
start_yearint开始年份Y查询交易日历开始年份(含),yyyy 格式
end_yearint结束年份Y查询交易日历结束年份(含),yyyy 格式

返回值:dataframe

字段名类型中文名称说明
datestr自然日期查询年份的自然日日期
trade_datestr交易日期查询年份的交易日日期,如果所在自然日不是交易日,交易日期为空字符串''
next_trade_datestr下一交易日交易日对应的下一交易日
pre_trade_datestr上一交易日交易日对应的上一交易日

示例:

get_trading_dates_by_year(exchange='SHSE', start_year=2020, end_year=2023)

输出:

            date next_trade_date pre_trade_date  trade_date
0     2020-01-01      2020-01-02     2019-12-31
1     2020-01-02      2020-01-03     2019-12-31  2020-01-02
2     2020-01-03      2020-01-06     2020-01-02  2020-01-03
3     2020-01-04      2020-01-06     2020-01-03
4     2020-01-05      2020-01-06     2020-01-03
         ...             ...            ...         ...
1456  2023-12-27      2023-12-28     2023-12-26  2023-12-27
1457  2023-12-28      2023-12-29     2023-12-27  2023-12-28
1458  2023-12-29      2024-01-02     2023-12-28  2023-12-29
1459  2023-12-30      2024-01-02     2023-12-29
1460  2023-12-31      2024-01-02     2023-12-29

[1461 rows x 4 columns]

注意:

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

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

get_trading_session - 查询交易时段

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

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

函数原型:

get_trading_session(symbols, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list标的代码Y输入标的代码,可输入多个. 采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002'].
dfbool返回格式NFalse是否返回 dataframe 格式, 默认False返回字典格式,返回list[dict],列表每项的 dict 的 key 值见返回字段名

返回值:

字段名类型中文名称说明
symbolstr标的代码exchange.sec_id
exchangestr交易所代码SHSE:上海证券交易所,SZSE:深圳证券交易所,CFFEX:中金所, SHFE:上期所,DCE:大商所,CZCE:郑商所,INE:上海国际能源交易中心
time_tradinglist[dict]连续竞价时段HH:MM 格式,按时间顺序排列,如品种存在夜盘,夜盘时段排最前。 如[{'start': '09:30','end': '11:30'}, {'start': '13:00', 'end': '14:57'}]
time_callautionlist[dict]集合竞价时段HH:MM 格式,按时间顺序排列,如品种存在夜盘,夜盘时段排最前。 如[{’start': '09:15', 'end': '09:25'},{'start': '14:57', 'end': '15:00'}]

示例:

get_trading_session(symbols='SHFE.au2306', df=False)

输出:

[{'symbol': 'SHFE.AU2306', 'exchange': 'SHFE', 'time_trading': [{'start': '21:00', 'end': '2:30'}, {'start': '9:00', 'end': '10:15'}, {'start': '10:30', 'end': '11:30'}, {'start': '13:30', 'end': '15:00'}], 'time_auction': [{'start': '20:55', 'end': '20:59'}]}]

注意:

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

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

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

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

函数原型:

get_contract_expire_rest_days(symbols, start_date=None, end_date=None, trade_flag = False, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list标的代码Y输入标的代码,可输入多个. 采用 str 格式时,多个标的代码必须用英文逗号分割,如:'CFFEX.IF2212,CFFEX.IC2212' 采用 list 格式时,多个标的代码示例:['CFFEX.IF2212', CFFEX.IC2212'].
start_datestr or datetime开始日期NNone%Y-%m-%d 格式,不早于合约上市日 默认None表示最新时间.
end_datestr or datetime结束日期NNone%Y-%m-%d 格式,不早于指定的开始日期,否则返回报错 默认None表示最新时间.
trade_flagbool交易日NFalse是否需要按交易日计算,默认False按自然日计算,则返回到期剩余自然日天数; 设置为True按交易日计算,则返回到期剩余交易日天数
dfbool返回格式NFalse是否返回 dataframe 格式, 默认False返回字典格式,返回list[dict],列表每项的 dict 的 key 值见返回字段名

返回值:

字段名类型中文名称说明
datestr日期[开始日期,结束日期]内的自然日期
symbolstr合约代码exchange.sec_id
days_to_expireint到期剩余天数合约在指定交易时间至合约到期日的剩余天数. trade_flag=False,计算方法按自然日 trade_flag=True,计算方法按交易日

示例:

get_contract_expire_rest_days(symbols='CFFEX.IM2212', start_date='2022-12-12', end_date='2022-12-16', trade_flag = True, df=True)

输出:

         date        symbol  days_to_expire
0  2022-12-12  CFFEX.IM2212               4
1  2022-12-13  CFFEX.IM2212               3
2  2022-12-14  CFFEX.IM2212               2
3  2022-12-15  CFFEX.IM2212               1
4  2022-12-16  CFFEX.IM2212               0

注意:

1. 参数start_dateend_date必须是 pd.to_dateime()可识别的字符串 str 格式,例'yyyy-mm-dd', 'yyyy-mm-dd %H:%M:%S',或者是 datetime 对象

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

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

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

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

5.7股票基础数据函数(免费)

python 股票与指数数据 API 包含在 gm3.0.148 版本及以上版本


stk_get_index_constituents - 查询指数成分股

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

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

函数原型:

stk_get_index_constituents(index, trade_date=None)

参数:

参数名类型中文名称必填默认值参数用法说明
indexstr指数代码Y必填,只能输入一个指数,如:'SHSE.000905'
trade_datestr交易日期NNone交易日期,%Y-%m-%d 格式, 默认None为最新交易日

返回值:dataframe

字段名类型中文名称说明
indexstr指数代码查询成分股的指数代码
symbolstr成分股代码exchange.sec_id
weightfloat成分股权重成分股 symbol 对应的指数权重
trade_datestr交易日期最新交易日,%Y-%m-%d 格式
market_value_totalfloat总市值单位:亿元
market_value_circfloat流通市值单位:亿元

示例:

stk_get_index_constituents(index='SHSE.000300')

输出:

          index       symbol  weight  trade_date  market_value_total  market_value_circ
0    SHSE.000300  SHSE.600519    0.05  2023-04-18            22083.96           22083.96
1    SHSE.000300  SZSE.300750    0.03  2023-04-18             9989.35            8822.91
2    SHSE.000300  SHSE.601318    0.03  2023-04-18             8887.85            5266.84
3    SHSE.000300  SHSE.600036    0.02  2023-04-18             8998.44            7360.41
4    SHSE.000300  SZSE.000858    0.02  2023-04-18             6921.68            6921.39
5    SHSE.000300  SZSE.000333    0.01  2023-04-18             3972.72            3891.18
6    SHSE.000300  SHSE.601166    0.01  2023-04-18             3616.80            3616.80
7    SHSE.000300  SHSE.600900    0.01  2023-04-18             5030.92            4834.92
8    SHSE.000300  SHSE.601012    0.01  2023-04-18             3033.36            3031.97
9    SHSE.000300  SZSE.300059    0.01  2023-04-18             2859.02            2399.14
10   SHSE.000300  SZSE.002594    0.01  2023-04-18             7248.75            2900.26...

注意:

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

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

3. 指数列表参考


stk_get_fundamentals_balance - 查询资产负债表数据

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

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

函数原型:

stk_get_fundamentals_balance(symbol, rpt_type=None, data_type=None, start_date=None, end_date=None, fields, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolstr股票代码Y必填,只能填一个股票标的,使用时参考symbol(opens new window)
fieldsstr返回字段Y指定需要返回的财务字段, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型: 1-一季度报
6-中报
9-前三季报
12-年报 默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整
201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
start_datestr开始时间NNone开始时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
end_datestr结束时间NNone结束时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定返回 fields字段的数值. 支持的字段名请参考 资产负债表

示例:

stk_get_fundamentals_balance(symbol='SHSE.600000', rpt_type=12, data_type=None, start_date='2022-12-31', end_date='2022-12-31', fields='lt_eqy_inv', df=True)

输出:

        symbol    pub_date    rpt_date  rpt_type  data_type    lt_eqy_inv
0  SHSE.600000  2022-10-29  2021-12-31        12        102 2819000000.00

注意:

1. 当start_date == end_date时,取离 end_date 最近报告日期的一条数据,

start_datend_date时,取指定时间段的数据,

当 start_date > end_date时,返回报错。

2. 若在指定历史时间段内,有多个同一类型报表(如不同年份的一季度报表),将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确,或填写空字段,会报错提示“填写的 fields 不正确”。fields不能超过20个字段

资产负债表

字段名类型中文名称量纲说明
流动资产(资产)
cash_bal_cbfloat现金及存放中央银行款项银行
dpst_obfloat存放同业款项银行
mny_cptlfloat货币资金
cust_cred_dpstfloat客户信用资金存款证券
cust_dpstfloat客户资金存款证券
pmfloat贵金属银行
bal_clrfloat结算备付金
cust_rsvfloat客户备付金证券
ln_to_obfloat拆出资金
fair_val_fin_astfloat以公允价值计量且其变动计入当期损益的金融资产
ppayfloat预付款项
fin_outfloat融出资金
trd_fin_astfloat交易性金融资产
deriv_fin_astfloat衍生金融资产
note_acct_rcvfloat应收票据及应收账款
note_rcvfloat应收票据
acct_rcvfloat应收账款
acct_rcv_finfloat应收款项融资
int_rcvfloat应收利息
dvd_rcvfloat应收股利
oth_rcvfloat其他应收款
in_prem_rcvfloat应收保费
rin_acct_rcvfloat应收分保账款
rin_rsv_rcvfloat应收分保合同准备金保险
rcv_un_prem_rin_rsvfloat应收分保未到期责任准备金
rcv_clm_rin_rsvfloat应收分保未决赔偿准备金保险
rcv_li_rin_rsvfloat应收分保寿险责任准备金保险
rcv_lt_hi_rin_rsvfloat应收分保长期健康险责任准备金保险
ph_plge_lnfloat保户质押贷款保险
ttl_oth_rcvfloat其他应收款合计
rfd_dpstfloat存出保证金证券、保险
term_dpstfloat定期存款保险
pur_resell_finfloat买入返售金融资产
aval_sale_finfloat可供出售金融资产
htm_invfloat持有至到期投资
hold_for_salefloat持有待售资产
acct_rcv_invfloat应收款项类投资保险
invtfloat存货
contr_astfloat合同资产
ncur_ast_one_yfloat一年内到期的非流动资产
oth_cur_astfloat其他流动资产
cur_ast_oth_itemfloat流动资产其他项目
ttl_cur_astfloat流动资产合计
非流动资产(资产)
loan_advfloat发放委托贷款及垫款
cred_invfloat债权投资
oth_cred_invfloat其他债权投资
lt_rcvfloat长期应收款
lt_eqy_invfloat长期股权投资
oth_eqy_invfloat其他权益工具投资
rfd_cap_guar_dpstfloat存出资本保证金保险
oth_ncur_fin_astfloat其他非流动金融资产
amor_cos_fin_ast_ncurfloat以摊余成本计量的金融资产(非流动)
fair_val_oth_inc_ncurfloat以公允价值计量且其变动计入其他综合收益的金融资产(非流动)
inv_propfloat投资性房地产
fix_astfloat固定资产
const_progfloat在建工程
const_matlfloat工程物资
fix_ast_dlplfloat固定资产清理
cptl_bio_astfloat生产性生物资产
oil_gas_astfloat油气资产
rig_astfloat使用权资产
intg_astfloat无形资产
trd_seat_feefloat交易席位费证券
dev_expfloat开发支出
gwfloat商誉
lt_ppay_expfloat长期待摊费用
dfr_tax_astfloat递延所得税资产
oth_ncur_astfloat其他非流动资产
ncur_ast_oth_itemfloat非流动资产其他项目
ttl_ncur_astfloat非流动资产合计
oth_astfloat其他资产银行、证券、保险
ast_oth_itemfloat资产其他项目
ind_acct_astfloat独立账户资产保险
ttl_astfloat资产总计
流动负债(负债)
brw_cbfloat向中央银行借款
dpst_ob_fin_instfloat同业和其他金融机构存放款项银行、保险
ln_fm_obfloat拆入资金
fair_val_fin_liabfloat以公允价值计量且其变动计入当期损益的金融负债
sht_lnfloat短期借款
adv_acctfloat预收款项
contr_liabfloat合同负债
trd_fin_liabfloat交易性金融负债
deriv_fin_liabfloat衍生金融负债
sell_repo_astfloat卖出回购金融资产款
cust_bnk_dpstfloat吸收存款银行、保险
dpst_cb_note_payfloat存款证及应付票据银行
dpst_cbfloat存款证银行
acct_rcv_advfloat预收账款保险
in_prem_rcv_advfloat预收保费保险
fee_payfloat应付手续费及佣金
note_acct_payfloat应付票据及应付账款
stlf_payfloat应付短期融资款
note_payfloat应付票据
acct_payfloat应付账款
rin_acct_payfloat应付分保账款
emp_comp_payfloat应付职工薪酬
tax_payfloat应交税费
int_payfloat应付利息
dvd_payfloat应付股利
ph_dvd_payfloat应付保单红利保险
indem_payfloat应付赔付款保险
oth_payfloat其他应付款
ttl_oth_payfloat其他应付款合计
ph_dpst_invfloat保户储金及投资款保险
in_contr_rsvfloat保险合同准备金保险
un_prem_rsvfloat未到期责任准备金保险
clm_rin_rsvfloat未决赔款准备金保险
li_liab_rsvfloat寿险责任准备金保险
lt_hi_liab_rsvfloat长期健康险责任准备金保险
cust_bnk_dpst_finfloat吸收存款及同业存放
inter_payfloat内部应付款
agy_secu_trdfloat代理买卖证券款
agy_secu_uwfloat代理承销证券款
sht_bnd_payfloat应付短期债券
est_cur_liabfloat预计流动负债
liab_hold_for_salefloat持有待售负债
ncur_liab_one_yfloat一年内到期的非流动负债
oth_cur_liabfloat其他流动负债
cur_liab_oth_itemfloat流动负债其他项目
ttl_cur_liabfloat流动负债合计
非流动负债(负债)
lt_lnfloat长期借款
lt_payfloat长期应付款
leas_liabfloat租赁负债
dfr_incfloat递延收益
dfr_tax_liabfloat递延所得税负债
bnd_payfloat应付债券
bnd_pay_pbdfloat其中:永续债
bnd_pay_pfdfloat其中:优先股
oth_ncur_liabfloat其他非流动负债
spcl_payfloat专项应付款
ncur_liab_oth_itemfloat非流动负债其他项目
lt_emp_comp_payfloat长期应付职工薪酬
est_liabfloat预计负债
oth_liabfloat其他负债银行、证券、保险
liab_oth_itemfloat负债其他项目银行、证券、保险
ttl_ncur_liabfloat非流动负债合计
ind_acct_liabfloat独立账户负债保险
ttl_liabfloat负债合计
所有者权益(或股东权益)
paid_in_cptlfloat实收资本(或股本)
oth_eqyfloat其他权益工具
oth_eqy_pfdfloat其中:优先股
oth_eqy_pbdfloat其中:永续债
oth_eqy_othfloat其中:其他权益工具
cptl_rsvfloat资本公积
treas_shrfloat库存股
oth_comp_incfloat其他综合收益
spcl_rsvfloat专项储备
sur_rsvfloat盈余公积
rsv_ord_rskfloat一般风险准备
trd_risk_rsvfloat交易风险准备证券
ret_proffloat未分配利润
sugg_dvdfloat建议分派股利银行
eqy_pcom_oth_itemfloat归属于母公司股东权益其他项目
ttl_eqy_pcomfloat归属于母公司股东权益合计
min_sheqyfloat少数股东权益
sheqy_oth_itemfloat股东权益其他项目
ttl_eqyfloat股东权益合计
ttl_liab_eqyfloat负债和股东权益合计

stk_get_fundamentals_cashflow - 查询现金流量表数据

查询指定时间段某一股票所属上市公司的现金流量表数据

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

函数原型:

stk_get_fundamentals_cashflow(symbol, rpt_type=None, data_type=None, start_date=None, end_date=None, fields, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolstr股票代码Y必填,只能填一个股票标的,使用时参考symbol(opens new window)
fieldsstr返回字段Y指定需要返回的财务字段, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型: 1-一季度报
6-中报
9-前三季报
12-年报 默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整
201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
start_datestr开始时间NNone开始时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
end_datestr结束时间NNone结束时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定返回 fields字段的数值. 支持的字段名请参考 现金流量表

示例:

stk_get_fundamentals_cashflow(symbol='SHSE.600000', rpt_type=None, data_type=101, start_date='2022-12-31', end_date='2022-12-31', fields='cash_pay_fee', df=True)

输出:

        symbol    pub_date    rpt_date  rpt_type  data_type  cash_pay_fee
0  SHSE.600000  2022-10-29  2022-09-30         9        101 7261000000.00

注意:

1. 当start_date == end_date时,取离 end_date 最近报告日期的一条数据,

start_datend_date时,取指定时间段的数据,

当 start_date > end_date时,返回报错。

2. 若在指定历史时间段内,有多个同一类型报表(如不同年份的一季度报表),将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确,或填写空字段,会报错提示“填写的 fields 不正确”。fields不能超过20个字段

现金流量表

字段名类型中文名称量纲说明
一、经营活动产生的现金流量
cash_rcv_salefloat销售商品、提供劳务收到的现金
net_incr_cust_dpst_obfloat客户存款和同业存放款项净增加额
net_incr_cust_dpstfloat客户存款净增加额银行
net_incr_dpst_obfloat同业及其他金融机构存放款项净增加额银行
net_incr_brw_cbfloat向中央银行借款净增加额
net_incr_ln_fm_othfloat向其他金融机构拆入资金净增加额
cash_rcv_orig_infloat收到原保险合同保费取得的现金
net_cash_rcv_rin_bizfloat收到再保险业务现金净额
net_incr_ph_dpst_invfloat保户储金及投资款净增加额
net_decrdpst_cb_obfloat存放中央银行和同业款项及其他金融机构净减少额银行、保险
net_decr_cbfloat存放中央银行款项净减少额银行
net_decr_ob_fin_instfloat存放同业及其他金融机构款项净减少额银行
net_cert_dpstfloat存款证净额银行
net_decr_trd_finfloat交易性金融资产净减少额银行
net_incr_trd_liabfloat交易性金融负债净增加额银行
cash_rcv_int_feefloat收取利息、手续费及佣金的现金
cash_rcv_intfloat其中:收取利息的现金银行
cash_rcv_feefloat收取手续费及佣金的现金银行
net_incr_lnfm_sell_repofloat拆入资金及卖出回购金融资产款净增加额银行
net_incr_ln_fmfloat拆入资金净增加额
net_incr_sell_repofloat卖出回购金融资产款净增加额银行 保险
net_decr_lnto_pur_resellfloat拆出资金及买入返售金融资产净减少额银行
net_decr_ln_cptlfloat拆出资金净减少额银行、保险
net_dect_pur_resellfloat买入返售金融资产净减少额银行、保险
net_incr_repofloat回购业务资金净增加额
net_decr_repofloat回购业务资金净减少额证券
tax_rbt_rcvfloat收到的税费返还
net_cash_rcv_trdfloat收到交易性金融资产现金净额保险
cash_rcv_oth_operfloat收到其他与经营活动有关的现金
net_cash_agy_secu_trdfloat代理买卖证券收到的现金净额证券
cash_rcv_pur_resellfloat买入返售金融资产收到的现金证券、保险
net_cash_agy_secu_uwfloat代理承销证券收到的现金净额证券
cash_rcv_dspl_debtfloat处置抵债资产收到的现金银行
canc_loan_rcvfloat收回的已于以前年度核销的贷款银行
cf_in_operfloat经营活动现金流入小计
cash_pur_gds_svcfloat购买商品、接受劳务支付的现金
net_incr_ln_adv_custfloat客户贷款及垫款净增加额
net_decr_brw_cbfloat向中央银行借款净减少额银行
net_incr_dpst_cb_obfloat存放中央银行和同业款项净增加额
net_incr_cbfloat存放中央银行款项净增加额银行
net_incr_ob_fin_instfloat存放同业及其他金融机构款项净增加额银行
net_decr_dpst_obfloat同业及其他机构存放款减少净额银行
net_decr_issu_cert_dpstfloat已发行存款证净减少额银行
net_incr_lnto_pur_resellfloat拆出资金及买入返售金融资产净增加额银行
net_incr_ln_tofloat拆出资金净增加额银行、保险
net_incr_pur_resellfloat买入返售金融资产净增加额银行、保险
net_decr_lnfm_sell_repofloat拆入资金及卖出回购金融资产款净减少额银行
net_decr_ln_fmfloat拆入资金净减少额银行、证券
net_decr_sell_repofloat卖出回购金融资产净减少额银行、保险
net_incr_trd_finfloat交易性金融资产净增加额银行
net_decr_trd_liabfloat交易性金融负债净减少额银行
cash_pay_indem_origfloat支付原保险合同赔付款项的现金
net_cash_pay_rin_bizfloat支付再保险业务现金净额保险
cash_pay_int_feefloat支付利息、手续费及佣金的现金
cash_pay_intfloat其中:支付利息的现金银行
cash_pay_feefloat支付手续费及佣金的现金银行
ph_dvd_payfloat支付保单红利的现金
net_decr_ph_dpst_invfloat保户储金及投资款净减少额保险
cash_pay_empfloat支付给职工以及为职工支付的现金
cash_pay_taxfloat支付的各项税费
net_cash_pay_trdfloat支付交易性金融资产现金净额保险
cash_pay_oth_operfloat支付其他与经营活动有关的现金
net_incr_dspl_trd_finfloat处置交易性金融资产净增加额
cash_pay_fin_leasfloat购买融资租赁资产支付的现金银行
net_decr_agy_secu_payfloat代理买卖证券支付的现金净额(净减少额)证券
net_decr_dspl_trd_finfloat处置交易性金融资产的净减少额证券
cf_out_operfloat经营活动现金流出小计
net_cf_operfloat经营活动产生的现金流量净额
二、投资活动产生的现金流量:
cash_rcv_sale_invfloat收回投资收到的现金
inv_inc_rcvfloat取得投资收益收到的现金
cash_rcv_dvd_proffloat分得股利或利润所收到的现金银行
cash_rcv_dspl_astfloat处置固定资产、无形资产和其他长期资产收回的现金净额
cash_rcv_dspl_sub_othfloat处置子公司及其他营业单位收到的现金净额
cash_rcv_oth_invfloat收到其他与投资活动有关的现金
cf_in_invfloat投资活动现金流入小计
pur_fix_intg_astfloat购建固定资产、无形资产和其他长期资产支付的现金
cash_out_dspl_sub_othfloat处置子公司及其他营业单位流出的现金净额保险
cash_pay_invfloat投资支付的现金
net_incr_ph_plge_lnfloat保户质押贷款净增加额保险
add_cash_pled_dpstfloat增加质押和定期存款所支付的现金
net_incr_plge_lnfloat质押贷款净增加额
net_cash_get_subfloat取得子公司及其他营业单位支付的现金净额
net_pay_pur_resellfloat支付买入返售金融资产现金净额证券、保险
cash_pay_oth_invfloat支付其他与投资活动有关的现金
cf_out_invfloat投资活动现金流出小计
net_cf_invfloat投资活动产生的现金流量净额
三、筹资活动产生的现金流量:
cash_rcv_cptlfloat吸收投资收到的现金
sub_rcv_ms_invfloat其中:子公司吸收少数股东投资收到的现金
brw_rcvfloat取得借款收到的现金
cash_rcv_bnd_issfloat发行债券收到的现金
net_cash_rcv_sell_repofloat收到卖出回购金融资产款现金净额保险
cash_rcv_oth_finfloat收到其他与筹资活动有关的现金
issu_cert_dpstfloat发行存款证银行
cf_in_fin_othfloat筹资活动现金流入其他项目
cf_in_finfloat筹资活动现金流入小计
cash_rpay_brwfloat偿还债务支付的现金
cash_pay_bnd_intfloat偿付债券利息支付的现金银行
cash_pay_dvd_intfloat分配股利、利润或偿付利息支付的现金
sub_pay_dvd_proffloat其中:子公司支付给少数股东的股利、利润
cash_pay_oth_finfloat支付其他与筹资活动有关的现金
net_cash_pay_sell_repofloat支付卖出回购金融资产款现金净额保险
cf_out_finfloat筹资活动现金流出小计
net_cf_finfloat筹资活动产生的现金流量净额
efct_er_chg_cashfloat四、汇率变动对现金及现金等价物的影响
net_incr_cash_eqfloat五、现金及现金等价物净增加额
cash_cash_eq_bgnfloat加:期初现金及现金等价物余额
cash_cash_eq_endfloat六、期末现金及现金等价物余额
补充资料 1.将净利润调节为经营活动现金流量:
net_proffloat净利润
ast_imprfloat资产减值准备
accr_prvs_ln_impafloat计提贷款减值准备银行
accr_prvs_oth_impafloat计提其他资产减值准备银行
accr_prem_rsvfloat提取的保险责任准备金保险
accr_unearn_prem_rsvfloat提取的未到期的责任准备金保险
defr_fix_propfloat固定资产和投资性房地产折旧
depr_oga_cbafloat其中:固定资产折旧、油气资产折耗、生产性生物资产折旧
amor_intg_ast_lt_expfloat无形资产及长期待摊费用等摊销银行、证券、保险
amort_intg_astfloat无形资产摊销
amort_lt_exp_ppayfloat长期待摊费用摊销
dspl_ast_lossfloat处置固定资产、无形资产和其他长期资产的损失
fair_val_chg_lossfloat固定资产报废损失
fv_chg_lossfloat公允价值变动损失
dfafloat固定资产折旧银行
fin_expfloat财务费用
inv_lossfloat投资损失
exchg_lossfloat汇兑损失银行、证券、保险
dest_incrfloat存款的增加银行
loan_decrfloat贷款的减少银行
cash_pay_bnd_int_issfloat发行债券利息支出银行
dfr_taxfloat递延所得税
dfr_tax_ast_decrfloat其中:递延所得税资产减少
dfr_tax_liab_incrfloat递延所得税负债增加
invt_decrfloat存货的减少
decr_rcv_operfloat经营性应收项目的减少
incr_pay_operfloat经营性应付项目的增加
othfloat其他
cash_endfloat现金的期末余额
cash_bgnfloat减:现金的期初余额
cash_eq_endfloat加:现金等价物的期末余额
cash_eq_bgnfloat减:现金等价物的期初余额
cred_impr_lossfloat信用减值损失
est_liab_addfloat预计负债的增加
dr_cnv_cptlfloat债务转为资本
cptl_bnd_expr_one_yfloat一年内到期的可转换公司债券
fin_ls_fix_astfloat融资租入固定资产
amort_dfr_incfloat递延收益摊销
depr_inv_propfloat投资性房地产折旧
trd_fin_decrfloat交易性金融资产的减少证券、保险
im_net_cf_operfloat间接法-经营活动产生的现金流量净额
im_net_incr_cash_eqfloat间接法-现金及现金等价物净增加额

stk_get_fundamentals_income - 查询利润表数据

查询指定时间段某一股票所属上市公司的利润表数据

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

函数原型:

stk_get_fundamentals_income(symbol, rpt_type=None, data_type=None, start_date=None, end_date=None, fields, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolstr股票代码Y必填,只能填一个股票标的,使用时参考symbol(opens new window)
fieldsstr返回字段Y指定需要返回的财务字段, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型: 1-一季度报
6-中报
9-前三季报
12-年报 默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整
201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
start_datestr开始时间NNone开始时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
end_datestr结束时间NNone结束时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定返回 fields字段的数值. 支持的字段名请参考 利润表

示例:

stk_get_fundamentals_income(symbol='SHSE.600000', rpt_type=6, data_type=None, start_date='2022-12-31', end_date='2022-12-31', fields='inc_oper', df=True)

输出:

        symbol    pub_date    rpt_date  rpt_type  data_type       inc_oper
0  SHSE.600000  2022-08-27  2022-06-30         6        102 98644000000.00

注意:

1. 当start_date == end_date时,取离 end_date 最近报告日期的一条数据,

start_datend_date时,取指定时间段的数据,

当 start_date > end_date时,返回报错。

2. 若在指定历史时间段内,有多个同一类型报表(如不同年份的一季度报表),将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确,或填写空字段,会报错提示“填写的 fields 不正确”。fields不能超过20个字段

利润表

字段名类型中文名称量纲说明
ttl_inc_operfloat营业总收入
inc_operfloat营业收入
net_inc_intfloat利息净收入证券、银行、保险
exp_intfloat利息支出
net_inc_fee_commfloat手续费及佣金净收入证券、银行
inc_rin_premfloat其中:分保费收入保险
net_inc_secu_agyfloat其中:代理买卖证券业务净收入证券
inc_fee_commfloat手续费及佣金收入
in_prem_earnfloat已赚保费保险
inc_in_bizfloat其中:保险业务收入保险
rin_prem_cedefloat分出保费保险
unear_prem_rsvfloat提取未到期责任准备金保险
net_inc_uwfloat证券承销业务净收入证券
net_inc_cust_ast_mgmtfloat受托客户资产管理业务净收入证券
inc_fxfloat汇兑收益
inc_other_operfloat其他业务收入
inc_oper_balancefloat营业收入平衡项目
ttl_inc_oper_otherfloat营业总收入其他项目
ttl_cost_operfloat营业总成本
cost_operfloat营业成本
exp_operfloat营业支出证券、银行、保险
biz_tax_surfloat营业税金及附加
exp_sellfloat销售费用
exp_admfloat管理费用
exp_rdfloat研发费用
exp_finfloat财务费用
int_feefloat其中:利息费用
inc_intfloat利息收入
exp_oper_admfloat业务及管理费证券、银行、保险
exp_rinfloat减:摊回分保费用保险
rfd_premfloat退保金保险
comp_payfloat赔付支出保险
rin_clm_payfloat减:摊回赔付支出保险
draw_insur_liabfloat提取保险责任准备金保险
amor_insur_liabfloat减:摊回保险责任准备金保险
exp_ph_dvdfloat保单红利支出保险
exp_fee_commfloat手续费及佣金支出
other_oper_costfloat其他业务成本
oper_exp_balancefloat营业支出平衡项目证券、银行、保险
exp_oper_otherfloat营业支出其他项目证券、银行、保险
ttl_cost_oper_otherfloat营业总成本其他项目
其他经营收益
inc_invfloat投资收益
inv_inv_jv_pfloat对联营企业和合营企业的投资收益
inc_ast_dsplfloat资产处置收益
ast_impr_lossfloat资产减值损失(新)
cred_impr_lossfloat信用减值损失(新)
inc_fv_chgfloat公允价值变动收益
inc_otherfloat其他收益
oper_prof_balancefloat营业利润平衡项目
oper_proffloat营业利润
inc_noperfloat营业外收入
exp_noperfloat营业外支出
ttl_prof_balancefloat利润总额平衡项目
oper_prof_otherfloat营业利润其他项目
ttl_proffloat利润总额
inc_taxfloat所得税费用
net_proffloat净利润
oper_net_proffloat持续经营净利润
net_prof_pcomfloat归属于母公司股东的净利润
min_int_incfloat少数股东损益
end_net_proffloat终止经营净利润
net_prof_otherfloat净利润其他项目
eps_basefloat基本每股收益
eps_dilfloat稀释每股收益
other_comp_incfloat其他综合收益
other_comp_inc_pcomfloat归属于母公司股东的其他综合收益
other_comp_inc_minfloat归属于少数股东的其他综合收益
ttl_comp_incfloat综合收益总额
ttl_comp_inc_pcomfloat归属于母公司所有者的综合收益总额
ttl_comp_inc_minfloat归属于少数股东的综合收益总额
prof_pre_mergefloat被合并方在合并前实现利润
net_rsv_in_contrfloat提取保险合同准备金净额
net_pay_compfloat赔付支出净额
net_loss_ncur_astfloat非流动资产处置净损失
amod_fin_asst_endfloat以摊余成本计量的金融资产终止确认收益
cash_flow_hedging_plfloat现金流量套期损益的有效部分
cur_trans_difffloat外币财务报表折算差额
gain_ncur_astfloat非流动资产处置利得
afs_fv_chg_plfloat可供出售金融资产公允价值变动损益
oth_eqy_inv_fv_chgfloat其他权益工具投资公允价值变动
oth_debt_inv_fv_chgfloat其他债权投资公允价值变动
oth_debt_inv_cred_imprfloat其他债权投资信用减值准备

stk_get_fundamentals_balance_pt - 查询资产负债表截面数据

查询指定日期截面的股票所属上市公司的资产负债表数据(point-in-time)

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

函数原型:

stk_get_fundamentals_balance_pt(symbols, rpt_type=None, data_type=None, date=None, fields, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list股票代码Y必填,可输入多个,使用时参考symbol (opens new window)采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002']
fieldsstr返回字段Y指定需要返回的财务字段, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型:
1-一季度报
6-中报
9-前三季报
12-年报
默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
datestr查询日期NNone查询时间,时间类型为发布日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 资产负债表

示例:

stk_get_fundamentals_balance_pt(symbols='SHSE.600000, SZSE.000001', rpt_type=None, data_type=None, date='2022-10-01', fields='fix_ast', df=True)

输出:

        symbol    pub_date    rpt_date        fix_ast  data_type  rpt_type
0  SZSE.000001  2022-10-25  2022-09-30 10975000000.00        102         9
1  SHSE.600000  2022-10-29  2022-09-30 42563000000.00        102         9

注意:

1. 为避免未来数据问题,指定查询日期date后,返回距离此日期最近发布的一条数据。 若多个报告期报表的最新发布日期相同,返回报告日期rpt_date距离查询日期date最近的一个报告期的报表数据。

2. 如果fields参数的财务字段填写不正确,或填写空字段"",会报错提示“填写的 fields 不正确”。fields不能超过20个字段

#stk_get_fundamentals_cashflow_pt - 查询现金流量表截面数据

查询指定日期截面的股票所属上市公司的现金流量表数据(point-in-time)

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

函数原型:

stk_get_fundamentals_cashflow_pt(symbols, rpt_type=None, data_type=None, date=None, fields, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list股票代码Y必填,可输入多个,使用时参考symbol (opens new window)采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002']
fieldsstr返回字段Y指定需要返回的财务字段, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型:
1-一季度报
6-中报
9-前三季报
12-年报
默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
datestr查询日期NNone查询时间,时间类型为发布日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 现金流量表

示例:

stk_get_fundamentals_cashflow_pt(symbols='SHSE.600000, SZSE.000001', rpt_type=None, data_type=None, date='2022-10-01', fields='cash_pay_fee', df=True)

输出:

        symbol    pub_date    rpt_date  rpt_type  data_type  cash_pay_fee
0  SZSE.000001  2022-10-25  2022-09-30         9        102           NaN
1  SHSE.600000  2022-10-29  2022-09-30         9        102 7261000000.00

注意:

1. 为避免未来数据问题,指定查询日期date后,返回距离此日期最近发布的一条数据。 若多个报告期报表的最新发布日期相同,返回报告日期rpt_date距离查询日期date最近的一个报告期的报表数据。

2. 如果fields参数的财务字段填写不正确,或填写空字段"",会报错提示“填写的 fields 无效”。


stk_get_fundamentals_income_pt - 查询利润表截面数据

查询指定日期截面的股票所属上市公司的利润表数据(point-in-time)

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

函数原型:

stk_get_fundamentals_income_pt(symbols, rpt_type=None, data_type=None, date=None, fields, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list股票代码Y必填,可输入多个,使用时参考symbol (opens new window)采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002']
fieldsstr返回字段Y指定需要返回的财务字段, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型:
1-一季度报
6-中报
9-前三季报
12-年报
默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
datestr查询日期NNone查询时间,时间类型为发布日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 利润表

示例:

stk_get_fundamentals_income_pt(symbols='SHSE.600000, SZSE.000001', rpt_type=None, data_type=None, date='2022-10-01', fields='inc_oper', df=True)

输出:

        symbol    pub_date    rpt_date  rpt_type  data_type        inc_oper
0  SZSE.000001  2022-10-25  2022-09-30         9        102 138265000000.00
1  SHSE.600000  2022-10-29  2022-09-30         9        102 143680000000.00

注意:

1. 为避免未来数据问题,指定查询日期date后,返回距离此日期最近发布的一条数据。 若多个报告期报表的最新发布日期相同,返回报告日期rpt_date距离查询日期date最近的一个报告期的报表数据。

2. 如果fields参数的财务字段填写不正确,或填写空字段"",会报错提示“填写的 fields 不正确”。fields不能超过20个字段


stk_get_finance_prime - 查询财务主要指标数据

查询指定时间段股票所属上市公司的财务主要指标

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

函数原型:

stk_get_finance_prime(symbol, fields, rpt_type=None, data_type=None, start_date=None, end_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolstr股票代码Y必填,只能填一个股票标的,使用时参考symbol(opens new window)
fieldsstr返回字段Y指定需要返回的财务主要指标, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型: 1-一季度报
6-中报
9-前三季报
12-年报 默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整
201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
start_datestr开始时间NNone开始时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
end_datestr结束时间NNone结束时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定返回 fields字段的数值. 支持的字段名请参考 财务主要指标

示例:

stk_get_finance_prime(symbol='SHSE.600000', fields='eps_basic,eps_dil',rpt_type=None, data_type=None,
start_date=None, end_date=None, df=True)

输出:

        symbol    pub_date    rpt_date  rpt_type  data_type  eps_dil  eps_basic
0  SHSE.600000  2023-04-29  2023-03-31         1        101     0.47       0.51

注意:

1. 当start_date == end_date时,取离 end_date 最近报告日期的一条数据,

start_datend_date时,取指定时间段的数据,

当 start_date > end_date时,返回报错。

2. 若在指定历史时间段内,有多个同一类型报表(如不同年份的一季度报表),将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确,或填写空字段,会报错提示“填写的 fields 不正确”。fields不能超过20个字段

财务主要指标

字段名类型中文名称量纲说明
eps_basicfloat基本每股收益
eps_dilfloat稀释每股收益
eps_basic_cutfloat扣除非经常性损益后的基本每股收益
eps_dil_cutfloat扣除非经常性损益后的稀释每股收益
net_cf_oper_psfloat每股经营活动产生的现金流量净额
bps_pcom_psfloat归属于母公司股东的每股净资产
ttl_astfloat总资产
ttl_liabfloat总负债
share_cptlfloat股本
ttl_inc_operfloat营业总收入
inc_operfloat营业收入
oper_proffloat营业利润
ttl_proffloat利润总额
ttl_eqy_pcomfloat归属于母公司股东的所有者权益
net_prof_pcomfloat归属于母公司股东的净利润
net_prof_pcom_cutfloat扣除非经常性损益后归属于母公司股东的净利润
roefloat全面摊薄净资产收益率%
roe_weight_avgfloat加权平均净资产收益率%
roe_cutfloat扣除非经常性损益后的全面摊薄净资产收益率%
roe_weight_avg_cutfloat扣除非经常性损益后的加权平均净资产收益率%
net_cf_operfloat经营活动产生的现金流量净额
eps_yoyfloat每股收益同比比例%
inc_oper_yoyfloat营业收入同比比例%
ttl_inc_oper_yoyfloat营业总收入同比比例%
net_prof_pcom_yoyfloat归母净利润同比比例%

stk_get_finance_deriv - 查询财务衍生指标数据

查询指定时间段股票所属上市公司的财务衍生指标

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

函数原型:

stk_get_finance_deriv(symbol, fields, rpt_type=None, data_type=None, start_date=None, end_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolstr股票代码Y必填,只能填一个股票标的,使用时参考symbol(opens new window)
fieldsstr返回字段Y指定需要返回的财务衍生指标, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型: 1-一季度报
6-中报
9-前三季报
12-年报 默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整
201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
start_datestr开始时间NNone开始时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
end_datestr结束时间NNone结束时间,时间类型为报告日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定返回 fields字段的数值. 支持的字段名请参考 财务衍生指标指标

示例:

stk_get_finance_deriv(symbol='SHSE.600000', fields='eps_basic,eps_dil2,eps_dil,eps_basic_cut', 
rpt_type=9, data_type=None, start_date=None, end_date=None, df=True)

输出:

        symbol    pub_date    rpt_date  ...  eps_dil  eps_basic  eps_dil2
0  SHSE.600000  2022-10-29  2022-09-30  ...   1.3785       1.31       1.2

注意:

1. 当start_date == end_date时,取离 end_date 最近报告日期的一条数据,

start_datend_date时,取指定时间段的数据,

当 start_date > end_date时,返回报错。

2. 若在指定历史时间段内,有多个同一类型报表(如不同年份的一季度报表),将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确,或填写空字段,会报错提示“填写的 fields 不正确”。fields不能超过20个字段

财务衍生指标指标

字段名类型中文名称量纲说明
eps_basicfloat每股收益EPS(基本)
eps_dil2float每股收益EPS(稀释)
eps_dilfloat每股收益EPS(期末股本摊薄)
eps_basic_cutfloat每股收益EPS(扣除/基本)
eps_dil2_cutfloat每股收益EPS(扣除/稀释)
eps_dil_cutfloat每股收益EPS(扣除/期末股本摊薄)
bpsfloat每股净资产BPS
net_cf_oper_psfloat每股经营活动产生的现金流量净额
ttl_inc_oper_psfloat每股营业总收入
inc_oper_psfloat每股营业收入
ebit_psfloat每股息税前利润
cptl_rsv_psfloat每股资本公积
sur_rsv_psfloat每股盈余公积
retain_prof_psfloat每股未分配利润
retain_inc_psfloat每股留存收益
net_cf_psfloat每股现金流量净额
fcff_psfloat每股企业自由现金流量
fcfe_psfloat每股股东自由现金流量
ebitda_psfloat每股EBITDA
roefloat净资产收益率ROE(摊薄)%
roe_weightfloat净资产收益率ROE(加权)%
roe_avgfloat净资产收益率ROE(平均)%
roe_cutfloat净资产收益率ROE(扣除/摊薄)%
roe_weight_cutfloat净资产收益率ROE(扣除/加权)%
ocf_toifloat经营性现金净流量/营业总收入
eps_dil_yoyfloat稀释每股收益同比增长率%
net_cf_oper_ps_yoyfloat每股经营活动中产生的现金流量净额同比增长率%
ttl_inc_oper_yoyfloat营业总收入同比增长率%
inc_oper_yoyfloat营业收入同比增长率%
oper_prof_yoyfloat营业利润同比增长率%
ttl_prof_yoyfloat利润总额同比增长率%
net_prof_pcom_yoyfloat归属母公司股东的净利润同比增长率%
net_prof_pcom_cut_yoyfloat归属母公司股东的净利润同比增长率(扣除非经常性损益)%
net_cf_oper_yoyfloat经营活动产生的现金流量净额同比增长率%
roe_yoyfloat净资产收益率同比增长率(摊薄)%
net_asset_yoyfloat净资产同比增长率%
ttl_liab_yoyfloat总负债同比增长率%
ttl_asset_yoyfloat总资产同比增长率%
net_cash_flow_yoyfloat现金净流量同比增长率%
bps_gr_begin_yearfloat每股净资产相对年初增长率%
ttl_asset_gr_begin_yearfloat资产总计相对年初增长率%
ttl_eqy_pcom_gr_begin_yearfloat归属母公司的股东权益相对年初增长率%
net_debt_eqy_evfloat净债务/股权价值%
int_debt_eqy_evfloat带息债务/股权价值
eps_bas_yoyfloat基本每股收益同比增长率%
ebitfloatEBIT(正推法)
ebitdafloatEBITDA(正推法)
ebit_inversefloatEBIT(反推法)
ebitda_inversefloatEBITDA(反推法)
nr_prof_lossfloat非经常性损益
net_prof_cutfloat扣除非经常性损益后的净利润
gross_proffloat毛利润
oper_net_incfloat经营活动净收益
val_chg_net_incfloat价值变动净收益
exp_rdfloat研发费用
ttl_inv_cptlfloat全部投入资本
work_cptlfloat营运资本
net_work_cptlfloat净营运资本
tg_assetfloat有形资产
retain_incfloat留存收益
int_debtfloat带息债务
net_debtfloat净债务
curr_liab_non_intfloat无息流动负债
ncur_liab_non_intfloat无息非流动负债
fcfffloat企业自由现金流量FCFF
fcfefloat股权自由现金流量FCFE
cur_depr_amortfloat当期计提折旧与摊销
eqy_mult_dupontfloat权益乘数(杜邦分析)
net_prof_pcom_npfloat归属母公司股东的净利润/净利润%
net_prof_tpfloat净利润/利润总额%
ttl_prof_ebitfloat利润总额/息税前利润%
roe_cut_avgfloat净资产收益率ROE(扣除/平均)%
roe_addfloat净资产收益率ROE(增发条件)%
roe_annfloat净资产收益率ROE(年化)%
roafloat总资产报酬率ROA%
roa_annfloat总资产报酬率ROA(年化)%
jroafloat总资产净利率%
jroa_annfloat总资产净利率(年化)%
roicfloat投入资本回报率ROIC%
sale_npmfloat销售净利率%
sale_gpmfloat销售毛利率%
sale_cost_ratefloat销售成本率%
sale_exp_ratefloat销售期间费用率%
net_prof_toifloat净利润/营业总收入%
oper_prof_toifloat营业利润/营业总收入%
ebit_toifloat息税前利润/营业总收入%
ttl_cost_oper_toifloat营业总成本/营业总收入%
exp_oper_toifloat营业费用/营业总收入%
exp_admin_toifloat管理费用/营业总收入%
exp_fin_toifloat财务费用/营业总收入%
ast_impr_loss_toifloat资产减值损失/营业总收入%
ebitda_toifloatEBITDA/营业总收入%
oper_net_inc_tpfloat经营活动净收益/利润总额%
val_chg_net_inc_tpfloat价值变动净收益/利润总额%
net_exp_noper_tpfloat营业外支出净额/利润总额
inc_tax_tpfloat所得税/利润总额%
net_prof_cut_npfloat扣除非经常性损益的净利润/净利润%
eqy_multfloat权益乘数
curr_ast_tafloat流动资产/总资产%
ncurr_ast_tafloat非流动资产/总资产%
tg_ast_tafloat有形资产/总资产%
ttl_eqy_pcom_ticfloat归属母公司股东的权益/全部投入资本%
int_debt_ticfloat带息负债/全部投入资本%
curr_liab_tlfloat流动负债/负债合计%
ncurr_liab_tlfloat非流动负债/负债合计%
ast_liab_ratefloat资产负债率%
quick_ratefloat速动比率
curr_ratefloat流动比率
cons_quick_ratefloat保守速动比率
liab_eqy_ratefloat产权比率
ttl_eqy_pcom_tlfloat归属母公司股东的权益/负债合计
ttl_eqy_pcom_debtfloat归属母公司股东的权益/带息债务
tg_ast_tlfloat有形资产/负债合计
tg_ast_int_debtfloat有形资产/带息债务
tg_ast_net_debtfloat有形资产/净债务
ebitda_tlfloat息税折旧摊销前利润/负债合计
net_cf_oper_tlfloat经营活动产生的现金流量净额/负债合计
net_cf_oper_int_debtfloat经营活动产生的现金流量净额/带息债务
net_cf_oper_curr_liabfloat经营活动产生的现金流量净额/流动负债
net_cf_oper_net_liabfloat经营活动产生的现金流量净额/净债务
ebit_int_coverfloat已获利息倍数
long_liab_work_cptlfloat长期债务与营运资金比率
ebitda_int_debtfloatEBITDA/带息债务%
oper_cyclefloat营业周期
inv_turnover_daysfloat存货周转天数
acct_rcv_turnover_daysfloat应收账款周转天数(含应收票据)
inv_turnover_ratefloat存货周转率
acct_rcv_turnover_ratefloat应收账款周转率(含应收票据)
curr_ast_turnover_ratefloat流动资产周转率
fix_ast_turnover_ratefloat固定资产周转率
ttl_ast_turnover_ratefloat总资产周转率
cash_rcv_sale_oifloat销售商品提供劳务收到的现金/营业收入%
net_cf_oper_oifloat经营活动产生的现金流量净额/营业收入%
net_cf_oper_onifloat经营活动产生的现金流量净额/经营活动净收益
cptl_exp_dafloat资本支出/折旧摊销%
cash_ratefloat现金比率
acct_pay_turnover_daysfloat应付账款周转天数(含应付票据)
acct_pay_turnover_ratefloat应付账款周转率(含应付票据)
net_oper_cyclefloat净营业周期
ttl_cost_oper_yoyfloat营业总成本同比增长率%
net_prof_yoyfloat净利润同比增长率%
net_cf_oper_npfloat经营活动产生的现金流量净额/净利润%

stk_get_daily_valuation - 查询估值指标每日数据

查询指定时间段股票的每日估值指标

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

函数原型:

stk_get_finance_deriv(symbol, fields, rpt_type=None, data_type=None, start_date=None, end_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolstr股票代码Y必填,只能填一个股票标的,使用时参考symbol(opens new window)
fieldsstr返回字段Y指定需要返回的财务字段, 如有多个字段,中间用英文逗号分隔
start_datestr开始时间NNone开始时间,时间类型为交易日期,%Y-%m-%d 格式, 默认None表示最新时间
end_datestr结束时间NNone结束时间,时间类型为交易日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
trade_datestr交易日期
fieldslist[float]指标字段数据指定返回 fields字段的数值. 支持的字段名请参考 估值指标

示例:

stk_get_daily_valuation(symbol='SHSE.600000', fields='pe_ttm,pe_lyr,pe_mrq', start_date=None, end_date=None, df=True)

输出:

        symbol  trade_date  pe_ttm  pe_lyr  pe_mrq
0  SHSE.600000  2023-06-26  4.4139   4.107  3.3188

注意:

1. 当start_date == end_date时,取离 end_date 最近交易日期的一条数据,

start_datend_date时,取指定时间段的数据,

当 start_date > end_date时,返回报错。

2. 如果fields参数的指标字段填写不正确,或填写空字段,会报错提示“填写的 fields 不正确”。fields不能超过20个字段

估值指标

字段名类型中文名称量纲说明
pe_ttmfloat市盈率(TTM)
pe_lyrfloat市盈率(最新年报LYR)
pe_mrqfloat市盈率(最新报告期MRQ)
pe_1qfloat市盈率(当年一季×4)
pe_2qfloat市盈率(当年中报×2)
pe_3qfloat市盈率(当年三季×4/3)
pe_ttm_cutfloat市盈率(TTM) 扣除非经常性损益
pe_lyr_cutfloat市盈率(最新年报LYR) 扣除非经常性损益
pe_mrq_cutfloat市盈率(最新报告期MRQ) 扣除非经常性损益
pe_1q_cutfloat市盈率(当年一季×4) 扣除非经常性损益
pe_2q_cutfloat市盈率(当年中报×2) 扣除非经常性损益
pe_3q_cutfloat市盈率(当年三季×4/3) 扣除非经常性损益
pb_lyrfloat市净率(最新年报LYR)
pb_lffloat市净率(最新公告)
pb_mrqfloat市净率(最新报告期MRQ)
pcf_ttm_operfloat市现率(经营现金流,TTM)
pcf_ttm_ncffloat市现率(现金净流量,TTM)
pcf_lyr_operfloat市现率(经营现金流,最新年报LYR)
pcf_lyr_ncffloat市现率(现金净流量,最新年报LYR)
ps_ttmfloat市销率(TTM)
ps_lyrfloat市销率(最新年报LYR)
ps_mrqfloat市销率(最新报告期MRQ)
ps_1qfloat市销率(当年一季×4)
ps_2qfloat市销率(当年中报×2)
ps_3qfloat市销率(当年三季×4/3)
peg_lyrfloat历史PEG值(当年年报增长率)
peg_1qfloat历史PEG值(当年1季*4较上年年报增长率)
peg_2qfloat历史PEG值(当年中报*2较上年年报增长率)
peg_3qfloat历史PEG值(当年3季*4/3较上年年报增长率)
dy_ttmfloat股息率(滚动 12 月TTM)%
dy_lfyfloat股息率(上一财年LFY)%

stk_get_daily_mktvalue - 查询市值指标每日数据

查询指定时间段股票的每日市值指标

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

函数原型:

stk_get_daily_mktvalue(symbol, fields, start_date=None, end_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolstr股票代码Y必填,只能填一个股票标的,使用时参考symbol(opens new window)
fieldsstr返回字段Y指定需要返回的财务字段, 如有多个字段,中间用英文逗号分隔
start_datestr开始时间NNone开始时间,时间类型为交易日期,%Y-%m-%d 格式, 默认None表示最新时间
end_datestr结束时间NNone结束时间,时间类型为交易日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
trade_datestr交易日期
fieldslist[float]指标字段数据指定返回 fields字段的数值. 支持的字段名请参考 市值指标

示例:

stk_get_daily_mktvalue(symbol='SHSE.600000', fields='tot_mv,tot_mv_csrc,a_mv',
                                  start_date=None, end_date=None, df=True)

输出:

        symbol  trade_date      tot_mv  tot_mv_csrc        a_mv
0  SHSE.600000  2023-06-26  2.1016e+11   2.1016e+11  2.1016e+11

注意:

1. 当start_date == end_date时,取离 end_date 最近交易日期的一条数据,

start_datend_date时,取指定时间段的数据,

当 start_date > end_date时,返回报错。

2. 如果fields参数的指标字段填写不正确,或填写空字段,会报错提示“填写的 fields 不正确”。fields不能超过20个字段

市值指标

字段名类型中文名称量纲说明
tot_mvfloat总市值
tot_mv_csrcfloat总市值(证监会算法)
a_mvfloatA股流通市值(含限售股)
a_mv_ex_ltdfloatA股流通市值(不含限售股)
b_mvfloatB股流通市值(含限售股,折人民币)
b_mv_ex_ltdfloatB股流通市值(不含限售股,折人民币)
evfloat企业价值(含货币资金)(EV1)
ev_ex_currfloat企业价值(剔除货币资金)(EV2)
ev_ebitdafloat企业倍数
equity_valuefloat股权价值

stk_get_daily_basic - 查询基础指标每日数据

查询指定时间段股票的每日基础指标

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

函数原型:

stk_get_daily_basic(symbol, fields, start_date=None, end_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolstr股票代码Y必填,只能填一个股票标的,使用时参考symbol(opens new window)
fieldsstr返回字段Y指定需要返回的财务字段, 如有多个字段,中间用英文逗号分隔
start_datestr开始时间NNone开始时间,时间类型为交易日期,%Y-%m-%d 格式, 默认None表示最新时间
end_datestr结束时间NNone结束时间,时间类型为交易日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
trade_datestr交易日期
fieldslist[float]指标字段数据指定返回 fields字段的数值. 支持的字段名请参考 基础指标

示例:

stk_get_daily_basic(symbol='SHSE.600000', fields='tclose,turnrate,ttl_shr,circ_shr',
                                  start_date=None, end_date=None, df=True)

输出:

        symbol  trade_date  turnrate    circ_shr     ttl_shr  tclose
0  SHSE.600000  2023-06-26    0.1159  2.9352e+10  2.9352e+10    7.16

注意:

1. 当start_date == end_date时,取离 end_date 最近交易日期的一条数据,

start_datend_date时,取指定时间段的数据,

当 start_date > end_date时,返回报错。

2. 如果fields参数的财务字段填写不正确,或填写空字段,会报错提示“填写的 fields 不正确”。fields不能超过20个字段

基础指标

字段名类型中文名称量纲说明
tclosefloat收盘价
turnratefloat当日换手率%
ttl_shrfloat总股本
circ_shrfloat流通股本
ttl_shr_unlfloat无限售条件股本
ttl_shr_ltdfloat有限售条件股本

stk_get_finance_prime_pt - 查询财务主要指标截面数据

查询指定日期截面上,股票所属上市公司的财务主要指标数据(point-in-time)

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

函数原型:

stk_get_finance_prime_pt(symbols, fields, rpt_type=None, data_type=None, date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list股票代码Y必填,可输入多个,使用时参考symbol (opens new window)采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002']
fieldsstr返回字段Y指定需要返回的财务主要指标, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型:
1-一季度报
6-中报
9-前三季报
12-年报
默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
datestr查询日期NNone查询时间,时间类型为发布日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 财务主要指标

示例:

stk_get_finance_prime_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='eps_basic,eps_dil', rpt_type=None, data_type=None, date='2023-06-19', df=True)

输出:

        symbol    pub_date    rpt_date  rpt_type  data_type  eps_dil  eps_basic
0  SZSE.000001  2023-04-25  2023-03-31         1        101   0.6500     0.6500
1  SZSE.300002  2023-04-27  2023-03-31         1        101   0.0914     0.0914

注意:

1. 为避免未来数据问题,指定查询日期date后,返回距离此日期最近发布的一条数据。 若多个报告期报表的最新发布日期相同,返回报告日期rpt_date距离查询日期date最近的一个报告期的报表数据。

2. 如果fields参数的财务字段填写不正确,或填写空字段"",会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_finance_deriv_pt - 查询财务衍生指标截面数据

查询指定日期截面上,股票所属上市公司的财务衍生指标数据(point-in-time)

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

函数原型:

stk_get_finance_prime_pt(symbols, fields, rpt_type=None, data_type=None, date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list股票代码Y必填,可输入多个,使用时参考symbol (opens new window)采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002']
fieldsstr返回字段Y指定需要返回的财务衍生指标, 如有多个字段,中间用英文逗号分隔
rpt_typeint报表类型NNone报告期查询可指定以下报表类型:
1-一季度报
6-中报
9-前三季报
12-年报
默认None为不限
data_typeint数据类型NNone在发布原始财务报告以后,上市公司可能会对数据进行修正。 101-合并原始
102-合并调整 201-母公司原始
202-母公司调整 默认None返回当期合并调整,如果没有调整返回合并原始
datestr查询日期NNone查询时间,时间类型为发布日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
pub_datestr发布日期距查询日期最近的发布日期
若数据类型选择合并原始(data_type=101),则返回原始发布的发布日期
若数据类型选择合并调整(data_type=102),则返回调整后最新发布日期
若数据类型选择母公司原始(data_type=201),则返回母公司原始发布的发布日期
若数据类型选择母公司调整(data_type=202),则返回母公司调整后最新发布日期
rpt_datestr报告日期报告截止日期,财报统计的最后一天,在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_typeint报表类型返回数据的报表类型:1-一季度报, 6-中报, 9-前三季报, 12-年报
data_typeint数据类型返回数据的数据类型:101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fieldslist[float]财务字段数据指定查询 fields字段的数值. 支持的字段名请参考 财务衍生指标指标

示例:

stk_get_finance_deriv_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='eps_basic,eps_dil2',
                                   rpt_type=None, data_type=None, date='2023-06-19', df=True)

输出:

        symbol    pub_date    rpt_date  ...  data_type  eps_basic  eps_dil2
0  SZSE.000001  2023-04-25  2023-03-31  ...        102     0.6500    0.6500
1  SZSE.300002  2023-04-27  2023-03-31  ...        102     0.0914    0.0914

注意:

1. 为避免未来数据问题,指定查询日期date后,返回距离此日期最近发布的一条数据。 若多个报告期报表的最新发布日期相同,返回报告日期rpt_date距离查询日期date最近的一个报告期的报表数据。

2. 如果fields参数的财务字段填写不正确,或填写空字段"",会报错提示“填写的 fields 不正确”。fields不能超过20个字段


stk_get_daily_valuation_pt - 查询估值指标单日截面数据

查询指定日期截面上,股票的单日估值指标(point-in-time)

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

函数原型:

stk_get_daily_valuation_pt(symbols, fields, trade_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list股票代码Y必填,可输入多个,使用时参考symbol (opens new window)采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002']
fieldsstr返回字段Y指定需要返回的交易衍生指标, 如有多个字段,中间用英文逗号分隔
trade_datestr查询日期NNone查询时间,时间类型为交易日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
trade_datestr交易日期
fieldslist[float]指标字段数据指定查询 fields字段的数值. 支持的字段名请参考 估值指标

示例:

stk_get_daily_valuation_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='pe_ttm,pe_lyr,pe_mrq',
                               trade_date=None, df=True)

输出:

        symbol  trade_date   pe_ttm   pe_mrq   pe_lyr
0  SZSE.000001  2023-06-26   4.5900   3.7145   4.7666
1  SZSE.300002  2023-06-26  39.3144  36.2480  47.6621

注意:

1. 如果fields参数的财务字段填写不正确,或填写空字段"",会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_daily_mktvalue_pt - 查询市值指标单日截面数据

查询指定日期截面上,股票的单日市值指标(point-in-time)

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

函数原型:

stk_get_daily_mktvalue_pt(symbols, fields, trade_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list股票代码Y必填,可输入多个,使用时参考symbol (opens new window)采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002']
fieldsstr返回字段Y指定需要返回的交易衍生指标, 如有多个字段,中间用英文逗号分隔
trade_datestr查询日期NNone查询时间,时间类型为交易日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
trade_datestr交易日期
fieldslist[float]指标字段数据指定查询 fields字段的数值. 支持的字段名请参考 市值指标

示例:

stk_get_daily_mktvalue_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='tot_mv,tot_mv_csrc,a_mv',
                               trade_date=None, df=True)

输出:

        symbol  trade_date        a_mv      tot_mv  tot_mv_csrc
0  SZSE.000001  2023-06-26  2.1696e+11  2.1696e+11   2.1696e+11
1  SZSE.300002  2023-06-26  2.5828e+10  2.5828e+10   2.5828e+10

注意:

1. 如果fields参数的财务字段填写不正确,或填写空字段"",会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_daily_basic_pt - 查询基础指标单日截面数据

查询指定日期截面上,股票的单日市值指标(point-in-time)

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

函数原型:

stk_get_daily_basic_pt(symbols, fields, trade_date=None, df=False)

参数:

参数名类型中文名称必填默认值参数用法说明
symbolsstr or list股票代码Y必填,可输入多个,使用时参考symbol (opens new window)采用 str 格式时,多个标的代码必须用英文逗号分割,如:'SHSE.600008,SZSE.000002' 采用 list 格式时,多个标的代码示例:['SHSE.600008', 'SZSE.000002']
fieldsstr返回字段Y指定需要返回的交易衍生指标, 如有多个字段,中间用英文逗号分隔
trade_datestr查询日期NNone查询时间,时间类型为交易日期,%Y-%m-%d 格式, 默认None表示最新时间
dfbool返回格式NFalse是否返回 dataframe 格式 , 默认False返回 list[dict]

返回值:

字段名类型中文名称说明
symbolstr股票代码
trade_datestr交易日期
fieldslist[float]指标字段数据指定查询 fields字段的数值. 支持的字段名请参考 基础指标

示例:

stk_get_daily_basic_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='tclose,turnrate,ttl_shr',
                                  trade_date=None, df=True)

输出:

        symbol  trade_date  turnrate  tclose     ttl_shr
0  SZSE.000001  2023-06-27    0.2379   11.28  1.9406e+10
1  SZSE.300002  2023-06-27    7.3596   13.44  1.9611e+09

注意:

1. 如果fields参数的财务字段填写不正确,或填写空字段"",会报错提示“填写的 fields 不正确”。fields不能超过20个字段



5.8期货基础数据函数(免费)

python 股票与指数数据 API 包含在 gm3.0.148 版本及以上版本


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

查询指定时间段连续合约在每个交易日上对应的真实合约

函数原型:

fut_get_continuous_contracts(csymbol, start_date="", end_date="")

参数:

参数名类型中文名称必填默认值参数用法说明
csymbolstr连续合约代码Y必填,使用时参考查询代码 (opens new window),只能输入一个 支持主力合约、次主力、前 5 个月份连续和加权指数合约代码,如: 1000 股指期货主力连续合约:CFFEX.IM, 1000 股指期货次主力连续合约:CFFEX.IM22, 1000 股指期货当月连续合约:CFFEX.IM00, 1000 股指期货下月连续合约:CFFEX.IM01, 1000 股指期货下季连续合约:CFFEX.IM02, 1000 股指期货隔季连续合约:CFFEX.IM03, 1000 股指期货加权指数合约:CFFEX.IM99
start_datestr开始时间N""开始时间日期,%Y-%m-%d 格式,默认""表示最新时间
end_datestr结束时间N""结束时间日期,%Y-%m-%d 格式,默认""表示最新时间

返回值:list[dict]

字段名类型中文名称说明
symbolstr标的代码exchange.sec_id
trade_datestr交易日期具体合约对应的交易日期

示例:

fut_get_continuous_contracts(csymbol='SHFE.NI', start_date="2022-09-01", end_date="2022-09-15")

输出:

[{'symbol': 'SHFE.ni2210', 'trade_date': '2022-09-01'}, {'symbol': 'SHFE.ni2210', 'trade_date': '2022-09-02'}, {'symbol': 'SHFE.ni2210', 'trade_date': '2022-09-05'}, {'symbol': 'SHFE.ni2210', 'trade_date': '2022-09-06'}, {'symbol': 'SHFE.ni2210', 'trade_date': '2022-09-07'}, {'symbol': 'SHFE.ni2210', 'trade_date': '2022-09-08'}, {'symbol': 'SHFE.ni2210', 'trade_date': '2022-09-09'}, {'symbol': 'SHFE.ni2210', 'trade_date': '2022-09-13'}, {'symbol': 'SHFE.ni2210', 'trade_date': '2022-09-14'}, {'symbol': 'SHFE.ni2210', 'trade_date': '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时返回报错。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/772644.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

C# 动态字典(可以随机实时增删访问,保证先入先出的字典)

如果你有以下需求: 1. 需要对Dictionary进行遍历的同时移除或者添加元素 2. 需要按顺序遍历Dictionary并且保证先入先出 3. 需要即时的获取字典内的元素数量,即时增删 如果你觉得好,请给我的框架点一个免费的star,球球啦 Yueh0607…

如何将视频转换为AVI格式?3个方法轻松转换!

在数字化时代,视频成为了人们记录和分享重要时刻的主要方式之一。然而,不同设备和平台对视频格式的要求千差万别,有时您可能需要将视频转换为特定格式以便于播放或编辑。在本文中,我们将重点介绍将视频转换为AVI(Audio…

python实现小波降噪

文章目录 小波分解小波系数小波降噪阈值确定的一些小知识点python 实现小波去噪小波分解 上图为对信号进行3层小波分解,其中,Approximation 为近似小波系数(信号的低频成分),Detail为细节小波系数(信号的高频成分),分解后得到四个小波系数分别为A3,D3,D2,D1。 小波系数 小…

易查分怎么上传成绩?

当使用易查分制作查询系统时,许多老师可能对于如何上传成绩感到困惑。有时候,导入成绩到易查分系统后,信息可能无法完全显示,而且也很难找到错误的原因。因此,今天我将与老师们分享一下易查分上传成绩的方法。这个技巧…

【软件测试】Git实战-分支的新建和合并(超细整理)

目录:导读 前言一、Python编程入门到精通二、接口自动化项目实战三、Web自动化项目实战四、App自动化项目实战五、一线大厂简历六、测试开发DevOps体系七、常用自动化测试工具八、JMeter性能测试九、总结(尾部小惊喜) 前言 新建分支 首先&a…

ERROR 2003 (HY000): Can‘t connect to MySQL server on ‘localhost:3306‘ (10061)

用压缩包安装MySQL,执行mysql -u root -p命令,报错: ERROR 2003 (HY000): Cant connect to MySQL server on localhost:3306 (10061) 这是因为MySQL服务器没有启动,我打开任务管理器看了一下,确实没有启动,…

携手航天·追求卓越|诚邀优秀企业加入航天采购平台供应商库

近日,第九届中国(国际)商业航天高峰论坛在武汉开幕,中国载人航天工程副总设计师张海联在《我国载人月球探测发展总体考虑》主旨报告中介绍了中国载人登月的初步方案。为此,我国科研人员正在研制长征十号运载火箭、新一…

科技云报道:大模型“百团大战”,容联云的机会在哪里?

科技云报道原创。 “大模型的迭代是一场‘暴力’填数据、拔规模而造就的‘美学盛宴’”,中金公司研究团队在“AI浪潮之巅”系列报告中如是说。 在大模型发展初期,大模型或许还称得上是“大厂的游戏”,但半年之后的今天,国内10亿…

【Linux】日志与守护进程

目录 一、预备知识 二、打印日志 三、守护进程 1、前置知识 2、守护进程 一、预备知识 日志是有等级的,表明该条日志的重要程度,一般分为以下几个级别: #define DEBUG 0 //调试信息 #define INFO 1 //正常运行 #define WARNING 2 //报…

【Python爬虫+可视化案例】采集电商网站商品数据信息,并可视化分析

爬虫可视化案例 :苏宁易购 案例所需要掌握的知识点: selenium的使用html标签数据解析方法 需要准备的环境: python 3.8pycharm 2022专业版selenium python里面的第三方库 可以用来操作浏览器 爬虫代码展示 所需模块 【代码领取 请看文末…

017 - STM32学习笔记 - SPI读写FLASH(二)-flash数据写入与读取

016 - STM32学习笔记 - SPI访问Flash(二) 上节内容学习了通过SPI读取FLASH的JEDEC_ID,在flash资料的指令表中,还看到有很多指令可以使用,这节继续学习使用其他指令,程序模板采用上节的模板。 为了方便起…

为何异地销号这么难?这些注意事项要熟记!

最近有不少小伙伴私信小编,他们在网上办理的大流量手机号卡,用了一段时间之后想换其他的卡,所以想注销当前用的卡,但是注销的时候确实屡屡碰壁,程序还比较繁琐,有的甚至申请注销了几个月还注销不掉&#xf…

在Microsoft Excel中如何合并多个表格

如果你问那些处理数据的人,你会知道合并 Excel 文件或合并工作簿是他们日常工作的一部分。 Power Query 是将多个 Excel 文件中的数据合并或组合到一个文件中的最佳方式。你需要将所有文件存储在一个文件夹中,然后使用该文件夹将这些文件中的数据加载到高级查询编辑器中。它…

了解kubernetes部署:namespace和Node设置

节点及namespace的设置 kubectlcreate-f/opt/kubernetes/namespaces.yaml 通过此命令我们创建了如下namespace: ns-elasticsearch:elasticsearch相关  ns-rabbitmq:rabbitmq相关  ns-javashop:javashop应用相关 接下来我们要根据具体情况安排各个节点的部署规划…

CSS科技感四角边框

实现效果:使用before和after就可以实现,代码量不多,长度颜色都可以自己调整 <!DOCTYPE html> <html lang="en"> <head><meta charset="UTF-8"><title>Title</title><style>*{margin:0;padding:0;}html,body{…

OBS录制双屏

1.设置视频分辨率&#xff0c;假如要录制两个1920x1080分辨率的屏幕&#xff0c;那就把需要录制的分辨率改为3840x10802. 添加显示器采集 3.点击开始录制 4.最终效果

python_PyQt5开发股票指定区间K线操作工具_裸K

目录 写在前面&#xff1a; 工具使用演示&#xff1a; 代码&#xff1a; 导入包 横坐标控件、K线控件、带查询下拉列表控件 K线图控件 主界面代码 执行代码 写在前面&#xff1a; 继前面文章提到筛出低位股票后&#xff0c;想逐一查看这些股票今年的K线走势&#xff…

香港视频直播服务器需要多大的带宽(带宽计算方式)

​  香港视频直播服务器需要多大的带宽(怎么计算带宽大小)。目前短视频行业兴起&#xff0c;有许多人也想利用香港服务器搭建一个直播平台&#xff0c;但无奈不知道怎么选择资源大小&#xff0c;或者说什么样的配置能够满足直播的需求。关于直播的带宽大小和流量消耗的计算同…

记录一次抓取WiFi驱动日志以及sniffer日志

起因 路由器桥接一个WiFi&#xff0c;然后设备连接这个路由器的WiFi&#xff0c;发现网络不可用&#xff0c;而手机或者电脑连接就没问题&#xff0c;与供应商沟通问题&#xff0c;需要抓取日志&#xff0c;记录一下 抓取WLAN DRIVER WLAN FW3日志 进入开发者模式打开启动WL…

hive常用方法

日期类 Date_sub 日期进行加减 &#xff0c;正的减&#xff0c;负的加 select current_date -- 当前日期,date_sub(current_date,1) -- 前一日,date_sub(current_date,-1) -- 后一日 from edw.test;字符类 split 该函数是分割字符串 &#xff0c;按照…