get_fundamentals_n - 查询基本面数据最新n条

取指定股票的最近 end_date 的 count 条记录

函数原型:

 
  1. get_fundamentals_n(table, symbols, end_date, fields=None, filter=None, order_by=None, count=1, df=False)

参数:

 
参数名类型说明
table str 表名. 具体表名及fields字段名及filter可过滤的字段参考 财务数据文档
symbols str 标的代码, 多个代码可用 ,(英文逗号)分割, 也支持 ['symbol1', 'symbol2'] 这种列表格式,使用时参考symbol
end_date str 结束时间, (%Y-%m-%d 格式)
fields str 查询字段 (必填)
filter str 查询过滤,,使用方法参考get_fundamentals的例3、例4
count int 每个股票取最近的数量(正整数)
df bool 是否返回dataframe格式, 默认False, 返回list[dict]

返回值:

 

keyvalue类型说明
symbol str 标的代码
pub_date datetime.datetime 公司发布财报的日期.
end_date datetime.datetime 财报统计的季度的最后一天.
fields dict 相应指定查询 fields 字段的值. 字典key值请参考 财务数据文档

示例:

例1: 取股票代码 SHSE.600000, SZSE.000001, 离 2017-01-01 最近3条(每个股票都有3条) 股票交易财务衍生表 的 TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI 字段的值

 
  1. get_fundamentals_n(table='trading_derivative_indicator', symbols='SHSE.600000, SZSE.000001',
  2.                    end_date='2017-01-01', count=3,
  3.                    fields='TCLOSE,NEGOTIABLEMV,TOTMKTCAP,TURNRATE,PELFY,PETTM,PEMRQ,PELFYNPAAEI,PETTMNPAAEI',
  4.                   df=True )

输出:

 
  1. symbol pub_date end_date TCLOSE TOTMKTCAP PETTM TURNRATE PETTMNPAAEI PELFY PELFYNPAAEI NEGOTIABLEMV PEMRQ
  2. SZSE.000001 2016-12-30 00:00:00 2016-12-30 00:00:00 9.1 1.56251e+11 6.8399 0.2068 6.2644 7.1462 7.1341 1.33144e+11 6.2604
  3. SZSE.000001 2016-12-29 00:00:00 2016-12-29 00:00:00 9.08 1.55907e+11 6.8249 0.2315 6.2506 7.1305 7.1184 1.32851e+11 6.2466
  4. SZSE.000001 2016-12-28 00:00:00 2016-12-28 00:00:00 9.06 1.55564e+11 6.8098 0.2297 6.2369 7.1147 7.1027 1.32558e+11 6.2329
  5. SHSE.600000 2016-12-30 00:00:00 2016-12-30 00:00:00 16.21 3.50432e+11 6.4746 0.0598 6.6184 6.925 7.0707 3.3261e+11 6.4605
  6. SHSE.600000 2016-12-29 00:00:00 2016-12-29 00:00:00 16.07 3.47406e+11 6.4187 0.0578 6.5613 6.8652 7.0097 3.29737e+11 6.4047
  7. SHSE.600000 2016-12-28 00:00:00 2016-12-28 00:00:00 16.09 3.47838e+11 6.4267 0.0704 6.5694 6.8737 7.0184 3.30148e+11 6.4126

注意:

1.对每个标的,返回的list/DataFrame以参数pub_date/end_date的倒序来排序

2.end_date中月,日均可以只输入个位数,例:'2010-7-8''2017-7-30'

3.若输入包含无效标的代码,则返回的list/DataFrame只包含有效标的代码对应的数据

4.在该函数中,table参数只支持输入一个表名,若表名输入错误或以'table1,table2'方式输入多个表名,函数返回空list/空DataFrame

5.若表名输入正确,但查询字段中出现非指定字符串,则程序直接报错

posted @ 2021-08-10 11:01  翩翩浊世之佳公子  阅读(173)  评论(0)    收藏  举报