# 财务函数
# 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
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
3
4
5
6
7
示例2:
#多维度财务获取。
#获得'600007'和'600008'品种的'归属于母公司所有者权益合计'和'所有者权益合计'财务字段
df=fin_balance_std(['sh600007', 'SH600008'], ['TEquityAttrP', 'TShEquity'], 1, 0, 0)
1
2
3
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
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
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
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
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
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
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
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
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