Nuggets Quantification—Python SDK Documentation—5. API Introduction (2)

 

Python SDK Documentation

5. API introduction

5.6 Common data functions (free)

Python general data API is included in gm3.0.148 and above versions, no need to introduce new libraries

get_symbol_infos - Query the basic information of the target

Get the basic information of the specified (range) transaction target, regardless of time.

This function is the Nuggets public version (experimental version/professional version/institutional version) function, and the brokerage version is subject to the upgrade prompt

Function prototype:

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

parameter:

parameter name	type	Chinese name	required	Defaults	Parameter usage instructions
sec_type1	int	Types of Securities	Y	none	Specify a security category, only one can be entered. Security category sec_type1 List 1010: Stocks, 1020: Funds, 1030: Bonds, 1040: Futures, 1050: Options, 1060: Index.
sec_type2	int	Securities Varieties	N	None	Specify a security subcategory, only one can be entered. The default Nonemeans no subcategory, that is, all subcategories under the general category of securities. See the sec_type2 list for security subcategories - stock 101001: A shares, 101002: B shares, 101003: depository Voucher - Fund 102001: ETF, 102002: LOF, 102005: FOF - Bond 103001: Convertible Bond, 103008: Repurchase - Futures 104001: Stock Index Futures, 104003: Commodity Futures, 104006: Treasury Futures - Options 105001: Stock Options, 105002 : Index Option, 105003: Commodity Option - Index 106001: Stock Index, 106002: Fund Index, 106003: Bond Index, 106004: Futures Index
exchanges	str or list	exchange code	N	None	Enter the exchange code, you can enter more than one. When the str format is used, multiple exchange codes must be separated by English commas. For example: 'SHSE,SZSE' when the list format is used, multiple exchange codes example: ['SHSE', 'SZSE'] the default Noneindicates all exchanges. List of exchange codes SHSE: Shanghai Stock Exchange, SZSE: Shenzhen Stock Exchange, CFFEX: China Financial Services Exchange, SHFE: Shanghai Futures Exchange, DCE: DCE, CZCE: Zhengzhou Exchange, INE: Energy Center
symbols	str or list	target code	N	None	Enter the target code, you can enter more than one. When str format is used, multiple target codes must be separated by English commas. For example: 'SHSE.600008,SZSE.000002' when list format is used, multiple target code examples: ['SHSE.600008', 'SZSE.000002'] the default Noneindicates all targets.
df	bool	return format	N	False	Whether to return the dataframe format, the default is Falseto return the dictionary format, and  list[dict]the key value of the dict of each item in the list is the fields field.

return value:

field name	type	Chinese name	illustrate	stock field	fund field	bond field	futures field	option field	index field
symbol	str	target code	exchange.sec_id	√	√	√	√	√	√
sec_type1	int	Types of Securities	1010: stocks, 1020: funds, 1030: bonds, 1040: futures, 1050: options, 1060: indices	√	√	√	√	√	√
sec_type2	int	Securities Varieties	- Stock 101001: A shares, 101002: B shares, 101003: depositary receipts - Funds 102001: ETF, 102002: LOF, 102005: FOF - Bonds 103001: convertible bonds, 103003: treasury bonds, 103006: corporate bonds, 103008: returns Purchase - futures 104001: stock index futures, 104003: commodity futures, 104006: treasury bond futures - options 105001: stock options, 105002: index options, 105003: commodity options - index 106001: stock index, 106002: fund index, 106003: bond index, 106004: futures index	√	√	√	√	√	√
board	int	plate	A shares 10100101: main board A shares 10100102: GEM 10100103: Science and Technology Innovation Board 10100104: Beijing Stock Exchange stock ETF 10200101: stock ETF 10200102: bond ETF 10200103: commodity ETF 10200104: cross-border ETF 10200105: currency ETF Convertible bond 10300101: ordinary Convertible bonds 10300102: Exchangeable bonds 10300103: Separable bonds 10300104: Directional convertible bonds	√	√	√	none	none	none
exchange	str	exchange code	SHSE: Shanghai Stock Exchange, SZSE: Shenzhen Stock Exchange, CFFEX: China Financial Services Exchange, SHFE: Shanghai Futures Exchange, DCE: Dashang Exchange, CZCE: Zhengzhou Exchange, INE: Shanghai International Energy Exchange	√	√	√	√	√	√
sec_id	str	Exchange underlying code	Stock codes for stocks, funds, bonds, and indices; contract codes for futures and options	√	√	√	√	√	√
sec_name	str	The name of the underlying transaction	Securities names of stocks, funds, bonds, and indices; contract names of futures and options	√	√	√	√	√	√
sec_abbr	str	Abbreviation of the subject of the exchange	Pinyin or English abbreviation	√	√	√	√	√	√
price_tick	float	Minimum unit of change	The minimum change unit of the transaction target price	√	√	√	√	√	√
trade_n	int	trading system	0 means T+0, 1 means T+1, 2 means T+2	√	√	√	√	√	√
listed_date	datetime.datetime	listing date	Listing date of securities/indices, listing date of derivatives contracts	√	√	√	√	√	√
delisted_date	datetime.datetime	delisting date	The delisting date of stocks/funds, the expiration date (last trading day) of futures/options, and the redemption registration date of convertible bonds	√	√	√	√	√	√
underlying_symbol	str	标的资产	期货/期权的合约标的物 symbol，可转债的正股标的 symbol	无	无	√	√	√	无
option_type	str	行权方式	期权行权方式，仅期权适用，E:欧式，A:美式	无	无	无	无	√	无
option_margin_ratio1	float	期权保证金计算系数 1	计算期权单位保证金的第 1 个系数，仅期权适用	无	无	无	无	√	无
option_margin_ratio2	float	期权保证金计算系数 2	计算期权单位保证金的第 2 个系数，仅期权适用	无	无	无	无	√	无
call_or_put	str	合约类型	期权合约类型，仅期权适用，C:Call(认购或看涨)， P:Put(认沽或看跌)	无	无	无	无	√	无
conversion_start_date	datetime.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_type1	sec_type2	exchanges	symbols
查询指定股票	1010	None	None	'SHSE.600008,SZSE.000002'
查询 A 股股票	1010	101001	None	None
查询深交所股票	1010	None	'SZSE'	None
查询 ETF	1020	102001	None	None
查询上交所 LOF	1020	102002	'SHSE'	None
查询可转债	1030	103001	None	None
查询深交所可转债	1030	103001	'SZSE'	None
查询股指期货	1040	104001	None	None
查询商品期货	1040	104003	None	None
查询郑商所和大商所期货	1040	None	'CZCE,DCE'	None
查询股票期权	1050	105001	None	None
查询上交所股票期权	1050	105001	'SHSE'	None
查询指数期权	1050	105002	None	None
查询商品期权	1050	105003	None	None
查询上期所商品期权	105003	None	'SHFE'	None
查询股票指数	1060	106001	None	None

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_type1	int	证券品种大类	Y	无	指定一种证券大类，只能输入一个. 证券大类 sec_type1 清单 1010: 股票， 1020: 基金， 1030: 债券 ， 1040: 期货， 1050: 期权， 1060: 指数.
sec_type2	int	证券品种细类	N	None	指定一种证券细类，只能输入一个. 默认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:期货指数
exchanges	str or list	交易所代码	N	None	输入交易所代码，可输入多个. 采用 str 格式时，多个交易所代码必须用英文逗号分割，如：'SHSE,SZSE' 采用 list 格式时，多个交易所代码示例：['SHSE', 'SZSE'] 默认None表示所有交易所. 交易所代码清单 SHSE:上海证券交易所，SZSE:深圳证券交易所 ， CFFEX:中金所，SHFE:上期所，DCE:大商所， CZCE:郑商所，INE:能源中心
symbols	str or list	标的代码	N	None	输入标的代码，可输入多个. 采用 str 格式时，多个标的代码必须用英文逗号分割，如：'SHSE.600008,SZSE.000002' 采用 list 格式时，多个标的代码示例：['SHSE.600008', 'SZSE.000002'] 默认None表示所有标的.
skip_suspended	bool	跳过停牌	N	True	是否跳过全天停牌，默认True跳过
skip_st	bool	跳过 ST	N	True	是否跳过包含 ST 的股票：ST, *ST, SST, S*ST, 默认True跳过
trade_date	str	交易日期	N	None	交易日期，%Y-%m-%d 格式，默认None取最新截面(包含退市标的)
df	bool	返回格式	N	False	是否返回 dataframe 格式，默认False返回字典格式，返回 list[dict]， 列表每项的 dict 的 key 值为 fields 字段.

返回值：

字段名	类型	中文名称	说明	股票字段	基金字段	债券字段	期货字段	期权字段	指数字段
trade_date	datetime.datetime	交易日期	最新交易日的日期	√	√	√	√	√	√
symbol	str	标的代码	exchange.sec_id	√	√	√	√	√	√
sec_type1	int	证券品种大类	1010: 股票，1020: 基金， 1030: 债券，1040: 期货， 1050: 期权，1060: 指数	√	√	√	√	√	√
sec_type2	int	证券品种细类	- 股票 101001:A 股，101002:B 股，101003:存托凭证 - 基金 102001:ETF，102002:LOF，102005:FOF - 债券 103001:可转债，103008:回购 - 期货 104001:股指期货，104003:商品期货，104006:国债期货 - 期权 105001:股票期权，105002:指数期权，105003:商品期权 - 指数 106001:股票指数，106002:基金指数，106003:债券指数，106004:期货指数	√	√	√	√	√	√
board	int	板块	A 股 10100101:主板 A 股 10100102:创业板 10100103:科创版 10100104:北交所股票 ETF 10200101:股票 ETF 10200102:债券 ETF 10200103:商品 ETF 10200104:跨境 ETF 10200105:货币 ETF 可转债 10300101:普通可转债 10300102:可交换债券 10300103:可分离式债券 10300104:定向可转债	√	√	√	无	无	无
exchange	str	交易所代码	SHSE:上海证券交易所， SZSE:深圳证券交易所， CFFEX:中金所， SHFE:上期所， DCE:大商所， CZCE:郑商所， INE:上海国际能源交易中心	√	√	√	√	√	√
sec_id	str	交易所标的代码	股票,基金,债券,指数的证券代码; 期货,期权的合约代码	√	√	√	√	√	√
sec_name	str	交易所标的名称	股票,基金,债券,指数的证券名称; 期货,期权的合约名称	√	√	√	√	√	√
sec_abbr	str	交易所标的简称	拼音或英文简称	√	√	√	√	√	√
price_tick	float	最小变动单位	交易标的价格最小变动单位	√	√	√	√	√	√
trade_n	int	交易制度	0 表示 T+0，1 表示 T+1，2 表示 T+2	√	√	√	√	√	√
listed_date	datetime.datetime	上市日期	证券/指数的上市日、衍生品合约的挂牌日	√	√	√	√	√	√
delisted_date	datetime.datetime	退市日期	股票/基金的退市日， 期货/期权的到期日(最后交易日)， 可转债的赎回登记日	√	√	√	√	√	√
underlying_symbol	str	标的资产	期货/期权的合约标的物 symbol，可转债的正股标的 symbol	无	无	√	√	√	无
option_type	str	行权方式	期权行权方式，仅期权适用，E:欧式，A:美式	无	无	无	无	√	无
option_margin_ratio1	float	期权保证金计算系数 1	计算期权单位保证金的第 1 个系数，仅期权适用	无	无	无	无	√	无
option_margin_ratio2	float	期权保证金计算系数 2	计算期权单位保证金的第 2 个系数，仅期权适用	无	无	无	无	√	无
call_or_put	str	合约类型	期权合约类型，仅期权适用，C:Call(认购或看涨)， P:Put(认沽或看跌)	无	无	无	无	√	无
conversion_start_date	datetime.datetime	可转债开始转股日期	可转债初始转股价的执行日期，仅可转债适用	无	无	√	无	无	无
is_adjusted	bool	合约调整	是否调整合约，True:是，False:否（调整后会产生新的新的合约名称、新的行权价格、新的合约乘数）	无	无	无	无	√	无
is_suspended	bool	是否停牌	是否停牌，True:是，False:否	√	√	√	无	无	无
is_st	bool	是否 ST	是否 ST，True: 是 ST 类（含ST, *ST, SST, S*ST）, False: 否	√	无	无	无	无	无
position	int	持仓量	当日累计持仓量，当日盘后更新	无	无	无	√	√	无
settle_price	float	结算价	当日结算价，当日盘后更新	无	无	无	√	√	无
pre_settle	float	昨结价	昨日结算价	无	无	无	√	√	无
pre_close	float	昨收价	昨日收盘价	√	√	√	√	√	√
upper_limit	float	涨停价	当日涨停价（首次公开发行上市的股票上市前 5 日无涨跌停价，返回0）	√	√	√	√	√	无
lower_limit	float	跌停价	当日跌停价（首次公开发行上市的股票上市前 5 日无涨跌停价，返回0）	√	√	√	√	√	无
turn_rate	float	换手率	当日换手率(%)，当日盘后更新	√	√	无	无	无	√
adj_factor	float	复权因子	当日累计后复权因子	√	√	无	无	无	无
margin_ratio	float	保证金比例	期货最新保证金比例（交易所标准的最新期货保证金）	无	无	无	√	无	无
conversion_price	float	转股价	可转债最新转股价（转股价变动后的最新转股价）	无	无	√	无	无	无
exercise_price	float	行权价	期权最新行权价（期权合约调整后的最新行权价）	无	无	无	无	√	无
multiplier	int	合约乘数	期货和期权合约最新合约乘数（期权合约调整后的最新合约乘数）	无	无	无	√	√	无

示例：

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)

参数：

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

返回值：

字段名	类型	中文名称	说明	股票字段	基金字段	债券字段	期货字段	期权字段	指数字段
trade_date	datetime.datetime	交易日期	最新交易日的日期	√	√	√	√	√	√
symbol	str	标的代码	exchange.sec_id	√	√	√	√	√	√
sec_type1	int	证券品种大类	1010: 股票，1020: 基金， 1030: 债券，1040: 期货， 1050: 期权，1060: 指数	√	√	√	√	√	√
sec_type2	int	证券品种细类	- 股票 101001:A 股，101002:B 股，101003:存托凭证 - 基金 102001:ETF，102002:LOF，102005:FOF - 债券 103001:可转债，103008:回购 - 期货 104001:股指期货，104003:商品期货，104006:国债期货 - 期权 105001:股票期权，105002:指数期权，105003:商品期权 - 指数 106001:股票指数，106002:基金指数，106003:债券指数，106004:期货指数	√	√	√	√	√	√
board	int	板块	A 股 10100101:主板 A 股 10100102:创业板 10100103:科创版 10100104:北交所股票 ETF 10200101:股票 ETF 10200102:债券 ETF 10200103:商品 ETF 10200104:跨境 ETF 10200105:货币 ETF 可转债 10300101:普通可转债 10300102:可交换债券 10300103:可分离式债券 10300104:定向可转债	√	√	√	无	无	无
exchange	str	交易所代码	SHSE:上海证券交易所， SZSE:深圳证券交易所， CFFEX:中金所， SHFE:上期所， DCE:大商所， CZCE:郑商所， INE:上海国际能源交易中心	√	√	√	√	√	√
sec_id	str	交易所标的代码	股票,基金,债券,指数的证券代码; 期货,期权的合约代码	√	√	√	√	√	√
sec_name	str	交易所标的名称	股票,基金,债券,指数的证券名称; 期货,期权的合约名称	√	√	√	√	√	√
sec_abbr	str	交易所标的简称	拼音或英文简称	√	√	√	√	√	√
price_tick	float	最小变动单位	交易标的价格最小变动单位	√	√	√	√	√	√
trade_n	int	交易制度	0 表示 T+0，1 表示 T+1，2 表示 T+2	√	√	√	√	√	√
listed_date	datetime.datetime	上市日期	证券/指数的上市日、衍生品合约的挂牌日	√	√	√	√	√	√
delisted_date	datetime.datetime	退市日期	股票/基金的退市日， 期货/期权的到期日(最后交易日)， 可转债的赎回登记日	√	√	√	√	√	√
underlying_symbol	str	标的资产	期货/期权的合约标的物 symbol，可转债的正股标的 symbol	无	无	√	√	√	无
option_type	str	行权方式	期权行权方式，仅期权适用，E:欧式，A:美式	无	无	无	无	√	无
option_margin_ratio1	float	期权保证金计算系数 1	计算期权单位保证金的第 1 个系数，仅期权适用	无	无	无	无	√	无
option_margin_ratio2	float	期权保证金计算系数 2	计算期权单位保证金的第 2 个系数，仅期权适用	无	无	无	无	√	无
call_or_put	str	合约类型	期权合约类型，仅期权适用，C:Call(认购或看涨)， P:Put(认沽或看跌)	无	无	无	无	√	无
conversion_start_date	datetime.datetime	可转债开始转股日期	可转债初始转股价的执行日期，仅可转债适用	无	无	√	无	无	无
is_adjusted	bool	合约调整	是否调整合约，True:是，False:否（调整后会产生新的新的合约名称、新的行权价格、新的合约乘数）	无	无	无	无	√	无
is_suspended	bool	是否停牌	是否停牌，True:是，False:否	√	√	√	无	无	无
is_st	bool	是否 ST	是否 ST，True: 是 ST 类（含ST, *ST, SST, S*ST）, False: 否	√	无	无	无	无	无
position	int	持仓量	当日累计持仓量，当日盘后更新	无	无	无	√	√	无
settle_price	float	结算价	当日结算价，当日盘后更新	无	无	无	√	√	无
pre_settle	float	昨结价	昨日结算价	无	无	无	√	√	无
pre_close	float	昨收价	昨日收盘价	√	√	√	√	√	√
upper_limit	float	涨停价	当日涨停价（首次公开发行上市的股票上市前 5 日无涨跌停价，返回0）	√	√	√	√	√	无
lower_limit	float	跌停价	当日跌停价（首次公开发行上市的股票上市前 5 日无涨跌停价，返回0）	√	√	√	√	√	无
turn_rate	float	换手率	当日换手率(%)，当日盘后更新	√	√	无	无	无	√
adj_factor	float	复权因子	当日累计后复权因子	√	√	无	无	无	无
margin_ratio	float	保证金比例	期货在指定交易日的交易所保证金比例	无	无	无	√	无	无
conversion_price	float	转股价	可转债在指定交易日的转股价	无	无	√	无	无	无
exercise_price	float	行权价	期权在指定交易日的行权价	无	无	无	无	√	无
multiplier	int	合约乘数	期货/期权合约在指定交易日的合约乘数	无	无	无	√	√	无

示例：

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_date和end_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)

参数：

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

返回值:dataframe

字段名	类型	中文名称	说明
date	str	自然日期	查询年份的自然日日期
trade_date	str	交易日期	查询年份的交易日日期，如果所在自然日不是交易日，交易日期为空字符串''
next_trade_date	str	下一交易日	交易日对应的下一交易日
pre_trade_date	str	上一交易日	交易日对应的上一交易日

示例：

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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	标的代码	exchange.sec_id
exchange	str	交易所代码	SHSE:上海证券交易所，SZSE:深圳证券交易所，CFFEX:中金所， SHFE:上期所，DCE:大商所，CZCE:郑商所，INE:上海国际能源交易中心
time_trading	list[dict]	连续竞价时段	HH:MM 格式，按时间顺序排列，如品种存在夜盘，夜盘时段排最前。 如[{'start': '09:30'，'end': '11:30'}， {'start': '13:00'， 'end': '14:57'}]，
time_callaution	list[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)

参数：

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

返回值：

字段名	类型	中文名称	说明
date	str	日期	[开始日期,结束日期]内的自然日期
symbol	str	合约代码	exchange.sec_id
days_to_expire	int	到期剩余天数	合约在指定交易时间至合约到期日的剩余天数. 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_date和end_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)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
index	str	指数代码	Y	无	必填，只能输入一个指数，如：'SHSE.000905'
trade_date	str	交易日期	N	None	交易日期，%Y-%m-%d 格式， 默认None为最新交易日

返回值：dataframe

字段名	类型	中文名称	说明
index	str	指数代码	查询成分股的指数代码
symbol	str	成分股代码	exchange.sec_id
weight	float	成分股权重	成分股 symbol 对应的指数权重
trade_date	str	交易日期	最新交易日，%Y-%m-%d 格式
market_value_total	float	总市值	单位：亿元
market_value_circ	float	流通市值	单位：亿元

示例：

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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

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

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

资产负债表

字段名	类型	中文名称	量纲	说明
流动资产(资产)
cash_bal_cb	float	现金及存放中央银行款项	元	银行
dpst_ob	float	存放同业款项	元	银行
mny_cptl	float	货币资金	元
cust_cred_dpst	float	客户信用资金存款	元	证券
cust_dpst	float	客户资金存款	元	证券
pm	float	贵金属	元	银行
bal_clr	float	结算备付金	元
cust_rsv	float	客户备付金	元	证券
ln_to_ob	float	拆出资金	元
fair_val_fin_ast	float	以公允价值计量且其变动计入当期损益的金融资产	元
ppay	float	预付款项	元
fin_out	float	融出资金	元
trd_fin_ast	float	交易性金融资产	元
deriv_fin_ast	float	衍生金融资产	元
note_acct_rcv	float	应收票据及应收账款	元
note_rcv	float	应收票据	元
acct_rcv	float	应收账款	元
acct_rcv_fin	float	应收款项融资	元
int_rcv	float	应收利息	元
dvd_rcv	float	应收股利	元
oth_rcv	float	其他应收款	元
in_prem_rcv	float	应收保费	元
rin_acct_rcv	float	应收分保账款	元
rin_rsv_rcv	float	应收分保合同准备金	元	保险
rcv_un_prem_rin_rsv	float	应收分保未到期责任准备金	元
rcv_clm_rin_rsv	float	应收分保未决赔偿准备金	元	保险
rcv_li_rin_rsv	float	应收分保寿险责任准备金	元	保险
rcv_lt_hi_rin_rsv	float	应收分保长期健康险责任准备金	元	保险
ph_plge_ln	float	保户质押贷款	元	保险
ttl_oth_rcv	float	其他应收款合计	元
rfd_dpst	float	存出保证金	元	证券、保险
term_dpst	float	定期存款	元	保险
pur_resell_fin	float	买入返售金融资产	元
aval_sale_fin	float	可供出售金融资产	元
htm_inv	float	持有至到期投资	元
hold_for_sale	float	持有待售资产	元
acct_rcv_inv	float	应收款项类投资	元	保险
invt	float	存货	元
contr_ast	float	合同资产	元
ncur_ast_one_y	float	一年内到期的非流动资产	元
oth_cur_ast	float	其他流动资产	元
cur_ast_oth_item	float	流动资产其他项目	元
ttl_cur_ast	float	流动资产合计	元
非流动资产(资产)
loan_adv	float	发放委托贷款及垫款	元
cred_inv	float	债权投资	元
oth_cred_inv	float	其他债权投资	元
lt_rcv	float	长期应收款	元
lt_eqy_inv	float	长期股权投资	元
oth_eqy_inv	float	其他权益工具投资	元
rfd_cap_guar_dpst	float	存出资本保证金	元	保险
oth_ncur_fin_ast	float	其他非流动金融资产	元
amor_cos_fin_ast_ncur	float	以摊余成本计量的金融资产（非流动）	元
fair_val_oth_inc_ncur	float	以公允价值计量且其变动计入其他综合收益的金融资产（非流动）	元
inv_prop	float	投资性房地产	元
fix_ast	float	固定资产	元
const_prog	float	在建工程	元
const_matl	float	工程物资	元
fix_ast_dlpl	float	固定资产清理	元
cptl_bio_ast	float	生产性生物资产	元
oil_gas_ast	float	油气资产	元
rig_ast	float	使用权资产	元
intg_ast	float	无形资产	元
trd_seat_fee	float	交易席位费	元	证券
dev_exp	float	开发支出	元
gw	float	商誉	元
lt_ppay_exp	float	长期待摊费用	元
dfr_tax_ast	float	递延所得税资产	元
oth_ncur_ast	float	其他非流动资产	元
ncur_ast_oth_item	float	非流动资产其他项目	元
ttl_ncur_ast	float	非流动资产合计	元
oth_ast	float	其他资产	元	银行、证券、保险
ast_oth_item	float	资产其他项目	元
ind_acct_ast	float	独立账户资产	元	保险
ttl_ast	float	资产总计	元
流动负债(负债)
brw_cb	float	向中央银行借款	元
dpst_ob_fin_inst	float	同业和其他金融机构存放款项	元	银行、保险
ln_fm_ob	float	拆入资金	元
fair_val_fin_liab	float	以公允价值计量且其变动计入当期损益的金融负债	元
sht_ln	float	短期借款	元
adv_acct	float	预收款项	元
contr_liab	float	合同负债	元
trd_fin_liab	float	交易性金融负债	元
deriv_fin_liab	float	衍生金融负债	元
sell_repo_ast	float	卖出回购金融资产款	元
cust_bnk_dpst	float	吸收存款	元	银行、保险
dpst_cb_note_pay	float	存款证及应付票据	元	银行
dpst_cb	float	存款证	元	银行
acct_rcv_adv	float	预收账款	元	保险
in_prem_rcv_adv	float	预收保费	元	保险
fee_pay	float	应付手续费及佣金	元
note_acct_pay	float	应付票据及应付账款	元
stlf_pay	float	应付短期融资款	元
note_pay	float	应付票据	元
acct_pay	float	应付账款	元
rin_acct_pay	float	应付分保账款	元
emp_comp_pay	float	应付职工薪酬	元
tax_pay	float	应交税费	元
int_pay	float	应付利息	元
dvd_pay	float	应付股利	元
ph_dvd_pay	float	应付保单红利	元	保险
indem_pay	float	应付赔付款	元	保险
oth_pay	float	其他应付款	元
ttl_oth_pay	float	其他应付款合计	元
ph_dpst_inv	float	保户储金及投资款	元	保险
in_contr_rsv	float	保险合同准备金	元	保险
un_prem_rsv	float	未到期责任准备金	元	保险
clm_rin_rsv	float	未决赔款准备金	元	保险
li_liab_rsv	float	寿险责任准备金	元	保险
lt_hi_liab_rsv	float	长期健康险责任准备金	元	保险
cust_bnk_dpst_fin	float	吸收存款及同业存放	元
inter_pay	float	内部应付款	元
agy_secu_trd	float	代理买卖证券款	元
agy_secu_uw	float	代理承销证券款	元
sht_bnd_pay	float	应付短期债券	元
est_cur_liab	float	预计流动负债	元
liab_hold_for_sale	float	持有待售负债	元
ncur_liab_one_y	float	一年内到期的非流动负债	元
oth_cur_liab	float	其他流动负债	元
cur_liab_oth_item	float	流动负债其他项目	元
ttl_cur_liab	float	流动负债合计	元
非流动负债（负债）
lt_ln	float	长期借款	元
lt_pay	float	长期应付款	元
leas_liab	float	租赁负债
dfr_inc	float	递延收益	元
dfr_tax_liab	float	递延所得税负债	元
bnd_pay	float	应付债券	元
bnd_pay_pbd	float	其中:永续债	元
bnd_pay_pfd	float	其中:优先股	元
oth_ncur_liab	float	其他非流动负债	元
spcl_pay	float	专项应付款	元
ncur_liab_oth_item	float	非流动负债其他项目	元
lt_emp_comp_pay	float	长期应付职工薪酬	元
est_liab	float	预计负债	元
oth_liab	float	其他负债	元	银行、证券、保险
liab_oth_item	float	负债其他项目	元	银行、证券、保险
ttl_ncur_liab	float	非流动负债合计	元
ind_acct_liab	float	独立账户负债	元	保险
ttl_liab	float	负债合计	元
所有者权益(或股东权益)
paid_in_cptl	float	实收资本（或股本）	元
oth_eqy	float	其他权益工具	元
oth_eqy_pfd	float	其中:优先股	元
oth_eqy_pbd	float	其中:永续债	元
oth_eqy_oth	float	其中:其他权益工具	元
cptl_rsv	float	资本公积	元
treas_shr	float	库存股	元
oth_comp_inc	float	其他综合收益	元
spcl_rsv	float	专项储备	元
sur_rsv	float	盈余公积	元
rsv_ord_rsk	float	一般风险准备	元
trd_risk_rsv	float	交易风险准备	元	证券
ret_prof	float	未分配利润	元
sugg_dvd	float	建议分派股利	元	银行
eqy_pcom_oth_item	float	归属于母公司股东权益其他项目	元
ttl_eqy_pcom	float	归属于母公司股东权益合计	元
min_sheqy	float	少数股东权益	元
sheqy_oth_item	float	股东权益其他项目	元
ttl_eqy	float	股东权益合计	元
ttl_liab_eqy	float	负债和股东权益合计	元

stk_get_fundamentals_cashflow - 查询现金流量表数据

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

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

函数原型：

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

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

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

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

现金流量表

字段名	类型	中文名称	量纲	说明
一、经营活动产生的现金流量
cash_rcv_sale	float	销售商品、提供劳务收到的现金	元
net_incr_cust_dpst_ob	float	客户存款和同业存放款项净增加额	元
net_incr_cust_dpst	float	客户存款净增加额	元	银行
net_incr_dpst_ob	float	同业及其他金融机构存放款项净增加额	元	银行
net_incr_brw_cb	float	向中央银行借款净增加额	元
net_incr_ln_fm_oth	float	向其他金融机构拆入资金净增加额	元
cash_rcv_orig_in	float	收到原保险合同保费取得的现金	元
net_cash_rcv_rin_biz	float	收到再保险业务现金净额	元
net_incr_ph_dpst_inv	float	保户储金及投资款净增加额	元
net_decrdpst_cb_ob	float	存放中央银行和同业款项及其他金融机构净减少额	元	银行、保险
net_decr_cb	float	存放中央银行款项净减少额	元	银行
net_decr_ob_fin_inst	float	存放同业及其他金融机构款项净减少额	元	银行
net_cert_dpst	float	存款证净额	元	银行
net_decr_trd_fin	float	交易性金融资产净减少额	元	银行
net_incr_trd_liab	float	交易性金融负债净增加额	元	银行
cash_rcv_int_fee	float	收取利息、手续费及佣金的现金	元
cash_rcv_int	float	其中：收取利息的现金	元	银行
cash_rcv_fee	float	收取手续费及佣金的现金	元	银行
net_incr_lnfm_sell_repo	float	拆入资金及卖出回购金融资产款净增加额	元	银行
net_incr_ln_fm	float	拆入资金净增加额	元
net_incr_sell_repo	float	卖出回购金融资产款净增加额	元	银行 保险
net_decr_lnto_pur_resell	float	拆出资金及买入返售金融资产净减少额	元	银行
net_decr_ln_cptl	float	拆出资金净减少额	元	银行、保险
net_dect_pur_resell	float	买入返售金融资产净减少额	元	银行、保险
net_incr_repo	float	回购业务资金净增加额	元
net_decr_repo	float	回购业务资金净减少额	元	证券
tax_rbt_rcv	float	收到的税费返还	元
net_cash_rcv_trd	float	收到交易性金融资产现金净额	元	保险
cash_rcv_oth_oper	float	收到其他与经营活动有关的现金	元
net_cash_agy_secu_trd	float	代理买卖证券收到的现金净额	元	证券
cash_rcv_pur_resell	float	买入返售金融资产收到的现金	元	证券、保险
net_cash_agy_secu_uw	float	代理承销证券收到的现金净额	元	证券
cash_rcv_dspl_debt	float	处置抵债资产收到的现金	元	银行
canc_loan_rcv	float	收回的已于以前年度核销的贷款	元	银行
cf_in_oper	float	经营活动现金流入小计	元
cash_pur_gds_svc	float	购买商品、接受劳务支付的现金	元
net_incr_ln_adv_cust	float	客户贷款及垫款净增加额	元
net_decr_brw_cb	float	向中央银行借款净减少额	元	银行
net_incr_dpst_cb_ob	float	存放中央银行和同业款项净增加额	元
net_incr_cb	float	存放中央银行款项净增加额	元	银行
net_incr_ob_fin_inst	float	存放同业及其他金融机构款项净增加额	元	银行
net_decr_dpst_ob	float	同业及其他机构存放款减少净额	元	银行
net_decr_issu_cert_dpst	float	已发行存款证净减少额	元	银行
net_incr_lnto_pur_resell	float	拆出资金及买入返售金融资产净增加额	元	银行
net_incr_ln_to	float	拆出资金净增加额	元	银行、保险
net_incr_pur_resell	float	买入返售金融资产净增加额	元	银行、保险
net_decr_lnfm_sell_repo	float	拆入资金及卖出回购金融资产款净减少额	元	银行
net_decr_ln_fm	float	拆入资金净减少额	元	银行、证券
net_decr_sell_repo	float	卖出回购金融资产净减少额	元	银行、保险
net_incr_trd_fin	float	交易性金融资产净增加额	元	银行
net_decr_trd_liab	float	交易性金融负债净减少额	元	银行
cash_pay_indem_orig	float	支付原保险合同赔付款项的现金	元
net_cash_pay_rin_biz	float	支付再保险业务现金净额	元	保险
cash_pay_int_fee	float	支付利息、手续费及佣金的现金	元
cash_pay_int	float	其中：支付利息的现金	元	银行
cash_pay_fee	float	支付手续费及佣金的现金	元	银行
ph_dvd_pay	float	支付保单红利的现金	元
net_decr_ph_dpst_inv	float	保户储金及投资款净减少额	元	保险
cash_pay_emp	float	支付给职工以及为职工支付的现金
cash_pay_tax	float	支付的各项税费	元
net_cash_pay_trd	float	支付交易性金融资产现金净额	元	保险
cash_pay_oth_oper	float	支付其他与经营活动有关的现金	元
net_incr_dspl_trd_fin	float	处置交易性金融资产净增加额	元
cash_pay_fin_leas	float	购买融资租赁资产支付的现金	元	银行
net_decr_agy_secu_pay	float	代理买卖证券支付的现金净额（净减少额）	元	证券
net_decr_dspl_trd_fin	float	处置交易性金融资产的净减少额	元	证券
cf_out_oper	float	经营活动现金流出小计	元
net_cf_oper	float	经营活动产生的现金流量净额	元
二、投资活动产生的现金流量：
cash_rcv_sale_inv	float	收回投资收到的现金	元
inv_inc_rcv	float	取得投资收益收到的现金	元
cash_rcv_dvd_prof	float	分得股利或利润所收到的现金	元	银行
cash_rcv_dspl_ast	float	处置固定资产、无形资产和其他长期资产收回的现金净额	元
cash_rcv_dspl_sub_oth	float	处置子公司及其他营业单位收到的现金净额	元
cash_rcv_oth_inv	float	收到其他与投资活动有关的现金	元
cf_in_inv	float	投资活动现金流入小计	元
pur_fix_intg_ast	float	购建固定资产、无形资产和其他长期资产支付的现金	元
cash_out_dspl_sub_oth	float	处置子公司及其他营业单位流出的现金净额	元	保险
cash_pay_inv	float	投资支付的现金	元
net_incr_ph_plge_ln	float	保户质押贷款净增加额	元	保险
add_cash_pled_dpst	float	增加质押和定期存款所支付的现金	元
net_incr_plge_ln	float	质押贷款净增加额	元
net_cash_get_sub	float	取得子公司及其他营业单位支付的现金净额	元
net_pay_pur_resell	float	支付买入返售金融资产现金净额	元	证券、保险
cash_pay_oth_inv	float	支付其他与投资活动有关的现金	元
cf_out_inv	float	投资活动现金流出小计
net_cf_inv	float	投资活动产生的现金流量净额	元
三、筹资活动产生的现金流量：
cash_rcv_cptl	float	吸收投资收到的现金	元
sub_rcv_ms_inv	float	其中：子公司吸收少数股东投资收到的现金	元
brw_rcv	float	取得借款收到的现金	元
cash_rcv_bnd_iss	float	发行债券收到的现金	元
net_cash_rcv_sell_repo	float	收到卖出回购金融资产款现金净额	元	保险
cash_rcv_oth_fin	float	收到其他与筹资活动有关的现金	元
issu_cert_dpst	float	发行存款证	元	银行
cf_in_fin_oth	float	筹资活动现金流入其他项目	元
cf_in_fin	float	筹资活动现金流入小计	元
cash_rpay_brw	float	偿还债务支付的现金	元
cash_pay_bnd_int	float	偿付债券利息支付的现金	元	银行
cash_pay_dvd_int	float	分配股利、利润或偿付利息支付的现金	元
sub_pay_dvd_prof	float	其中：子公司支付给少数股东的股利、利润	元
cash_pay_oth_fin	float	支付其他与筹资活动有关的现金	元
net_cash_pay_sell_repo	float	支付卖出回购金融资产款现金净额	元	保险
cf_out_fin	float	筹资活动现金流出小计	元
net_cf_fin	float	筹资活动产生的现金流量净额	元
efct_er_chg_cash	float	四、汇率变动对现金及现金等价物的影响	元
net_incr_cash_eq	float	五、现金及现金等价物净增加额	元
cash_cash_eq_bgn	float	加：期初现金及现金等价物余额	元
cash_cash_eq_end	float	六、期末现金及现金等价物余额	元
补充资料 1．将净利润调节为经营活动现金流量：
net_prof	float	净利润	元
ast_impr	float	资产减值准备	元
accr_prvs_ln_impa	float	计提贷款减值准备	元	银行
accr_prvs_oth_impa	float	计提其他资产减值准备	元	银行
accr_prem_rsv	float	提取的保险责任准备金	元	保险
accr_unearn_prem_rsv	float	提取的未到期的责任准备金	元	保险
defr_fix_prop	float	固定资产和投资性房地产折旧	元
depr_oga_cba	float	其中:固定资产折旧、油气资产折耗、生产性生物资产折旧	元
amor_intg_ast_lt_exp	float	无形资产及长期待摊费用等摊销	元	银行、证券、保险
amort_intg_ast	float	无形资产摊销	元
amort_lt_exp_ppay	float	长期待摊费用摊销	元
dspl_ast_loss	float	处置固定资产、无形资产和其他长期资产的损失	元
fair_val_chg_loss	float	固定资产报废损失	元
fv_chg_loss	float	公允价值变动损失	元
dfa	float	固定资产折旧	元	银行
fin_exp	float	财务费用	元
inv_loss	float	投资损失	元
exchg_loss	float	汇兑损失	元	银行、证券、保险
dest_incr	float	存款的增加	元	银行
loan_decr	float	贷款的减少	元	银行
cash_pay_bnd_int_iss	float	发行债券利息支出	元	银行
dfr_tax	float	递延所得税	元
dfr_tax_ast_decr	float	其中:递延所得税资产减少	元
dfr_tax_liab_incr	float	递延所得税负债增加	元
invt_decr	float	存货的减少	元
decr_rcv_oper	float	经营性应收项目的减少	元
incr_pay_oper	float	经营性应付项目的增加	元
oth	float	其他	元
cash_end	float	现金的期末余额	元
cash_bgn	float	减：现金的期初余额	元
cash_eq_end	float	加:现金等价物的期末余额	元
cash_eq_bgn	float	减:现金等价物的期初余额	元
cred_impr_loss	float	信用减值损失	元
est_liab_add	float	预计负债的增加	元
dr_cnv_cptl	float	债务转为资本	元
cptl_bnd_expr_one_y	float	一年内到期的可转换公司债券	元
fin_ls_fix_ast	float	融资租入固定资产	元
amort_dfr_inc	float	递延收益摊销	元
depr_inv_prop	float	投资性房地产折旧	元
trd_fin_decr	float	交易性金融资产的减少	元	证券、保险
im_net_cf_oper	float	间接法-经营活动产生的现金流量净额	元
im_net_incr_cash_eq	float	间接法-现金及现金等价物净增加额	元

stk_get_fundamentals_income - 查询利润表数据

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

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

函数原型：

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

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

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

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

利润表

字段名	类型	中文名称	量纲	说明
ttl_inc_oper	float	营业总收入	元
inc_oper	float	营业收入	元
net_inc_int	float	利息净收入	元	证券、银行、保险
exp_int	float	利息支出	元
net_inc_fee_comm	float	手续费及佣金净收入	元	证券、银行
inc_rin_prem	float	其中：分保费收入	元	保险
net_inc_secu_agy	float	其中:代理买卖证券业务净收入	元	证券
inc_fee_comm	float	手续费及佣金收入	元
in_prem_earn	float	已赚保费	元	保险
inc_in_biz	float	其中:保险业务收入	元	保险
rin_prem_cede	float	分出保费	元	保险
unear_prem_rsv	float	提取未到期责任准备金	元	保险
net_inc_uw	float	证券承销业务净收入	元	证券
net_inc_cust_ast_mgmt	float	受托客户资产管理业务净收入	元	证券
inc_fx	float	汇兑收益	元
inc_other_oper	float	其他业务收入	元
inc_oper_balance	float	营业收入平衡项目	元
ttl_inc_oper_other	float	营业总收入其他项目	元
ttl_cost_oper	float	营业总成本	元
cost_oper	float	营业成本	元
exp_oper	float	营业支出	元	证券、银行、保险
biz_tax_sur	float	营业税金及附加	元
exp_sell	float	销售费用	元
exp_adm	float	管理费用	元
exp_rd	float	研发费用	元
exp_fin	float	财务费用	元
int_fee	float	其中:利息费用	元
inc_int	float	利息收入	元
exp_oper_adm	float	业务及管理费	元	证券、银行、保险
exp_rin	float	减:摊回分保费用	元	保险
rfd_prem	float	退保金	元	保险
comp_pay	float	赔付支出	元	保险
rin_clm_pay	float	减:摊回赔付支出	元	保险
draw_insur_liab	float	提取保险责任准备金	元	保险
amor_insur_liab	float	减:摊回保险责任准备金	元	保险
exp_ph_dvd	float	保单红利支出	元	保险
exp_fee_comm	float	手续费及佣金支出	元
other_oper_cost	float	其他业务成本	元
oper_exp_balance	float	营业支出平衡项目	元	证券、银行、保险
exp_oper_other	float	营业支出其他项目	元	证券、银行、保险
ttl_cost_oper_other	float	营业总成本其他项目	元
其他经营收益			元
inc_inv	float	投资收益	元
inv_inv_jv_p	float	对联营企业和合营企业的投资收益	元
inc_ast_dspl	float	资产处置收益	元
ast_impr_loss	float	资产减值损失(新)	元
cred_impr_loss	float	信用减值损失(新)	元
inc_fv_chg	float	公允价值变动收益	元
inc_other	float	其他收益	元
oper_prof_balance	float	营业利润平衡项目	元
oper_prof	float	营业利润	元
inc_noper	float	营业外收入	元
exp_noper	float	营业外支出	元
ttl_prof_balance	float	利润总额平衡项目	元
oper_prof_other	float	营业利润其他项目	元
ttl_prof	float	利润总额	元
inc_tax	float	所得税费用	元
net_prof	float	净利润	元
oper_net_prof	float	持续经营净利润	元
net_prof_pcom	float	归属于母公司股东的净利润	元
min_int_inc	float	少数股东损益	元
end_net_prof	float	终止经营净利润	元
net_prof_other	float	净利润其他项目	元
eps_base	float	基本每股收益	元
eps_dil	float	稀释每股收益	元
other_comp_inc	float	其他综合收益	元
other_comp_inc_pcom	float	归属于母公司股东的其他综合收益	元
other_comp_inc_min	float	归属于少数股东的其他综合收益	元
ttl_comp_inc	float	综合收益总额	元
ttl_comp_inc_pcom	float	归属于母公司所有者的综合收益总额	元
ttl_comp_inc_min	float	归属于少数股东的综合收益总额	元
prof_pre_merge	float	被合并方在合并前实现利润	元
net_rsv_in_contr	float	提取保险合同准备金净额	元
net_pay_comp	float	赔付支出净额	元
net_loss_ncur_ast	float	非流动资产处置净损失	元
amod_fin_asst_end	float	以摊余成本计量的金融资产终止确认收益	元
cash_flow_hedging_pl	float	现金流量套期损益的有效部分	元
cur_trans_diff	float	外币财务报表折算差额	元
gain_ncur_ast	float	非流动资产处置利得	元
afs_fv_chg_pl	float	可供出售金融资产公允价值变动损益	元
oth_eqy_inv_fv_chg	float	其他权益工具投资公允价值变动	元
oth_debt_inv_fv_chg	float	其他债权投资公允价值变动	元
oth_debt_inv_cred_impr	float	其他债权投资信用减值准备	元

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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	距查询日期最近的发布日期 若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	距查询日期最近的发布日期 若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	距查询日期最近的发布日期 若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

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

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

财务主要指标

字段名	类型	中文名称	量纲	说明
eps_basic	float	基本每股收益	元
eps_dil	float	稀释每股收益	元
eps_basic_cut	float	扣除非经常性损益后的基本每股收益	元
eps_dil_cut	float	扣除非经常性损益后的稀释每股收益	元
net_cf_oper_ps	float	每股经营活动产生的现金流量净额	元
bps_pcom_ps	float	归属于母公司股东的每股净资产	元
ttl_ast	float	总资产	元
ttl_liab	float	总负债	元
share_cptl	float	股本	股
ttl_inc_oper	float	营业总收入	元
inc_oper	float	营业收入	元
oper_prof	float	营业利润	元
ttl_prof	float	利润总额	元
ttl_eqy_pcom	float	归属于母公司股东的所有者权益	元
net_prof_pcom	float	归属于母公司股东的净利润	元
net_prof_pcom_cut	float	扣除非经常性损益后归属于母公司股东的净利润	元
roe	float	全面摊薄净资产收益率	%
roe_weight_avg	float	加权平均净资产收益率	%
roe_cut	float	扣除非经常性损益后的全面摊薄净资产收益率	%
roe_weight_avg_cut	float	扣除非经常性损益后的加权平均净资产收益率	%
net_cf_oper	float	经营活动产生的现金流量净额	元
eps_yoy	float	每股收益同比比例	%
inc_oper_yoy	float	营业收入同比比例	%
ttl_inc_oper_yoy	float	营业总收入同比比例	%
net_prof_pcom_yoy	float	归母净利润同比比例	%

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

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

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

函数原型：

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

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

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

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

财务衍生指标指标

字段名	类型	中文名称	量纲	说明
eps_basic	float	每股收益EPS(基本)	元
eps_dil2	float	每股收益EPS(稀释)	元
eps_dil	float	每股收益EPS(期末股本摊薄)	元
eps_basic_cut	float	每股收益EPS(扣除/基本)	元
eps_dil2_cut	float	每股收益EPS(扣除/稀释)	元
eps_dil_cut	float	每股收益EPS(扣除/期末股本摊薄)	元
bps	float	每股净资产BPS	元
net_cf_oper_ps	float	每股经营活动产生的现金流量净额	元
ttl_inc_oper_ps	float	每股营业总收入	元
inc_oper_ps	float	每股营业收入	元
ebit_ps	float	每股息税前利润	元
cptl_rsv_ps	float	每股资本公积	元
sur_rsv_ps	float	每股盈余公积	元
retain_prof_ps	float	每股未分配利润	元
retain_inc_ps	float	每股留存收益	元
net_cf_ps	float	每股现金流量净额	元
fcff_ps	float	每股企业自由现金流量	元
fcfe_ps	float	每股股东自由现金流量	元
ebitda_ps	float	每股EBITDA	元
roe	float	净资产收益率ROE(摊薄)	%
roe_weight	float	净资产收益率ROE(加权)	%
roe_avg	float	净资产收益率ROE(平均)	%
roe_cut	float	净资产收益率ROE(扣除/摊薄)	%
roe_weight_cut	float	净资产收益率ROE(扣除/加权)	%
ocf_toi	float	经营性现金净流量/营业总收入
eps_dil_yoy	float	稀释每股收益同比增长率	%
net_cf_oper_ps_yoy	float	每股经营活动中产生的现金流量净额同比增长率	%
ttl_inc_oper_yoy	float	营业总收入同比增长率	%
inc_oper_yoy	float	营业收入同比增长率	%
oper_prof_yoy	float	营业利润同比增长率	%
ttl_prof_yoy	float	利润总额同比增长率	%
net_prof_pcom_yoy	float	归属母公司股东的净利润同比增长率	%
net_prof_pcom_cut_yoy	float	归属母公司股东的净利润同比增长率(扣除非经常性损益)	%
net_cf_oper_yoy	float	经营活动产生的现金流量净额同比增长率	%
roe_yoy	float	净资产收益率同比增长率(摊薄)	%
net_asset_yoy	float	净资产同比增长率	%
ttl_liab_yoy	float	总负债同比增长率	%
ttl_asset_yoy	float	总资产同比增长率	%
net_cash_flow_yoy	float	现金净流量同比增长率	%
bps_gr_begin_year	float	每股净资产相对年初增长率	%
ttl_asset_gr_begin_year	float	资产总计相对年初增长率	%
ttl_eqy_pcom_gr_begin_year	float	归属母公司的股东权益相对年初增长率	%
net_debt_eqy_ev	float	净债务/股权价值	%
int_debt_eqy_ev	float	带息债务/股权价值
eps_bas_yoy	float	基本每股收益同比增长率	%
ebit	float	EBIT(正推法)	元
ebitda	float	EBITDA(正推法)	元
ebit_inverse	float	EBIT(反推法)	元
ebitda_inverse	float	EBITDA(反推法)	元
nr_prof_loss	float	非经常性损益	元
net_prof_cut	float	扣除非经常性损益后的净利润	元
gross_prof	float	毛利润	元
oper_net_inc	float	经营活动净收益	元
val_chg_net_inc	float	价值变动净收益	元
exp_rd	float	研发费用	元
ttl_inv_cptl	float	全部投入资本	元
work_cptl	float	营运资本	元
net_work_cptl	float	净营运资本	元
tg_asset	float	有形资产	元
retain_inc	float	留存收益	元
int_debt	float	带息债务	元
net_debt	float	净债务	元
curr_liab_non_int	float	无息流动负债	元
ncur_liab_non_int	float	无息非流动负债	元
fcff	float	企业自由现金流量FCFF	元
fcfe	float	股权自由现金流量FCFE	元
cur_depr_amort	float	当期计提折旧与摊销	元
eqy_mult_dupont	float	权益乘数(杜邦分析)
net_prof_pcom_np	float	归属母公司股东的净利润/净利润	%
net_prof_tp	float	净利润/利润总额	%
ttl_prof_ebit	float	利润总额/息税前利润	%
roe_cut_avg	float	净资产收益率ROE(扣除/平均)	%
roe_add	float	净资产收益率ROE(增发条件)	%
roe_ann	float	净资产收益率ROE(年化)	%
roa	float	总资产报酬率ROA	%
roa_ann	float	总资产报酬率ROA(年化)	%
jroa	float	总资产净利率	%
jroa_ann	float	总资产净利率(年化)	%
roic	float	投入资本回报率ROIC	%
sale_npm	float	销售净利率	%
sale_gpm	float	销售毛利率	%
sale_cost_rate	float	销售成本率	%
sale_exp_rate	float	销售期间费用率	%
net_prof_toi	float	净利润/营业总收入	%
oper_prof_toi	float	营业利润/营业总收入	%
ebit_toi	float	息税前利润/营业总收入	%
ttl_cost_oper_toi	float	营业总成本/营业总收入	%
exp_oper_toi	float	营业费用/营业总收入	%
exp_admin_toi	float	管理费用/营业总收入	%
exp_fin_toi	float	财务费用/营业总收入	%
ast_impr_loss_toi	float	资产减值损失/营业总收入	%
ebitda_toi	float	EBITDA/营业总收入	%
oper_net_inc_tp	float	经营活动净收益/利润总额	%
val_chg_net_inc_tp	float	价值变动净收益/利润总额	%
net_exp_noper_tp	float	营业外支出净额/利润总额
inc_tax_tp	float	所得税/利润总额	%
net_prof_cut_np	float	扣除非经常性损益的净利润/净利润	%
eqy_mult	float	权益乘数
curr_ast_ta	float	流动资产/总资产	%
ncurr_ast_ta	float	非流动资产/总资产	%
tg_ast_ta	float	有形资产/总资产	%
ttl_eqy_pcom_tic	float	归属母公司股东的权益/全部投入资本	%
int_debt_tic	float	带息负债/全部投入资本	%
curr_liab_tl	float	流动负债/负债合计	%
ncurr_liab_tl	float	非流动负债/负债合计	%
ast_liab_rate	float	资产负债率	%
quick_rate	float	速动比率
curr_rate	float	流动比率
cons_quick_rate	float	保守速动比率
liab_eqy_rate	float	产权比率
ttl_eqy_pcom_tl	float	归属母公司股东的权益/负债合计
ttl_eqy_pcom_debt	float	归属母公司股东的权益/带息债务
tg_ast_tl	float	有形资产/负债合计
tg_ast_int_debt	float	有形资产/带息债务
tg_ast_net_debt	float	有形资产/净债务
ebitda_tl	float	息税折旧摊销前利润/负债合计
net_cf_oper_tl	float	经营活动产生的现金流量净额/负债合计
net_cf_oper_int_debt	float	经营活动产生的现金流量净额/带息债务
net_cf_oper_curr_liab	float	经营活动产生的现金流量净额/流动负债
net_cf_oper_net_liab	float	经营活动产生的现金流量净额/净债务
ebit_int_cover	float	已获利息倍数
long_liab_work_cptl	float	长期债务与营运资金比率
ebitda_int_debt	float	EBITDA/带息债务	%
oper_cycle	float	营业周期	天
inv_turnover_days	float	存货周转天数	天
acct_rcv_turnover_days	float	应收账款周转天数(含应收票据)	天
inv_turnover_rate	float	存货周转率	次
acct_rcv_turnover_rate	float	应收账款周转率(含应收票据)	次
curr_ast_turnover_rate	float	流动资产周转率	次
fix_ast_turnover_rate	float	固定资产周转率	次
ttl_ast_turnover_rate	float	总资产周转率	次
cash_rcv_sale_oi	float	销售商品提供劳务收到的现金/营业收入	%
net_cf_oper_oi	float	经营活动产生的现金流量净额/营业收入	%
net_cf_oper_oni	float	经营活动产生的现金流量净额/经营活动净收益
cptl_exp_da	float	资本支出/折旧摊销	%
cash_rate	float	现金比率
acct_pay_turnover_days	float	应付账款周转天数(含应付票据)	天
acct_pay_turnover_rate	float	应付账款周转率(含应付票据)	次
net_oper_cycle	float	净营业周期	天
ttl_cost_oper_yoy	float	营业总成本同比增长率	%
net_prof_yoy	float	净利润同比增长率	%
net_cf_oper_np	float	经营活动产生的现金流量净额/净利润	%

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

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

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

函数原型：

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

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
trade_date	str	交易日期
fields	list[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_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

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

估值指标

字段名	类型	中文名称	量纲	说明
pe_ttm	float	市盈率(TTM)	倍
pe_lyr	float	市盈率(最新年报LYR)	倍
pe_mrq	float	市盈率(最新报告期MRQ)	倍
pe_1q	float	市盈率(当年一季×4)	倍
pe_2q	float	市盈率(当年中报×2)	倍
pe_3q	float	市盈率(当年三季×4/3)	倍
pe_ttm_cut	float	市盈率(TTM) 扣除非经常性损益	倍
pe_lyr_cut	float	市盈率(最新年报LYR) 扣除非经常性损益	倍
pe_mrq_cut	float	市盈率(最新报告期MRQ) 扣除非经常性损益	倍
pe_1q_cut	float	市盈率(当年一季×4) 扣除非经常性损益	倍
pe_2q_cut	float	市盈率(当年中报×2) 扣除非经常性损益	倍
pe_3q_cut	float	市盈率(当年三季×4/3) 扣除非经常性损益	倍
pb_lyr	float	市净率(最新年报LYR)	倍
pb_lf	float	市净率(最新公告)	倍
pb_mrq	float	市净率(最新报告期MRQ)	倍
pcf_ttm_oper	float	市现率(经营现金流,TTM)	倍
pcf_ttm_ncf	float	市现率(现金净流量,TTM)	倍
pcf_lyr_oper	float	市现率(经营现金流,最新年报LYR)	倍
pcf_lyr_ncf	float	市现率(现金净流量,最新年报LYR)	倍
ps_ttm	float	市销率(TTM)	倍
ps_lyr	float	市销率(最新年报LYR)	倍
ps_mrq	float	市销率(最新报告期MRQ)	倍
ps_1q	float	市销率(当年一季×4)	倍
ps_2q	float	市销率(当年中报×2)	倍
ps_3q	float	市销率(当年三季×4/3)	倍
peg_lyr	float	历史PEG值(当年年报增长率)	倍
peg_1q	float	历史PEG值(当年1季*4较上年年报增长率)	倍
peg_2q	float	历史PEG值(当年中报*2较上年年报增长率)	倍
peg_3q	float	历史PEG值(当年3季*4/3较上年年报增长率)	倍
dy_ttm	float	股息率(滚动 12 月TTM)	%
dy_lfy	float	股息率(上一财年LFY)	%

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

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

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

函数原型：

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

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
trade_date	str	交易日期
fields	list[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_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

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

市值指标

字段名	类型	中文名称	量纲	说明
tot_mv	float	总市值	元
tot_mv_csrc	float	总市值(证监会算法)	元
a_mv	float	A股流通市值(含限售股)	元
a_mv_ex_ltd	float	A股流通市值(不含限售股)	元
b_mv	float	B股流通市值(含限售股，折人民币)	元
b_mv_ex_ltd	float	B股流通市值(不含限售股，折人民币)	元
ev	float	企业价值(含货币资金)(EV1)	元
ev_ex_curr	float	企业价值(剔除货币资金)(EV2)	元
ev_ebitda	float	企业倍数	倍
equity_value	float	股权价值	元

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

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

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

函数原型：

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

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
trade_date	str	交易日期
fields	list[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_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

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

基础指标

字段名	类型	中文名称	量纲	说明
tclose	float	收盘价	元
turnrate	float	当日换手率	%
ttl_shr	float	总股本	股
circ_shr	float	流通股本	股
ttl_shr_unl	float	无限售条件股本	股
ttl_shr_ltd	float	有限售条件股本	股

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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	距查询日期最近的发布日期 若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
pub_date	str	发布日期	距查询日期最近的发布日期 若数据类型选择合并原始(data_type=101)，则返回原始发布的发布日期 若数据类型选择合并调整(data_type=102)，则返回调整后最新发布日期 若数据类型选择母公司原始(data_type=201)，则返回母公司原始发布的发布日期 若数据类型选择母公司调整(data_type=202)，则返回母公司调整后最新发布日期
rpt_date	str	报告日期	报告截止日期，财报统计的最后一天，在指定时间段[开始时间,结束时间]内的报告截止日期
rpt_type	int	报表类型	返回数据的报表类型：1-一季度报, 6-中报, 9-前三季报, 12-年报
data_type	int	数据类型	返回数据的数据类型：101-合并原始, 102-合并调整, 201-母公司原始, 202-母公司调整
fields	list[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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
trade_date	str	交易日期
fields	list[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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
trade_date	str	交易日期
fields	list[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)

参数：

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

返回值：

字段名	类型	中文名称	说明
symbol	str	股票代码
trade_date	str	交易日期
fields	list[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="")

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
csymbol	str	连续合约代码	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_date	str	开始时间	N	""	开始时间日期，%Y-%m-%d 格式，默认""表示最新时间
end_date	str	结束时间	N	""	结束时间日期，%Y-%m-%d 格式，默认""表示最新时间

返回值：list[dict]

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

示例：

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