历史数据

# 历史数据

# 接口

历史数据获取API

D.history_data(*instruments, start_date='2005-01-01', end_date=None, fields=['open', 'close'], frequency='daily', groupped_by_instrument=False, price_type='backward_adjusted'*)

统一的API,读取历史数据
参数:

instruments – 字符串数组,股票代码列表,见股票代码
start_date – 字符串,开始日期end_date – 字符串,结束日期fields – 字符串数组
frequency – 数据周期,日,分钟 传入’daily’ or ‘minute’, 目前功能上只支持’daily’
groupped_by_instrument – 布尔类型,返回数据是否按instrument分组,如果为True,则返回dict,如果为False,返回的是DataFrame
返回:

历史数据

返回类型:

DataFrame

# 数据字段


字段名类型描述适用市场
datedatetime64交易日期
instrumentstr证券代码

# 基本信息

字段名类型描述适用市场
namestr证券名字A股,基金,期货,港股,美股
list_datedatetime64上市日期A股,基金,期货,港股,美股
list_boardstr上市板A股,基金,期货,港股,美股
delist_datedatetime64退市日期,如果未退市,则为pandas.NaTA股,基金,期货,港股,美股
company_namestr公司名称A股
company_typestr公司类型A股
company_found_datedatetime64公司成立日期A股
company_provincestr公司省份A股
contunitstr合约单位期货

# 行情数据

字段名类型描述适用市场
openfloat32开盘价(后复权)A股,基金,期货,港股,美股
closefloat32收盘价(后复权)A股,基金,期货,港股,美股
highfloat32最高价(后复权)A股,基金,期货,港股,美股
lowfloat32最低价(后复权)A股,基金,期货,港股,美股
adjust_factorfloat32复权因子A股,基金
amountfloat32交易额A股,基金,期货,港股,美股
volumeint64交易量A股,基金,期货,港股,美股
open_intlfloat32持仓量期货
settlefloat32结算价期货
deal_numberint32成交笔数A股
turnfloat32换手率A股,基金
price_limit_statusint8股价在收盘时的涨跌停状态:1表示跌停,2表示未涨跌停,3则表示涨停A股,基金
suspendedbool是否停牌A股
suspend_typestr停牌类型A股
suspend_reasonstr停牌原因A股
st_statusint8ST状态:0:正常股票,1:ST,2:*ST,11:暂停上市A股

# 估值分析

字段名类型描述适用市场
market_capfloat32总市值A股
market_cap_floatfloat32流通市值A股
pe_ttmfloat32市盈率 (TTM)A股
pe_lyrfloat32市盈率 (LYR)A股
pb_lffloat32市净率 (LF)A股
pb_mrqfloat32市净率 (MRQ)A股
ps_ttmfloat32市销率 (TTM)A股
west_netprofit_ftmfloat32一致预测净利润(未来12个月)A股
west_eps_ftmfloat32一致预测每股收益(未来12个月)A股
west_avgcps_ftmfloat32一致预测每股现金流(未来12个月)A股

# 资金流分析

字段名类型描述适用市场
mf_net_amountfloat32净主动买入额,= 买入金额 - 卖出金额 (包括超大单、大单、中单或小单)A股
mf_net_amount_mainfloat32主力净流入净额A股
mf_net_pct_mainfloat32主力净流入占比A股
mf_net_amount_xlfloat32超大单净流入净额A股
mf_net_pct_xlfloat32超大单净流入占比A股
mf_net_amount_lfloat32大单净流入净额A股
mf_net_pct_lfloat32大单净流入占比A股
mf_net_amount_mfloat32中单净流入净额A股
mf_net_pct_mfloat32中单净流入占比A股
mf_net_amount_sfloat32小单净流入净额A股
mf_net_pct_sfloat32小单净流入占比A股

# 财报数据

字段名类型描述适用市场
fs_publish_datedatetime64发布日期(数据可以开始使用的日期)A股
fs_quarterstr财报对应的年份季度,例如 20151231A股
fs_quarter_yearint16财报对应的年份。0表示无可用财报A股
fs_quarter_indexint8财报对应的季度,取值 1/2/3/4,1表示第一季度,以此类推。0表示无可用财报A股
fs_net_profitfloat32归属母公司股东的净利润A股
fs_net_profit_ttmfloat32归属母公司股东的净利润 (TTM)A股
fs_net_profit_yoyfloat32归属母公司股东的净利润同比增长率A股
fs_net_profit_qoqfloat32归属母公司股东的净利润单季度环比增长率A股
fs_deducted_profitfloat32扣除非经常性损益后的净利润A股
fs_deducted_profit_ttmfloat32扣除非经常性损益后的净利润 (TTM)A股
fs_roefloat32净资产收益率A股
fs_roe_ttmfloat32净资产收益率 (TTM)A股
fs_roafloat32总资产报酬率A股
fs_roa_ttmfloat32总资产报酬率 (TTM)A股
fs_gross_profit_marginfloat32销售毛利率A股
fs_gross_profit_margin_ttmfloat32销售毛利率 (TTM)A股
fs_net_profit_marginfloat32销售净利率A股
fs_net_profit_margin_ttmfloat32销售净利率 (TTM)A股
fs_operating_revenuefloat32营业收入A股
fs_operating_revenue_ttmfloat32营业收入 (TTM)A股
fs_operating_revenue_yoyfloat32营业收入同比增长率A股
fs_operating_revenue_qoqfloat32营业收入单季度环比增长率A股
fs_free_cash_flowfloat32企业自由现金流A股
fs_net_cash_flowfloat32经营活动产生的现金流量净额A股
fs_net_cash_flow_ttmfloat32经营活动现金净流量 (TTM)A股
fs_epsfloat32每股收益A股
fs_eps_yoyfloat32每股收益同比增长率A股
fs_bpsfloat32每股净资产A股
fs_current_assetsfloat32流动资产A股
fs_non_current_assetsfloat32非流动资产A股
fs_current_liabilitiesfloat32流动负债A股
fs_non_current_liabilitiesfloat32非流动负债A股
fs_cash_ratiofloat32现金比率A股
fs_common_equityfloat32普通股权益总额A股
fs_cash_equivalentsfloat32货币资金A股
fs_account_receivablefloat32应收账款A股
fs_fixed_assetsfloat32固定资产A股
fs_proj_matlfloat32工程物资A股
fs_construction_in_processfloat32在建工程A股
fs_fixed_assets_dispfloat32固定资产清理A股
fs_account_payablefloat32应付账款A股
fs_total_liabilityfloat32负债合计A股
fs_paicl_up_capitalfloat32实收资本(或股本)A股
fs_capital_reservesfloat32资本公积金A股
fs_surplus_reservesfloat32盈余公积金A股
fs_undistributed_profitfloat32未分配利润A股
fs_eqy_belongto_parcomshfloat32归属母公司股东的权益A股
fs_total_equityfloat32所有者权益合计A股
fs_gross_revenuesfloat32营业总收入A股
fs_total_operating_costsfloat32营业总成本A股
fs_selling_expensesfloat32销售费用A股
fs_financial_expensesfloat32财务费用A股
fs_general_expensesfloat32管理费用A股
fs_operating_profitfloat32营业利润A股
fs_total_profitfloat32利润总额A股
fs_income_taxfloat32所得税A股
fs_net_incomefloat32净利润A股

# 股东数据

字段名类型描述适用市场
sh_holder_avg_pctfloat32户均持股比例A股
sh_holder_avg_pct_3m_chngfloat32户均持股比例季度增长率A股
sh_holder_avg_pct_6m_chngfloat32户均持股比例半年增长率A股
sh_holder_numfloat32股东户数A股

# 行业数据

字段名类型描述适用市场
industry_sw_level1int32申万一级行业类别A股
industry_sw_level2int32申万二级行业类别A股
industry_sw_level3int32申万三级行业类别A股

# 板块数据

字段名类型描述适用市场
conceptstr概念板块A股

# 指数数据

字段名类型描述适用市场
in_sse50int8是否属于上证50指数成份A股
in_csi300int8是否属于沪深300指数成份A股
in_csi500int8是否属于中证500指数成份A股
in_csi800int8是否属于中证800指数成份A股
in_sse180int8是否属于上证180指数成份A股
in_csi100int8是否属于中证100指数成份A股
in_szse100int8是否属于深证100指数成份A股

注解

  1. 财报数据股东数据来自定期财务报表,对于同一天发布的报表,只并保留靠后的报告。查看完整财报,请参考 财报数据

  2. 行业数据具体代码名称对照关系,请参考 行业列表

# 示例代码

获取交易数据:

D.history_data(instruments=['000001.SZA'], start_date='2017-01-01', end_date='2017-01-07',
fields=['open', 'high', 'low', 'close'])

获取指定行业的数据( 具体行业代码见 [行业列表](./industry):

instruments = D.instruments()   #获取所有股票列表
df = D.history_data(instruments, start_date='2017-05-19', end_date='2017-05-19',
  fields=['industry_sw_level1'])  #获取一天历史数据
df[df['industry_sw_level1']== 710000]   #获取计算机行业的股票数据

获取指数成份股:

instruments = D.instruments()   #获取股票列表
df = D.history_data(instruments, start_date='2017-05-19', end_date='2017-05-19',
  fields=['in_csi300'])   #获取一天历史数据
list(df[df['in_csi300']== 1]['instrument']) #沪深300指数成份股

获取板块名称列表:

instruments = D.instruments()   #获取股票列表
df = D.history_data(instruments, start_date='2017-05-19', end_date='2017-05-19',
  fields=['concept']) #获取一天历史数据
set([y for x in df['concept'] if x for y in x.split(';')])  #获取一天包含的所有板块名称

获取指定板块数据:

instruments = D.instruments()   #获取股票列表
df = D.history_data(instruments, start_date='2017-05-19', end_date='2017-05-19',
   fields=['concept'])     #获取一天历史数据
df[df['concept'].apply(lambda x:'智能家居' in x.split(';')
   if x else False)] #获取智能家居概念包含的股票