# 财务函数

# 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
范例
# 获取'资产总计'财务字段
TAssets = fin_balance_zq('SH600837', 'TAssets', 5, 0, 0)
# 判断获取数据长度是否足够
if len(TAssets) < 5:
    print("财务数据获取不足,请补充下载")
else:
    print(TAssets)
1
2
3
4
5
6
7

# 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
范例
# 获取'资产总计'财务字段
TAssets = fin_balance_bx('SH600318', 'TAssets', 5, 0, 0)
# 判断获取数据长度是否足够
if len(TAssets) < 5:
    print("财务数据获取不足,请补充下载")
else:
    print(TAssets)
1
2
3
4
5
6
7

# 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

范例
# 获取'资产总计'财务字段
TAssets = fin_balance_yh('SH600036', 'TAssets', 5, 0, 0)
# 判断获取数据长度是否足够
if len(TAssets) < 5:
    print("财务数据获取不足,请补充下载")
else:
    print(TAssets)
1
2
3
4
5
6
7

# 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
范例
# 获取“营业收入”财务字段数据
revenue = fin_profit_zq('SZ000776', 'revenue', 1, 0, 0)
1
2

# 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
范例
# 获取“利息收入”财务字段数据
intIncome = fin_profit_std('SZ000776', 'intIncome', 1, 0, 0)
1
2

# 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
范例
# 获取“利息支出”财务字段数据
intExp = fin_profit_yh('SH600310', 'intExp', 1, 0, 0)
1
2

# 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
范例
#获取'经营活动产生的现金流量净额'财务字段。
NCFOperateA = fin_cashflow_zq('SH600008', 'NCFOperateA', 1, 0, 0)
1
2

# 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
范例
#获取'收回投资收到的现金'财务字段。
procSellInvest = fin_cashflow_bx('SH600007', 'procSellInvest', 1, 0, 0)
1
2

# 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
范例
#获取'取得投资收益收到的现金'财务字段。
gainInvest = fin_cashflow_yh('SH600007', 'gainInvest', 1, 0, 0)
1
2

# 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: str | List[str] , # 合约代码    items: str | List[str] , # 数据字段    sort: int , # 股东排名    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回十大股东数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回公司十大股东信息,若未查询到数据对应字段返回0

范例
# 获取 SH600007 第2大股东名称
holder_top = fin_holder_top10('SH600007', 'shName', 2, 1, 0, 0)
1
2

# fin_tradableshare_top10 公司十大流通股东

公司十大流通股东信息查询

函数原型

fin_tradableshare_top10(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 数据字段    sort: int , # 股东排名    count: int = 1, # 获取数量(可选)    filter: int= 0, # 季报类型(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回十大流通股东数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回公司十大流通股东信息,若未查询到数据对应字段返回0

范例
# 获取 SH600007 第2大流通股东名称
tradable_top = fin_tradableshare_top10('SH600007', 'shName', 2, 1, 0, 0)
1
2

# fin_limited_list 股改限售解禁明细

股改限售解禁明细信息查询

函数原型

fin_limited_list(    order_book_id: str | List[str] , # 合约代码    items: str | List[str] , # 数据字段    count: int = 1, # 获取数量(可选)    offset: int= 0 # 偏移量(可选) ) -> list # 返回限售解禁明细数据
参数

返回值
返回结果 返回类型 说明
列表数据 list 返回股改限售解禁明细信息,若未查询到数据对应字段返回0

范例
# 获取 SH600007 的上市数量
listShares = fin_limited_list('SH600007','listShares',1,0)
print(listShares)
1
2
3