# 财务函数

# get_finance 基础财务数据

get_finance (order_book_id, type, count, filter, offset)

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

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

list of 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 一般工商业资产负债表

fin_balance_std (order_book_id, items, count, filter, offset)

获取一般行业资产负债数据.

注:该表包含所有A股品种资产负债数据,包括银行、证券、保险类字段。可理解为合并财务报表。若使用需要获取金融类的特有字段,可以直接查询金融类专用财务报表(银行、证券、保险)。

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

list

范例

示例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, items, count, filter, offset)

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

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

list


# fin_balance_bx保险业资产负债表

fin_balance_bx (order_book_id, items, count, filter, offset)

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

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

list


# fin_balance_yh 银行业资产负债表

fin_balance_yh (order_book_id, items, count, filter, offset)

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

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

list


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

fin_profit_std (order_book_id, items, count, filter, offset)

一般工商业利润分配表

注:该表包含所有A股品种资产负债数据,包括银行、证券、保险类字段。可理解为合并财务报表。若使用需要获取金融类的特有字段,可以直接查询金融类专用财务报表(银行、证券、保险)。

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

list

范例
#获取'营业总收入'财务字段数据
tRevenue = fin_profit_std('SH600007', 'tRevenue', 1, 0, 0)
1
2

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

fin_profit_zq (order_book_id, items, count, filter, offset)

证券业利润分配表

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

list


# fin_profit_bx 保险业利润分配表

fin_profit_bx (order_book_id, items, count, filter, offset)

保险业利润分配表

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

list


# fin_profit_yh 银行业利润分配表

fin_profit_yh (order_book_id, items, count, filter, offset)

银行业利润分配表

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

list


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

fin_cashflow_std (order_book_id, items, count, filter, offset)

一般工商业现金流量表

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

list

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

# fin_cashflow_zq 证券行业现金流量表

fin_cashflow_zq (order_book_id, items, count, filter, offset)

证券行业现金流量表

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

list


# fin_cashflow_bx 保险业现金流量表

fin_cashflow_bx (order_book_id, items, count, filter, offset)

保险业现金流量表

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

list


# fin_cashflow_yh 银行业现金流量表

fin_cashflow_yh (order_book_id, items, count, filter, offset)

银行业现金流量表

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

list


# fin_indicator 衍生数据表

fin_indicator (order_book_id, items, count, filter, offset)

财务衍生数据字段。

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

list

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

# fin_com_holder 持股股东数

fin_com_holder (order_book_id, items, count, filter, offset)

持股股东户数

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

list

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

# fin_com_share 股本结构表

fin_com_share (order_book_id, items, count, offset)

股本结构表

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

list

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

# fin_com_swhy2014 申万行业分类

fin_com_swhy2014 (order_book_id, items)

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

参数
参数 类型 说明
order_book_id str 合约代码,必填项
items str 数据项名称,必填项
返回值

数据项对应值

范例
#获取该品种的三级分类名称
industryName = fin_com_swhy2014('SH600007', 'industryName3')
1
2

# fin_stock_information 公司IPO信息表

fin_stock_information (order_book_id, items)

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

参数
参数 类型 说明
order_book_id str 合约代码,必填项
items str 数据项名称,必填项
返回值

数据项对应值

范例
#上市日期
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