# 财务函数

# get_finance 基础财务数据

获取基础财务数据。包含常用的50+个财务字段,能满足基本使用需求。详细字段参考pel函数说明或者查阅“附表”章节。

函数原型

get_finance(    order_book_id: str , # 合约代码    type: int , # 财务字段编号    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list[dataval] # 返回dataval对象列表
参数


返回值


范例
#获取最近一期‘平安银行的'每股净资
bar_len=10
get_fin=get_finance('SZ000001', 34, bar_len, 0, 0)
if len(get_fin)<bar_len:
    print("财务数据获取不足,请补充下载")
else:
    print(get_fin[-1].values)
1
2
3
4
5
6
7

# fin_balance_std 一般工商业资产负债表

A股上市公司的合并资产负债表数据,本函数涵盖金融(银行、证券、保险)类上市公司数据。对于金融类独有负债结构分析,可以选择使用金融业专用财务报表。

函数原型

fin_balance_std(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
数据列表 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0
范例

示例1:

#获取'归属于母公司所有者权益合计'财务字段。
TEquityAttrP = fin_balance_std('SZ000001', 'TEquityAttrP', 10, 0, 0)
#判断获取数据长度是否足够。
if len(TEquityAttrP)<10:
    print("财务数据获取不足,请补充下载")
else:
    print(TEquityAttrP)
1
2
3
4
5
6
7

示例2:

#多维度财务获取。
#获得'600007'和'600008'品种的'归属于母公司所有者权益合计'和'所有者权益合计'财务字段
df=fin_balance_std(['sh600007', 'SH600008'], ['TEquityAttrP', 'TShEquity'], 1, 0, 0)
1
2
3

# fin_balance_zq 证券业资产负债表

获取证券行业资产负债数据。

函数原型

fin_balance_zq(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数


返回值

返回结果 返回类型 说明
数据列表 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

# fin_balance_bx保险业资产负债表

获取保险行业披露的资产负债数据。

函数原型

fin_balance_bx(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
数据列表 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

# fin_balance_yh 银行业资产负债表

获取银行业披露的资产负债数据。

函数原型

fin_balance_yh(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数
返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

# fin_profit_std 一般工商业利润分配表

A股上市公司的利润分配表数据,本函数涵盖金融(银行、证券、保险)类上市公司数据。对于金融类独有负债结构分析,可以选择使用金融业专用财务报表。

函数原型

fin_profit_std(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0
范例
#获取'营业总收入'财务字段数据
tRevenue = fin_profit_std('SH600007', 'tRevenue', 1, 0, 0)
1
2

# fin_profit_zq 证券业资产利润分配表

证券业利润分配表

函数原型

fin_profit_zq(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

# fin_profit_bx 保险业利润分配表

保险业利润分配表

函数原型

fin_profit_bx(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

# fin_profit_yh 银行业利润分配表

银行业利润分配表

函数原型

fin_profit_yh(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

# fin_cashflow_std 一般工商业现金流量表

一般工商业现金流量表

函数原型

fin_cashflow_std(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

范例
#获取'经营活动现金流出小计'财务字段。
COutfOperateA = fin_cashflow_std('SH600007', 'COutfOperateA', 1, 0, 0)
1
2

# fin_cashflow_zq 证券行业现金流量表

证券行业现金流量表

函数原型

fin_cashflow_zq(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

# fin_cashflow_bx 保险业现金流量表

保险业现金流量表

函数原型

fin_cashflow_bx(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

# fin_cashflow_yh 银行业现金流量表

银行业现金流量表

函数原型

fin_cashflow_yh(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

# fin_indicator 衍生数据表

根据三大基本报表数据计算得到的财务衍生数据。

函数原型

fin_indicator(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

范例
#获取衍生数据'每股收益'的财务数据
EPS = fin_indicator('SH600007', 'EPS', 1, 0, 0)
1
2

# fin_com_holder 持股股东数

持股股东户数

函数原型

fin_com_holder(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

范例
#得到'SH600007'品种的持股股东户数
shNum = fin_com_holder('SH600007', 'shNum', 1, 0, 0)
1
2

# fin_com_share 股本结构表

股本结构表

函数原型

fin_com_share(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 财务字段    count: int = 1, # 获取数量(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回列表数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回查询到的专业财务数据,若未查询到数据对应字段返回0

范例
#获取总股本
totalShares = fin_com_share('SH600007', 'totalShares', 1, 0)
1
2

# fin_com_swhy2014 申万行业分类

申万行业分类,该表只提供最新的品种分类信息数据。

函数原型

fin_com_swhy2014(    order_book_id: str , # 合约代码    items: str # 财务字段 ) -> Union[str, int, float] # 返回分类名称
参数

返回值
items字段 返回类型 返回结果
secID str 市场和代码组合的字符串 ,如SH600007
ticker int 品种代码 如600100
secShortName str 证券简称,如:平安银行
industryID1 / industryID2 / industryID3 float 一级分类ID / 二级分类ID / 三级分类ID
industryName1 / industryName2 / industryName3 str 一级分类名称 / 二级分类名称 / 三级分类名称
范例
#获取该品种的三级分类名称
industryName = fin_com_swhy2014('SH600007', 'industryName3')
1
2

# fin_stock_information 公司IPO信息表

公司IPO信息表,公司上市时的信息。

函数原型

fin_stock_information(    order_book_id: str , # 合约代码    items: str # 财务字段 ) -> Union[str, int, float] # 返回IPO数据
参数
返回值
返回结果 返回类型 说明
数据项对应值 str int

范例
#上市日期
listDate = fin_stock_information('SH600007', 'listDate')
1
2

# fin_holder_top10 公司十大股东

fin_holder_top10 (order_book_id, items, sort, count, filter, offset)

公司十大股东

参数
参数 类型 说明
order_book_id str or str list 合约代码,必填项
items str or str list 数据项名称,必填项
sort int 排名
count int 获取的历史记录条数,默认为1
filter int 是否过滤 0则表示不做过滤, 为1过滤第一季度, 为2表示第二季度中报, 为3表示第三季度, 为4表示第四季度年报
offset int 为偏移数量为整数往前偏移, 为负数向后偏移
返回值

list

范例
#获得排名第二的股东名称
holder_top = fin_holder_top10('SH600007', 'shName', 2, 1, 0, 0)
1
2

# fin_tradableshare_top10 公司十大流通股东

fin_tradableshare_top10 (order_book_id, items, sort, count, filter, offset)

公司十大流通股东

参数
参数 类型 说明
order_book_id str or str list 合约代码,必填项
items str or str list 数据项名称,必填项
sort int 排名
count int 获取的历史记录条数,默认为1
filter int 是否过滤 0则表示不做过滤, 为1过滤第一季度, 为2表示第二季度中报, 为3表示第三季度, 为4表示第四季度年报
offset int 为偏移数量为整数往前偏移, 为负数向后偏移
返回值

list


# fin_limited_list 股改限售解禁明细

fin_limited_list (order_book_id, items, count, offset)

股改限售解禁明细

参数
参数 类型 说明
order_book_id list 合约代码,必填项
items list 数据项名称,必填项
count int 获取的历史记录条数,默认为1
offset int 为偏移数量为整数往前偏移, 为负数向后偏移
返回值

list